Payment Link
Kazza Payment Links make it simple to accept crypto payments and get settled instantly in local fiat. Share a link, let your customer pay in crypto, and receive fiat.
📌 How a Payment Link Works
1. Create a Payment Link
Use the POST /v1/paymentlink/create endpoint to generate a new payment link.
Provide transaction details such as:
amount(e.g. 50.00)currency(e.g. NGN, GHS, USD)merchant_reference(your unique reference for reconciliation)
The API response will include a link_url.
2. Share with Your Customer
Send the
link_urlvia email, SMS, or WhatsApp.Or embed it in your website/app as a button.
3. Customer Pays in Crypto
Customer opens the link, chooses their preferred asset (e.g. USDC, USDT, SOL).
A one-time wallet address/QR code is displayed.
Our system monitors the blockchain and confirms payment automatically.
4. Settlement in Fiat
Once funds are received and confirmed, Kazza converts to fiat instantly.
Settlement is sent to your linked account (e.g. NGN, GHS etc.).
You’ll also receive a webhook notification with the final status.
🧑💻 Developer Notes
Verification: Always rely on webhooks for final settlement status. You can also poll using
GET /v1/payment/{id}.Payment Scope: Payment links only support crypto-to-fiat (no crypto-to-crypto).
Error Handling: Implement flows for:
cancelled– customer closed link without paying.expired– session timed out.underpaid– customer sent less than required.
Idempotency: Use your
merchant_referenceto avoid duplicate processing.
Last updated