Crypto Withdrawal Webhook

API Overview

Item	Value
API Status	Recommended
Current Version	v2.0
Backward Compatibility	Yes
Applicable Environment	Production
Applicable User Roles	PSP and Direct Client
Type	Webhook (Incoming)

Description
To update crypto withdrawal status.

This is a webhook endpoint that must be implemented by the recipient to receive these notifications.
Important:

You do not need to call this API; instead, you need to expose a public endpoint matching this specification.

Refer to the Webhook section for details on signature verification, retry policy, and security best practices.

Request

Authorization

Body Params application/json

Example

{
    "code": 200,
    "msg": "success",
    "eventType": "crypto.withdrawal.updated.v2",
    "notificationId": "a09a9437-120a-4a7f-8884-58cc8977c03a",
    "data": {
        "cryptoWithdrawalId": "WD2026041514300001",
        "participantCode": "B0100106",
        "withdrawalType": 2,
        "currency": "ETH",
        "feeCurrency": "ETH",
        "amount": "498.09",
        "feeAmount": "8.50",
        "beneficiaryWallet": {
            "label": "External Withdrawal Wallet",
            "description": "Recipient's ETH wallet for fund withdrawal",
            "blockchain": "ETH",
            "walletAddress": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
            "walletType": 1,
            "platformName": "Binance",
            "platformUserId": "user_binance_12345",
            "ownerInfo": {
                "ownerType": 1,
                "details": {
                    "name": "Angelina Windler",
                    "DOB": "1987-02-21",
                    "identityNumber": "ID123456789",
                    "residentialAddress": {
                        "country": "US",
                        "state": "South Dakota",
                        "city": "Sioux Falls",
                        "postcode": "57104",
                        "addressLine1": "200 North Phillips Avenue",
                        "addressLine2": "Suite 300"
                    }
                }
            }
        },
        "kytInfo": {
            "kytType": 1,
            "kytResult": 3,
            "kytDetails": "High risk - further review required"
        },
        "txHash": "0x8a7b1c3d5e9f2a4b6c8d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c",
        "purposeOfPayment": 5,
        "otherPurpose": "Digital asset trading",
        "relationshipWithThirdParty": 5,
        "otherRelationship": "Business Partner",
        "fileProofOfTransfer": "550e8400-e29b-41d4-a716-446655440000",
        "fileIDOrPassport": "660e8400-e29b-41d4-a716-446655440001",
        "filePurposeOfRecurring": "770e8400-e29b-41d4-a716-446655440002",
        "status": 2,
        "statusInfo": "PROCESSING",
        "updatedAt": 1776132908000,
        "createdAt": 1776046508000
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": 200,
    "msg": "success",
    "eventType": "crypto.withdrawal.updated.v2",
    "notificationId": "a09a9437-120a-4a7f-8884-58cc8977c03a",
    "data": {
        "cryptoWithdrawalId": "WD2026041514300001",
        "participantCode": "B0100106",
        "withdrawalType": 2,
        "currency": "ETH",
        "feeCurrency": "ETH",
        "amount": "498.09",
        "feeAmount": "8.50",
        "beneficiaryWallet": {
            "label": "External Withdrawal Wallet",
            "description": "Recipient'\''s ETH wallet for fund withdrawal",
            "blockchain": "ETH",
            "walletAddress": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
            "walletType": 1,
            "platformName": "Binance",
            "platformUserId": "user_binance_12345",
            "ownerInfo": {
                "ownerType": 1,
                "details": {
                    "name": "Angelina Windler",
                    "DOB": "1987-02-21",
                    "identityNumber": "ID123456789",
                    "residentialAddress": {
                        "country": "US",
                        "state": "South Dakota",
                        "city": "Sioux Falls",
                        "postcode": "57104",
                        "addressLine1": "200 North Phillips Avenue",
                        "addressLine2": "Suite 300"
                    }
                }
            }
        },
        "kytInfo": {
            "kytType": 1,
            "kytResult": 3,
            "kytDetails": "High risk - further review required"
        },
        "txHash": "0x8a7b1c3d5e9f2a4b6c8d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c",
        "purposeOfPayment": 5,
        "otherPurpose": "Digital asset trading",
        "relationshipWithThirdParty": 5,
        "otherRelationship": "Business Partner",
        "fileProofOfTransfer": "550e8400-e29b-41d4-a716-446655440000",
        "fileIDOrPassport": "660e8400-e29b-41d4-a716-446655440001",
        "filePurposeOfRecurring": "770e8400-e29b-41d4-a716-446655440002",
        "status": 2,
        "statusInfo": "PROCESSING",
        "updatedAt": 1776132908000,
        "createdAt": 1776046508000
    }
}'

Crypto Withdrawal Webhook

Request

Request Code Samples

Responses