🛒 Checkout

📌 How Checkout Works

1. Create a Checkout Session

   • Use the POST {{baseURL}}/api/checkout/initiate-checkout/ endpoint to initialize a new checkout.

   • Provide transaction details such as amount, currency, and merchant reference.

2. Redirect or Embed

   • Direct your user to the returned checkout_url (for web).

   • Or embed the session into your mobile/web UI with our SDK or iframe component.

3. Customer Pays in Crypto

   • The customer selects their currency (e.g. USDC, USDT) and sends payment.

   • Our system monitors the blockchain and confirms once funds are received.

4. Settlement in Fiat

   • Once confirmed, Kazza instantly settles to your linked local bank account in naira (or other supported fiat).

   • You’ll also receive a webhook notification with the transaction status.

🧑‍💻 Developer Notes

• Always verify the transaction status via webhook or the GET /v1/checkout/{id} endpoint.

• Crypto-to-crypto payments are not supported in checkout — only crypto-to-fiat.

• Make sure to handle error states (cancelled, expired, or underpaid transactions).