Checkout Events

checkout_completed

Fires when a hosted or inline checkout session settles. kind is subscription, plan, or one_time. For a subscription or plan session the subscription and paid invoice are expanded; a one-time session has no subscription.

{
  "id": "evt_01hkbz5chkcmp00000000000000",
  "type": "checkout_completed",
  "createdAt": "2026-06-28T09:00:00.000Z",
  "data": {
    "checkoutToken": "chk_live_7Qm2x9Ab3Cd4Ef5Gh6Ij7Kl",
    "kind": "plan",
    "amount": 500000,
    "currency": "NGN",
    "reference": "DURO-CHK-8F3A21",
    "subscription": {
      "id": "sub_01hkbz3m4n5p6q7r8s9t0v1w2x",
      "status": "active",
      "customerId": "cus_01hkbz2a1b2c3d4e5f6g7h8j9k",
      "planId": "plan_01hkbz1z0y9x8w7v6u5t4s3r2q",
      "currentPeriodStart": "2026-06-28T09:00:00.000Z",
      "currentPeriodEnd": "2027-06-28T09:00:00.000Z",
      "trialEndsAt": null
    },
    "invoice": {
      "id": "inv_01hkbz4a5b6c7d8e9f0g1h2j3k",
      "amount": 500000,
      "currency": "NGN",
      "status": "paid",
      "periodStart": "2026-06-28T09:00:00.000Z",
      "periodEnd": "2027-06-28T09:00:00.000Z"
    },
    "customer": {
      "id": "cus_01hkbz2a1b2c3d4e5f6g7h8j9k",
      "email": "ada@example.com",
      "name": "Ada Lovelace",
      "phone": "+2348012345678"
    },
    "plan": {
      "id": "plan_01hkbz1z0y9x8w7v6u5t4s3r2q",
      "name": "Pro Annual",
      "amount": 500000,
      "currency": "NGN",
      "interval": "year",
      "intervalCount": 1
    }
  }
}

checkout_failed / checkout_cancelled

Fire when a checkout session fails at the gateway (checkout_failed) or the customer abandons it (checkout_cancelled). Both carry the same shape. The customer is expanded only if one already matched the session’s email or phone. The example is checkout_cancelled.

{
  "id": "evt_01hkbz5chkcxl00000000000000",
  "type": "checkout_cancelled",
  "createdAt": "2026-06-28T09:02:00.000Z",
  "data": {
    "checkoutToken": "chk_live_7Qm2x9Ab3Cd4Ef5Gh6Ij7Kl",
    "kind": "plan",
    "amount": 500000,
    "currency": "NGN",
    "reference": "DURO-CHK-8F3A21",
    "customer": {
      "id": "cus_01hkbz2a1b2c3d4e5f6g7h8j9k",
      "email": "ada@example.com",
      "name": "Ada Lovelace",
      "phone": "+2348012345678"
    }
  }
}