Withdrawal

This event is emitted when a withdrawal request completes, resulting in either failure or success. The webhook eventType is managedWithdrawal.

Payload schema

Webhook payload

Use this schema when validating, storing, or transforming the incoming managedWithdrawal webhook payload.

idstring<uuid>required

Unique identifier for this webhook delivery.

webhookIdstring<uuid>required

Identifier of the webhook configuration that produced this delivery.

eventTypestringrequired

Discriminator for the event. Always the value shown here for this event.

AllowedmanagedWithdrawal

eventDataobjectrequired

Event-specific payload. The key matches eventType.

managedWithdrawalWithdrawalDatarequired

withdrawalRequestIdstring<uuid>required

networkNetworkrequired

AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetCardanoDashSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetZcashZcashTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetFiat

tokenstringnullable

withdrawalAmountnumber<float>required>= 0

recipientAddressstringnullable

transactionHashstringnullable

isSuccessbooleanrequired

failureReasonstringnullable

receiptWithdrawalReceiptnullable

EVMReceiptEVMReceiptrequired

transactionHashstringnullable

networkFeeAmountnumber<float>nullable>= 0

BTCReceiptBTCReceiptrequired

transactionIdstringnullable

networkFeeAmountnumber<float>nullable>= 0

BSVReceiptBSVReceiptrequired

transactionIdstringnullable

networkFeeAmountnumber<float>nullable>= 0

DOGEReceiptDOGEReceiptrequired

transactionIdstringnullable

networkFeeAmountnumber<float>nullable>= 0

LTCReceiptLTCReceiptrequired

transactionIdstringnullable

networkFeeAmountnumber<float>nullable>= 0

BCHReceiptBCHReceiptrequired

transactionIdstringnullable

networkFeeAmountnumber<float>nullable>= 0

XMRReceiptXMRReceiptrequired

transactionIdstringnullable

networkFeeAmountnumber<float>nullable>= 0

SOLReceiptSOLReceiptrequired

signaturestringnullable

networkFeeAmountnumber<float>nullable>= 0

DOTReceiptDOTReceiptrequired

transactionHashstringnullable

networkFeeAmountnumber<float>nullable>= 0

FiatReceiptFiatReceiptrequired

finalAmountstringnullable

transferMethodTransferMethodnullable

AllowedSepaAchWire

flatFeenumber<float>nullable>= 0

percentFeenumber<float>nullable>= 0

transactionHashstringnullable

destinationWithdrawalDestinationnullable

uetrstringnullable

currencystringnullable

paymentRailstringnullable

traceNumberstringnullable

externalAccountIdstringnullable

radomDataRadomEventData

Context for the Radom object that triggered the event.

paymentLinkPaymentLinkDatarequired

paymentLinkIdstring<uuid>required

paymentLinkOrderIdstring<uuid>nullable

inputDataInputData[]nullable

labelstringrequired

valuestringnullable

checkoutSessionCheckoutSessionDatarequired

checkoutSessionIdstring<uuid>required

metadataMetadata[]nullable

keystringrequired

valuestringrequired

invoiceInvoiceDatarequired

invoiceIdstring<uuid>required

invoicePaymentIdstring<uuid>nullable

paymentSessionPaymentSessionDatarequired

paymentSessionIdstring<uuid>required

metadataMetadata[]nullable

keystringrequired

valuestringrequired

subscriptionSubscriptionIdDatarequired

subscriptionIdstring<uuid>required

donationLinkDonationLinkDatarequired

donationLinkIdstring<uuid>required

donationLinkOrderIdstring<uuid>required

{
  "id": "f01fa77a-6f71-45fd-884e-4212ec76e9e9",
  "webhookId": "ad474121-b97e-479b-a180-60a21bda8532",
  "eventType": "managedWithdrawal",
  "eventData": {
    "managedWithdrawal": {
      "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "network": "Ethereum",
      "recipientAddress": "0x7a037f6a2c8f0d932fe8b6d54ed8b4a92c39f8ab",
      "transactionHash": "0x562187e7513df5c4ce55b32d5d9c42d93ee3191a55bfeb1f6bf9fd262a3e6ff5",
      "receipt": {
        "EVMReceipt": {
          "transactionHash": "0x562187e7513df5c4ce55b32d5d9c42d93ee3191a55bfeb1f6bf9fd262a3e6ff5",
          "networkFeeAmount": "4.046932"
        }
      },
      "isSuccess": true,
      "failureReason": null,
      "withdrawalAmount": "30.26",
      "withdrawalRequestId": "ca22bd97-88c9-4b25-b2d7-fa2f33e1e298"
    }
  },
  "radomData": null
}