Get invoices from the API

Retrieve invoices from the Billions API using the order_no stored with your order. This is useful for displaying payment status, reconciling local records, or restoring an invoice after an uncertain create request. For example, a create request may time out after Billions has created the invoice but before your backend receives the response. Before creating another invoice, query the API using the stable order_no.

const invoices = await api.getInvoicesByOrder('ORDER-1001');

for (const invoice of invoices) {
  console.log(invoice.id, invoice.status, invoice.invoice_url);
}

$invoices = $api->getInvoicesByOrderNo('ORDER-1001');

foreach ($invoices as $invoice) {
    echo $invoice['id'] . ' ' . $invoice['status'] . PHP_EOL;
}

curl --request GET \
  --url https://api.billions.works/public/v1/invoices/byOrder/ORDER-1001 \
  --header "Content-Type: application/json" \
  --header "x-api-key: $BILLIONS_API_KEY"

Retrieval and recovery rules

Retry the same logical create attempt with the same idempotency key.
Query by order_no when reconciling your local order with Billions.
Match the amount, currency, and intended attempt before redirecting.
Create a new attempt only when the previous attempt is no longer usable.

Introduction

Integration guide

Examples

SDKs

Store integrations

Get invoices from the API

Retrieval and recovery rules

​Retrieval and recovery rules

Retrieval and recovery rules