Partner API
  1. Transfers & Payments Webhooks
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Get Balances
      • Get Transaction History
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Create Crypto Withdrawal
      • Create a SEPA Transfer
      • Get SEPA Transfer Details
    • User Accounts with KYC
      • Create User Account and Generate Balances
      • Add KYC File
      • Add POA File
      • Add User Verification
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • User Accounts without KYC
      • Create User Account and Generate Balances Without KYC
      • 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
  • 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
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
          POST
        • SEPA Transfer
          POST
        • SEPA Deposit
          POST
        • Crypto Withdrawal
          POST
        • Crypto Deposit
          POST
        • Exchange
          POST
        • Card Transaction
          POST
      • Card Webhooks
        • Card 3DS Code
        • Card Activation Code
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Transfers & Payments Webhooks

Crypto Deposit

Webhook
POST
/crypto-deposit-webhook
This event is triggered whenever the status of an incoming cryptocurrency deposit is updated. It provides real-time notifications for the entire lifecycle of a deposit, from its initial detection on the blockchain to its final confirmation and crediting. Use this webhook to accurately update user balances and maintain a precise transaction history.

Status Descriptions:#

SUCCESSFUL: The deposit has been successfully processed and credited to the user's account.
UNSUCCESSFUL: The deposit was rejected or failed for other reasons.
WAITING_FOR_VERIFICATION: The deposit has been detected on the blockchain but is pending internal verification before being credited.
WAITING_FOR_TR_DATA: The deposit requires additional Travel Rule data before it can be processed.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
  "externalUserId": "8bdd8c8a-e9b7-475e-9690-8a34e8b78dab",
  "cryptoDepositId": "facc5951-bdc8-46bc-a01c-9b36f25be6af",
  "amount": 0.001,
  "currency": "eth",
  "status": "WAITING_FOR_TR_DATA",
  "transactionHash": "0x10d5bd4367fd6623a16f56889abb3bb2352b8ea7df7b21537f1fc56fc2d07a87",
  "createdAt": "2025-03-20T11:34:37.646Z"
}'
Response Response Example
{}

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Previous
Crypto Withdrawal
Next
Exchange
Built with