{
"type": "ramp.transaction_updated",
"notification_id": "ramp.BQ123.withdrawal_completed",
"transaction_id": "BQ123",
"external_transaction_id": "checkout-session-123",
"status": "completed",
"state": "withdrawal_completed",
"timestamp": "2026-10-29T12:00:00+00:00",
"in_asset": "EUR",
"in_amount": "100.00",
"in_method": "card",
"out_asset": "USDC",
"out_amount": "108.50",
"expected_out_amount": "109.00",
"delivered_out_amount": "108.50",
"withdrawal_fee": "0.50",
"withdrawal_fee_currency": "USDC",
"trader_id": "AA84N84G2A43ZB4I",
"trader_country": "FR",
"network": "Ethereum",
"provider_asset_id": "ethereum/erc20/usd__coin",
"provider_network": "ethereum",
"destination_address": "0x1111111111111111111111111111111111111111",
"transaction_hash": "0xabc123",
"target_contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"affiliate_fee": "0.90",
"affiliate_fee_currency": "EUR"
}Webhooks
Ramp transaction updated
Triggered when a crypto purchase that a buyer started through a
partner’s Ramp widget checkout reaches a new state. Only the
partner whose Ramp widget checkout started the purchase receives
this event. Each delivery is a complete snapshot of the purchase at that state.
Deliveries may be retried or arrive out of order. Use notification_id to
discard duplicate deliveries, and compare timestamp when ordering
matters.
Field presence by state:
- Every state includes the purchase amounts,
networkanddestination_address. Beforewithdrawal_completed,out_amountis the quoted amount. - Only
withdrawal_completedincludesdelivered_out_amountandtransaction_hash. Failed and canceled purchases never include them. withdrawal_feeandaffiliate_feeare included once they are known, in any state.target_contract_addressis included only whenout_assetis a token.destination_memois included only when the destination has a tag or memo.in_methodis omitted when the payment method has no checkout name.
WEBHOOK
ramp.transaction_updated
{
"type": "ramp.transaction_updated",
"notification_id": "ramp.BQ123.withdrawal_completed",
"transaction_id": "BQ123",
"external_transaction_id": "checkout-session-123",
"status": "completed",
"state": "withdrawal_completed",
"timestamp": "2026-10-29T12:00:00+00:00",
"in_asset": "EUR",
"in_amount": "100.00",
"in_method": "card",
"out_asset": "USDC",
"out_amount": "108.50",
"expected_out_amount": "109.00",
"delivered_out_amount": "108.50",
"withdrawal_fee": "0.50",
"withdrawal_fee_currency": "USDC",
"trader_id": "AA84N84G2A43ZB4I",
"trader_country": "FR",
"network": "Ethereum",
"provider_asset_id": "ethereum/erc20/usd__coin",
"provider_network": "ethereum",
"destination_address": "0x1111111111111111111111111111111111111111",
"transaction_hash": "0xabc123",
"target_contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"affiliate_fee": "0.90",
"affiliate_fee_currency": "EUR"
}Body
application/json
Snapshot of a crypto purchase that a buyer started through a partner's Ramp widget checkout.
Purchase step that produced this update.
transaction_started: the purchase started (new).awaiting_payment: the purchase waits for the buyer's payment (pending).deposit_held: the payment is held for review (pending).deposit_credited: the payment was received (paid).deposit_failed: the payment failed (canceled).payment_failed: the payment failed after it was initiated (failed).quote_executed: the crypto was bought (pending).quote_execution_failed: the crypto could not be bought (failed).travel_rule_blocked: Travel Rule checks blocked the purchase (failed).withdrawal_started: the crypto is being sent todestination_address(pending).withdrawal_completed: the crypto was delivered (completed).withdrawal_failed: the crypto could not be delivered (failed).
Available options:
transaction_started, awaiting_payment, deposit_held, deposit_credited, deposit_failed, payment_failed, quote_executed, quote_execution_failed, travel_rule_blocked, withdrawal_started, withdrawal_completed, withdrawal_failed Response
2XX
Delivery endpoint accepted the webhook.