Partner API
  1. Transfers & Payments Webhooks
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Get Balances
      • Create Wallet
      • Get Transaction History
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Infromation
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
      • Create a SEPA Transfer
      • Get SEPA Transfer Details
    • User Accounts
      • Create User Account
      • Add KYC File
      • Add POA File
      • Add User Verification
      • Extend user
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • KYC by P100
      • Creating KYC Verification
      • Redirect to Verification
      • Get KYC Status
    • Currency Exchange
      • Retrieve Exchange Rate
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Infromation
    • Crypto Deposits
      • Update Travel Rule
    • Crypto Withdrawals
      • Get Network Fee
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • 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
    • Custom Fiat Operations
      • SEPA Deposit & Withdrawal
    • Orders
      • Get Rates
      • Retrieve Order Rate and Create a Lock
      • Create and Finalize an Order
      • Get Order Details
    • Payment link
      • Generate Payment Link
      • Get Payment Link Details
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation
        • KYC File Added
        • POA Verification Status
        • KYC Verification Status
        • Create wallet
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
          POST
        • SEPA Transfer
          POST
        • SEPA Deposit
          POST
        • Crypto Withdrawal
          POST
        • Crypto Deposit
          POST
        • Exchange
          POST
        • Card Transaction
          POST
        • Order status
          POST
        • Payment Link
          POST
      • Card Webhooks
        • Card 3DS Code
        • Card Activation Code
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Transfers & Payments Webhooks

Order status

Webhook
POST
/order-webhook
This event is dispatched whenever the status of a placed order changes.
For a new order, a webhook is sent once the payment wallet is generated. This event corresponds to the order's status changing to WAITING_FOR_DEPOSIT. The payload for this event and subsequent status changes will contain the order's current details, including the walletAddress and expiresAt fields after they have been populated.

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
  "orderId": "d4a8e63a-8b8a-4b6f-8c1c-72c8473f1b2a",
  "lockId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "WAITING_FOR_CONFIRMATION",
  "createdAt": "2025-09-24T12:45:10.123Z",
  "expiresAt": "2025-09-24T13:15:10.123Z",
  "confirmations": 2,
  "requiredConfirmations": 3,
  "receivedAmount": 0.0015,
  "totalAmountRequired": 0.0015,
  "cryptocurrency": "btc",
  "walletAddress": "tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx",
  "transactionHash": "a1075db55d416d3ca4202f78bde033b3a6e3d2e0e0a5a3a1a6e3d2e0e0a5a3a1"
}'
Response Response Example
{}
Previous
Card Transaction
Next
Payment Link
Built with