eventId, eventType, timestamp, and data. For payment session events, data.paymentSession always contains a session summary. For action-triggered events, the corresponding action detail is also included as a sibling field: data.authorization, data.capture, data.void, or data.refund.
Payment session events
- Authorization Succeeded
- Authorization Failed
- Capture Succeeded
- Refund Succeeded
- Void Succeeded
- Canceled
Buyer’s funds are held. Ready to capture.
{
"eventId": "evt_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"eventType": "acceptance.payment_session.authorization_succeeded",
"timestamp": "2026-05-16T12:02:00Z",
"data": {
"paymentSession": {
"paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
"entityId": "entity_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"status": "authorization_succeeded",
"amount": "100.00",
"asset": "usdc",
"target": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usd"
},
"source": {
"address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
"network": "base"
},
"balances": {
"capturable": "100.00",
"captured": "0",
"refundable": "0",
"refunded": "0"
},
"externalReferenceId": "order-12345",
"metadata": {
"customer_id": "cust_12345"
},
"createdAt": "2026-05-16T12:00:00.000Z",
"updatedAt": "2026-05-16T12:02:00.000Z"
},
"authorization": {
"authorizationId": "authorization_93d980d2-95f2-55fe-b9d3-2bd340cf10be",
"status": "succeeded",
"amount": "100.00",
"source": {
"address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
"network": "base"
},
"onchainTransactions": [
{
"transactionHash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456",
"network": "base"
}
],
"createdAt": "2026-05-16T12:01:00.000Z",
"updatedAt": "2026-05-16T12:02:00.000Z"
}
}
}
Authorization could not be completed.
{
"eventId": "evt_b2c3d4e5-f6a7-8901-bcde-f12345678901",
"eventType": "acceptance.payment_session.authorization_failed",
"timestamp": "2026-05-16T12:02:00Z",
"data": {
"paymentSession": {
"paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
"entityId": "entity_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"status": "authorization_failed",
"amount": "100.00",
"asset": "usdc",
"target": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usd"
},
"balances": {
"capturable": "0",
"captured": "0",
"refundable": "0",
"refunded": "0"
},
"createdAt": "2026-05-16T12:00:00.000Z",
"updatedAt": "2026-05-16T12:02:00.000Z"
},
"authorization": {
"authorizationId": "authorization_93d980d2-95f2-55fe-b9d3-2bd340cf10be",
"status": "failed",
"amount": "100.00",
"error": {
"code": "insufficient_funds",
"message": "The payer does not have sufficient funds.",
"occurredAt": "2026-05-16T12:02:00.000Z"
},
"createdAt": "2026-05-16T12:01:00.000Z",
"updatedAt": "2026-05-16T12:02:00.000Z"
}
}
}
Funds captured and settled.
{
"eventId": "evt_c3d4e5f6-a7b8-9012-cdef-123456789012",
"eventType": "acceptance.payment_session.capture_succeeded",
"timestamp": "2026-05-16T12:06:00Z",
"data": {
"paymentSession": {
"paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
"entityId": "entity_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"status": "capture_succeeded",
"amount": "100.00",
"asset": "usdc",
"target": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usd"
},
"source": {
"address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
"network": "base"
},
"balances": {
"capturable": "0",
"captured": "100.00",
"refundable": "100.00",
"refunded": "0"
},
"externalReferenceId": "order-12345",
"createdAt": "2026-05-16T12:00:00.000Z",
"updatedAt": "2026-05-16T12:06:00.000Z"
},
"capture": {
"captureId": "capture_a4eaa1f3-c6a4-77f9-d1f5-4df562df32df",
"status": "succeeded",
"amount": "100.00",
"onchainTransactions": [
{
"transactionHash": "0xdef456abc789012345678901234567890abcdef1234567890abcdef12345678",
"network": "base"
}
],
"createdAt": "2026-05-16T12:05:00.000Z",
"updatedAt": "2026-05-16T12:06:00.000Z"
}
}
}
Captured funds returned to the buyer.
{
"eventId": "evt_d4e5f6a7-b8c9-0123-def0-234567890123",
"eventType": "acceptance.payment_session.refund_succeeded",
"timestamp": "2026-05-16T14:00:00Z",
"data": {
"paymentSession": {
"paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
"entityId": "entity_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"status": "refund_succeeded",
"amount": "100.00",
"asset": "usdc",
"target": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usd"
},
"source": {
"address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
"network": "base"
},
"balances": {
"capturable": "0",
"captured": "100.00",
"refundable": "50.00",
"refunded": "50.00"
},
"externalReferenceId": "order-12345",
"createdAt": "2026-05-16T12:00:00.000Z",
"updatedAt": "2026-05-16T14:00:00.000Z"
},
"refund": {
"refundId": "refund_b5fbb2f4-d7a5-88af-e2f6-5ef673ef43ef",
"status": "succeeded",
"amount": "50.00",
"reason": "Customer returned item",
"onchainTransactions": [
{
"transactionHash": "0x012345678901234567890abcdef1234567890abcdef1234567890abcdef1234",
"network": "base"
}
],
"createdAt": "2026-05-16T13:55:00.000Z",
"updatedAt": "2026-05-16T14:00:00.000Z"
}
}
}
Uncaptured authorized funds released back to the buyer.
{
"eventId": "evt_e5f6a7b8-c9d0-1234-ef01-345678901234",
"eventType": "acceptance.payment_session.void_succeeded",
"timestamp": "2026-05-16T12:35:00Z",
"data": {
"paymentSession": {
"paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
"entityId": "entity_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"status": "void_succeeded",
"amount": "100.00",
"asset": "usdc",
"target": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usd"
},
"balances": {
"capturable": "0",
"captured": "0",
"refundable": "0",
"refunded": "0"
},
"createdAt": "2026-05-16T12:00:00.000Z",
"updatedAt": "2026-05-16T12:35:00.000Z"
},
"void": {
"voidId": "void_c6gcc3g5-e8b6-99bg-f3g7-6fg784fg54fg",
"status": "succeeded",
"amount": "100.00",
"onchainTransactions": [
{
"transactionHash": "0x789012345678901234567890abcdef1234567890abcdef1234567890abcdef12",
"network": "base"
}
],
"createdAt": "2026-05-16T12:30:00.000Z",
"updatedAt": "2026-05-16T12:35:00.000Z"
}
}
}
Void webhook events are reserved for future use and are not yet emitted.
Session canceled before authorization. Session-level events like this one have no action detail field — the
paymentSession.status value is sufficient.{
"eventId": "evt_f6a7b8c9-d0e1-2345-f012-456789012345",
"eventType": "acceptance.payment_session.canceled",
"timestamp": "2026-05-16T12:10:00Z",
"data": {
"paymentSession": {
"paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
"entityId": "entity_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"status": "canceled",
"amount": "100.00",
"asset": "usdc",
"target": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usd"
},
"balances": {
"capturable": "0",
"captured": "0",
"refundable": "0",
"refunded": "0"
},
"createdAt": "2026-05-16T12:00:00.000Z",
"updatedAt": "2026-05-16T12:10:00.000Z"
}
}
}
Disbursement events
- Succeeded
- Failed
Disbursement settled onchain.
{
"eventId": "evt_g7b8c9d0-e1f2-3456-0123-567890123456",
"eventType": "acceptance.disbursement.succeeded",
"timestamp": "2026-05-16T17:05:00Z",
"data": {
"disbursementId": "disbursement_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
"source": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usdc"
},
"target": {
"coinbaseUserId": "coinbase_user_abc123"
},
"amount": "25.00",
"asset": "usdc",
"status": "succeeded",
"reason": "Goodwill credit for delayed shipment",
"externalReferenceId": "credit-2026-05-1234",
"metadata": {
"customer_id": "cust_12345"
},
"onchainTransactions": [
{
"transactionHash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456",
"network": "base"
}
],
"createdAt": "2026-05-16T17:00:00.000Z",
"updatedAt": "2026-05-16T17:05:00.000Z"
}
}
Disbursement could not be completed.
{
"eventId": "evt_h8c9d0e1-f2a3-4567-1234-678901234567",
"eventType": "acceptance.disbursement.failed",
"timestamp": "2026-05-16T17:01:00Z",
"data": {
"disbursementId": "disbursement_93d980d2-95f2-55fe-b9d3-2bd340cf10be",
"source": {
"accountId": "account_af2937b0-9846-4fe7-bfe9-ccc22d935114",
"asset": "usdc"
},
"target": {
"coinbaseUserId": "coinbase_user_def456"
},
"amount": "50.00",
"asset": "usdc",
"status": "failed",
"reason": "Refund for order cancellation",
"error": {
"code": "insufficient_funds",
"message": "The source account does not have sufficient funds.",
"occurredAt": "2026-05-16T17:01:00.000Z"
},
"createdAt": "2026-05-16T17:00:00.000Z",
"updatedAt": "2026-05-16T17:01:00.000Z"
}
}
This page shows full incoming webhook request bodies (
eventId, eventType, timestamp, data). See the API Reference for complete field definitions.Related
Webhook Subscriptions
Create and manage webhook subscriptions
Verification
Verify webhook signatures