WhatsApp Pay

# Inside the customer's 24-hour window, in a WhatsApp chat. Amounts in paise (₹1,499 = 149900).
curl -X POST https://fliok.com/api/v1/payment-requests \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conversationId": "2b7e9f1c-1a44-4c3e-9b0a-5d1a2f6d8e7c",
    "referenceId": "ORD-1042",
    "items": [ { "name": "Brass diya set", "quantity": 1, "unitPaise": 149900 } ],
    "shippingPaise": 9900,
    "body": "Here is your order. Tap Review and pay to pay on WhatsApp.",
    "expiresInMinutes": 1440
  }'

# :id is our id or your referenceId
curl https://fliok.com/api/v1/payment-requests/ORD-1042 -H "Authorization: Bearer wa_YOUR_API_KEY"

// 201 Created (200 with "duplicate": true when ORD-1042 was already sent in this chat)
{
  "paymentRequest": {
    "id": "a91c…",
    "referenceId": "ORD-1042",
    "conversationId": "2b7e…",
    "messageId": "c0de…",
    "status": "pending",
    "displayStatus": "pending",
    "statusLabel": "Awaiting payment",
    "items": [ { "name": "Brass diya set", "quantity": 1, "unitPaise": 149900, "linePaise": 149900, "retailerId": null } ],
    "subtotalPaise": 149900,
    "taxPaise": 0,
    "shippingPaise": 9900,
    "discountPaise": 0,
    "totalPaise": 159800,
    "paidPaise": null,
    "currency": "INR",
    "paymentMethod": null,
    "failureReason": null,
    "expiresAt": "2026-10-06T10:00:00.000Z",
    "paidAt": null,
    "orderStatus": null,
    "createdAt": "2026-10-05T10:00:00.000Z"
  },
  "messageId": "c0de…"
}

// Refusals name the cause:
// 409 whatsapp_pay_not_set_up · whatsapp_pay_paused · instagram_conversation · contact_opted_out
// 422 outside_24h_window — send a template first; once they reply you can ask for payment
// Subscribe to payment.paid instead of polling.