Invoices

An invoice represents a request for payment. It contains information about the amount to be paid, the currency, and other metadata.

See how to create an invoice with the API.

Request example

{
    "amount": 25.00,
    "fiat_currency": "USD",
    "invoice_title": "Order #12345",
    "invoice_message": "Delivery within 3-5 business days."
}

See all invoice request fields.

When you create an invoice, our system generates a unique URL that you can share with your customers. This URL leads to a checkout page where they can complete the payment.

Response body

{
    "success": true,
    "invoice": {
        "id": 12345,
        "share_token": "<Share Token>",
        "created_at": "2025-11-11T11:11:00.000Z",
        "pay_url": "https://point-of-sale-domain/pay-invoice?share_token=<Share Token>"
    }
}

An invoice can reference one payment at a time. It is possible a payment spawned from an invoice may fail, in which case the invoice will return to an unpaid state and can be paid again.

This makes the task of tracking payments easier, as you can always refer to the invoice by ID to see the current status of most recent payment attempt.

Once an invoice is paid successfully, it is locked from the customer, cannot return to unpaid status, and additional payments cannot be created by its checkout page.

When you create an invoice, you should store the invoice ID alongside your order or transaction in your own system, so products or services can be delivered in response to updates received from notification channels.