Developer docs

Quickstart

Create a payment link with the API, open its checkout, and read its status back. This takes about five minutes.

  1. Create an account and complete KYC.

    Sign up, then complete the KYC wizard. API requests only work once your account is approved. See Merchant KYC for what is required.

  2. Generate an API key.

    In your dashboard, open API keys and create a key. Copy the secret straight away, because it is shown only once. Read more in Authentication.

  3. Create a payment link.

    Send a POST request. The amount is in rupees.

curl -X POST "https://api.zozopay.in/api/v1/developer/payment-links" \
  -H "Authorization: Bearer <KEY_ID>:<KEY_SECRET>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 499.00,
    "description": "Order #1001",
    "receiptId": "rcpt_1001",
    "customerName": "Jane Doe",
    "customerEmail": "jane@example.com"
  }'

A successful call returns 201 with the payment link, including a ready-to-share checkoutUrl:

{
  "id": "cmtl4x82ws0001abc",
  "merchantId": "cmt...",
  "amount": 49900,
  "currency": "INR",
  "status": "CREATED",
  "paymentMethod": null,
  "description": "Order #1001",
  "receiptId": "rcpt_1001",
  "customerName": "Jane Doe",
  "customerEmail": "jane@example.com",
  "customerPhone": null,
  "gatewayReference": null,
  "paidAt": null,
  "refundedAt": null,
  "settlementId": null,
  "createdAt": "2026-09-19T08:30:00.000Z",
  "updatedAt": "2026-09-19T08:30:00.000Z",
  "checkoutUrl": "https://zozopay.in/pay/cmtl4x82ws0001abc"
}
  1. Send the customer to the checkout.

    Share checkoutUrl by email, chat or SMS, or redirect the customer to it. See Hosted checkout.

  2. Check the status.

    Fetch the payment link by its id to see whether it has been paid.

curl "https://api.zozopay.in/api/v1/developer/payment-links/<PAYMENT_LINK_ID>" \
  -H "Authorization: Bearer <KEY_ID>:<KEY_SECRET>"

Next: read the API reference for every field, or Payment statuses to understand the lifecycle.