Payment Transaction Events

These webhooks specifically relate to payment transaction capture updates, enabling you to monitor the lifecycle of shopper funds being captured during checkout.

PAYMENT_TRANSACTION_CAPTURE_STATUS_UPDATED

A catch-all event for any changes to the capture_status of a PaymentTransaction. Learn more about PaymentTransaction's here.

Sample Payload

{
  "id": 323596,
  "order_id": 8035507,
  "payment_provider": "STRIPE",
  "payment_provider_transaction_id": "xxx",
  "payment_method_id": 250933,
  "payment_provider_payment_method_id": "xxx",
  "payment_intent_client_secret": "xxx",
  "amount": 12262,
  "currency": "USD",
  "capture_status": "CAPTURED",
  "capture_method": "AUTOMATIC",
  "transfer_status": "SENT",
  "transfer_method": "AUTOMATIC",
  "metadata": {
    "payment_intent_client_secret": "xxx",
    "payment_intent_id": "xxx"
  },
  "related_bags": [
    "8147708"
  ],
  "related_refunds": [
    "7516"
  ],
  "errors": [],
  "date_created": "2025-04-08T16:20:05+0000",
  "date_last_modified": "2025-04-15T16:57:29+0000"
}

PAYMENT_TRANSACTION_CAPTURE_STATUS_REFUNDED

Emitted when a shopper is refunded and the capture_status of a PaymentTransaction moves to REFUNDED.

Sample Payload

{
  "id": 323596,
  "order_id": 8035507,
  "payment_provider": "STRIPE",
  "payment_provider_transaction_id": "xxx",
  "payment_method_id": 250933,
  "payment_provider_payment_method_id": "xxx",
  "payment_intent_client_secret": "xxx",
  "amount": 12262,
  "currency": "USD",
  "capture_status": "REFUNDED",
  "capture_method": "AUTOMATIC",
  "transfer_status": "SENT",
  "transfer_method": "AUTOMATIC",
  "metadata": {
    "payment_intent_client_secret": "xxx",
    "payment_intent_id": "xxx"
  },
  "related_bags": [
    "8147708"
  ],
  "related_refunds": [
    "7516"
  ],
  "errors": [],
  "date_created": "2025-04-08T16:20:05+0000",
  "date_last_modified": "2025-04-15T16:57:29+0000"
}

PAYMENT_TRANSACTION_CAPTURE_STATUS_PARTIALLY_REFUNDED

Emitted when a shopper is partially refunded and the capture_status of a PaymentTransaction moves to PARTIALLY_REFUNDED.

Sample Payload

{
  "id": 323596,
  "order_id": 8035507,
  "payment_provider": "STRIPE",
  "payment_provider_transaction_id": "xxx",
  "payment_method_id": 250933,
  "payment_provider_payment_method_id": "xxx",
  "payment_intent_client_secret": "xxx",
  "amount": 12262,
  "currency": "USD",
  "capture_status": "PARTIALLY_REFUNDED",
  "capture_method": "AUTOMATIC",
  "transfer_status": "SENT",
  "transfer_method": "AUTOMATIC",
  "metadata": {
    "payment_intent_client_secret": "xxx",
    "payment_intent_id": "xxx"
  },
  "related_bags": [
    "8147708"
  ],
  "related_refunds": [
    "7516"
  ],
  "errors": [],
  "date_created": "2025-04-08T16:20:05+0000",
  "date_last_modified": "2025-04-15T16:57:29+0000"
}