Partner API
test
  • latest
  • test
  1. Transfers & Payments Webhooks
Partner API
test
  • latest
  • test
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
        • Create transfer master balance
      • Exchange Operations
        • Retrieve Exchange Rate
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
        • Retrieve Exchange Rate and Create a Lock
      • SEPA Transfers
      • Crypto Deposits
        • Update Travel Rule
      • Crypto Withdrawal
        • Get Crypto Withdrawal Details
        • Create Crypto Withdrawal
      • Orders
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
        • Get Rates
      • Payment link
        • Generate Payment Link
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
      • Crypto Deposits
        • Update Travel Rule
      • Crypto Withdrawals
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • SEPA Transfers Copy
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Transfers & Payments Webhooks

Exchange Webhook

Webhook
POST
/exchange-webhook
This event is triggered whenever an exchange updates. It provides real-time notifications so you can keep user-facing statuses and transaction history in sync.
On failures an error object is included and status may be absent (there is no FAILED status).

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "8eb77829-dac3-4857-b0c0-3bf70460659c",
  "sourceAmount": 20.0,
  "destinationAmount": 0.00220961,
  "exchangeRate": "0.0001103256",
  "status": "SUCCESSFUL",
  "fee": 0.11,
  "sourceCurrency": "doge",
  "destinationCurrency": "eth",
  "exchangeLockId": "7729c469-4d41-44ed-baa9-d9434301a651",
  "createdAt": "2025-01-20T10:33:23.465Z",
  "user": {
    "externalUserId": "10001",
    "email": "email@email.com",
    "firstName": "Test",
    "lastName": "Test",
    "address": "Test 1",
    "city": "Rzeszow",
    "country": "PL",
    "documentType": "ID_CARD",
    "documentNumber": "ABC12345",
    "pesel": "12345678901",
    "birthCountry": "PL",
    "birthDate": "2000-01-01T00:00:00.000Z"
  },
  "orderId": "d039c6e2-14e9-4557-9168-396e9e65a5df"
}'
Response Response Example
{}
Previous
Crypto Deposit Webhook
Next
Card Transaction Webhook
Built with