Quickstart

This guide walks you through creating your first payment and checking its status. You'll
need your API keys.

1. Create a payment

Send a POST request to /v1/payments with the amount, currency, and your own reference.

Use the Idempotency-Key header so a retried request never creates a duplicate payment.

2. Read the response

The payment is returned immediately with a status of created:

{
  "data": {
    "id": "txn_3a7f9c1e0b2d4856",
    "status": "created",
    "amount": "1000.00",
    "currency": "USD",
    "createdAt": "2026-07-07T12:34:56Z"
  }
}

Store the returned id — you'll use it to track the payment.

3. Check the status

The payment settles asynchronously. Retrieve it by id to see its current status:

When the payment reaches a terminal status such as paid, it's settled:

{
  "data": {
    "id": "txn_3a7f9c1e0b2d4856",
    "status": "paid",
    "amount": "1000.00",
    "currency": "USD",
    "createdAt": "2026-07-07T12:34:56Z"
  }
}

1. Create a payment#

2. Read the response#

3. Check the status#

1. Create a payment

2. Read the response

3. Check the status