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.