Checkout Page

{
  "mode": "one-off", // recurring or save
  "amount": "1200.00",
  "currency_lookups_id": "loo_abc123...",
  // either pass the order_id or the order object
  "order_id": "ord_12345",
  // create a new order
  "order": {
    "reference": "ORD0045",
    "description": "Monthly plan + setup",
    "amount_subtotal": "1100.00",
    "amount_discount": "0.00",
    "amount_shipping": "0.00",
    "amount_tax": "100.00",
    "amount_total": "1200.00",
    "items": [
      {
        "sku": "SKU00567",
        "name": "Pro Plan (Monthly)",
        "quantity": 1,
        "unit_amount": "1200.00",
        "tax_amount": 0,
        "discount_amount": 0,
        "currency_lookups_id": "loo_abc123...",
        "metadata": {
          "custom_field_1": "custom data 1",
          "custom_field_2": "custom data 2",
        },
      }
    ]
  },
  // [optional: if no customer id or object is specified a form will show, here you can specify the fields to capture]
  "customer_fields": "reference,id_number,email,contact_number,billing,shipping",
  // [optional: either pass the customer_id or the customer object]
  "customer_id": "cus_abc123...",
  // create a new customer
  "customer": {
    "reference": "CLN240919000001",
    "company_name": null,
    "person_name": "John",
    "person_surname": "Doe",
    "client_type_lookups_id": "loo_abc123...",
    "id_type_lookups_id": "loo_abc123...",
    "id_number": "900112....",
    "email": "johndoe@mail.com",
    "contact_number": "+27831234567",
    "billing_address": {
        "line1": "1 Loop Street",
        "line2": "Floor 5",
        "city_or_town": "Cape Town",
        "province_or_state": "Western Cape",
        "postal_or_zip_code": "8001",
        "country_lookups_id": "loo_abc123..."
    },
    "shipping": {
      "contact_name": "Jane Doe",
      "contact_number": "+27820000000",
      "address": {
        "line1": "1 Loop Street",
        "line2": "Floor 5",
        "city_or_town": "Cape Town",
        "province_or_state": "Western Cape",
        "postal_or_zip_code": "8001",
        "country_lookups_id": "loo_abc123..."
      },
    },
    "metadata": {
      "custom_field_1": "custom data 1",
      "custom_field_2": "custom data 2",
    },
  },
  "redirects": {
    "success_url": "https://merchant.example/success?order=ord_12345",
    "cancel_url": "https://merchant.example/cancel?order=ord_12345",
    "notify_url": "https://merchant.example/webhooks/payments"
  },
  "payment": {
    "payment_methods_ids": ["pam_abc123"], // [optional: populate to specify payment methods to show else all will show]
    "payment_type_lookups_id": "loo_abc13...", // [optional: Direct Debit (Default), Pre-Authorization]
  },
  "cards": {
    "save_cards": true, // [optional: save cards for one-time payments]
    "show_cards": true, // [optional: show previous saved cards for use to select from]
  },
  "notifications": {
    "send_invoice": true,
    "send_confirmation_email": true,
    "confirmation_email_override": "accounts@example.com"
  },
  "customization": {
    "locale": "en-ZA",
    "theme": "light",
    "type": "page", // or embed
    "display_cancel_button": true,
    "display_total": true,
    "display_cart": true,
    "brand": {
      "primary": "#00DC82",
    }
  },
}

{
    "status": true,
    "result": {
      "id": "chk_abc123...",
      "session_id": "ses_abc123...",
      "amount": "1200.00",
      "currency_lookups_id": "loo_abc123...",
      "order_id": "ord_12345",
      "customer_id": "cus_abc123...",
      "page_url": "https://pay.kwik.co.za/checkout/cs_test_a1b2c3",
      "expires_at": "2025-09-13T12:30:00Z",
    }
}

{
  "event": "checkout.completed", // checkout.expired, checkout.failed
  "data": [{
    "checkout": {
      "id": "chk_abc123...",
      "session_id": "ses_abc123...",
      "amount": "1200.00",
      "currency_lookups_id": "loo_abc123...",
      "order_id": "ord_12345",
      "customer_id": "cus_abc123...",
      "card_id": "crd_abc123...", // return a card id if a card payment was made
      "transaction_id": "tra_abc123...",
      "transaction_status_lookups_id": "loo_abc123",
      "expires_at": "2025-09-13T12:30:00Z",
      "completed_at": "2025-09-13T10:15:30Z"
    },
    // return a payment only if a recurring payment was created
    "payment": {
      "id": "pay_abc123...",
      "amount": "1200.00",
      "currency_lookups_id": "loo_abc123...",
      "payment_status_lookups_id": "loo_abc123...",
      "payment_method_id": "pam_abc123...",
      "created_at": "2025-09-13T10:15:30Z"
    }
  }],
  "created_at": "2025-09-13T10:15:30Z"
}