Developer docs
Quickstart
Create a payment link with the API, open its checkout, and read its status back. This takes about five minutes.
- 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.
- 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.
- Create a payment link.
Send a
POSTrequest. Theamountis 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"
}- Send the customer to the checkout.
Share
checkoutUrlby email, chat or SMS, or redirect the customer to it. See Hosted checkout. - Check the status.
Fetch the payment link by its
idto 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.