Onramp

Onramp transaction failed

Triggered when the onramp.transaction.failed webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookonrampTransactionFailed

Payload

OR

Example payload

{
  "eventType": "onramp.transaction.updated",
  "transactionId": "1f087a54-ff1f-62e8-9f85-aa77ac0499a5",
  "status": "ONRAMP_TRANSACTION_STATUS_IN_PROGRESS",
  "purchaseCurrency": "USDC",
  "purchaseNetwork": "ethereum",
  "purchaseAmount": {
    "currency": "USD",
    "value": "5.00"
  },
  "paymentTotal": {
    "currency": "USD",
    "value": "5.00"
  },
  "paymentTotalUsd": {
    "currency": "USD",
    "value": "5.00"
  },
  "paymentSubtotal": {
    "currency": "USD",
    "value": "5.00"
  },
  "coinbaseFee": {
    "currency": "USD",
    "value": "5.00"
  },
  "networkFee": {
    "currency": "USD",
    "value": "5.00"
  },
  "exchangeRate": {
    "currency": "USD",
    "value": "5.00"
  },
  "txHash": "0x",
  "createdAt": "2025-09-02T02:34:13Z",
  "completedAt": "0001-01-01T00:00:00Z",
  "country": "US",
  "userId": "4132b63ee21128686458155b28570289",
  "paymentMethod": "CARD",
  "walletAddress": "0xe0512E358C347cc2b1A42d057065CE642068b7Ba",
  "type": "ONRAMP_TRANSACTION_TYPE_BUY_AND_SEND",
  "userType": "USER_TYPE_GUEST",
  "partnerUserRef": "example_user_ref",
  "failureReason": "FAILURE_REASON_UNSPECIFIED",
  "errorCode": "ERROR_CODE_UNSPECIFIED"
}

Response

Webhook received and processed successfully.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.