How to Create an Order and Generate a Payment Link
You’ve got a product and a price — now let’s get paid! The POST /orders endpoint helps you create an order, generate a
unique short link, and share it anywhere (email, WhatsApp, even QR code).
Why use an order?
Orders are the foundation for payments. They help track:
- Who’s paying (customer info)
- How much they’re paying
- What they’re buying
- And where they’re redirected after payment
Example: Create your first order
Here’s a full example you can try:
curl -X POST "https://api.inkress.com/api/v1/orders" \
-H "Authorization: Bearer YOUR_JWT" \
-H "Client-Id: m-nonitropicals" \
-H "Content-Type: application/json" \
-d '{
"currency_code": "JMD",
"customer": {
"email": "ava@example.com",
"first_name": "Ava",
"last_name": "Lee"
},
"total": 2499,
"reference_id": "order-1001",
"kind": "online"
}'
You’ll get something like:
{
"state": "ok",
"data": {
"id": 12345,
"payment_urls": {
"short_link": "https://pay.inkress.com/abc123"
}
}
}
That short_link is your hosted checkout page — ready to share!
Common use cases
- Selling items on Instagram? Send the short link via DM.
- Running a service business? Embed the link in invoices.
- Want to simplify your checkout flow? Redirect users directly there.
Friendly reminders
✅ Include currency_code and total — they’re required.
✅ Use a unique reference_id so you can match orders later.
✅ Don’t mark orders “paid” yourself — Inkress will handle that once payment succeeds.