Payment Sessions

Payment session authorization succeeded

Triggered when the acceptance.payment_session.authorization_succeeded webhook event is emitted. Your API will receive a POST request at the webhook URL you configured.

postWebhookacceptancePaymentSessionAuthorizationSucceeded

Payload

eventIdstring uuid required

Unique identifier for this webhook event. Use this for idempotency.

timestampstring date-time required

When this event occurred (ISO 8601 format).

eventType'acceptance.payment_session.authorization_succeeded' required

The type of webhook event.

Example payload

{
  "eventType": "acceptance.payment_session.authorization_succeeded",
  "eventId": "456h7890-h12e-45g6-d789-759947407333",
  "timestamp": "2025-06-15T12:02:00Z",
  "data": {
    "paymentSession": {
      "paymentSessionId": "paymentSession_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "entityId": "entity_af2937b0-9846-4fe7-bfe9-ccc22d935114",
      "amount": "1.00",
      "asset": "usdc",
      "source": {
        "address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
        "network": "base",
        "asset": "usdc"
      },
      "target": {
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "network": "base"
      },
      "autoCapture": false,
      "expiries": {
        "authorizationExpiresAt": "2025-12-31T23:59:59.000Z",
        "captureExpiresAt": "2026-01-15T23:59:59.000Z",
        "refundExpiresAt": "2026-02-15T23:59:59.000Z"
      },
      "status": "authorization_succeeded",
      "balances": {
        "capturable": "1.00",
        "captured": "0",
        "refundable": "0",
        "refunded": "0"
      },
      "externalReferenceId": "merchant-order-abc123",
      "metadata": {
        "customer_id": "cust_12345",
        "order_reference": "order-67890"
      },
      "createdAt": "2025-06-15T12:00:00.000Z",
      "updatedAt": "2025-06-15T12:02:00.000Z"
    },
    "authorization": {
      "authorizationId": "authorization_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "status": "succeeded",
      "amount": "1.00",
      "source": {
        "address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
        "network": "base",
        "asset": "usdc"
      },
      "onchainTransactions": [
        {
          "transactionHash": "0xabc123def456789012345678901234567890abcdef1234567890abcdef123456",
          "network": "base"
        }
      ],
      "createdAt": "2025-06-15T12:01:00.000Z",
      "updatedAt": "2025-06-15T12:02:00.000Z"
    }
  }
}

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.