Invoices

/docs/global/api-reference/invoicesGlobal

Line-itemized bills you send to a customer for manual payment — distinct from a Payment, which is a single amount collected via Hosted Checkout.

Authenticated by dashboard session, not an API key

Authorized by your dashboard session bearer token, not an sk_ key — see Authentication. Paths below are relative to https://binkpay.net/api/v1.

Create an invoice

POST/api/v1/merchant/invoices

Parameter	Type	Required	Description
items	array	Optional	Line items (description, quantity, unit price). Omit for a single-total invoice.
invoiceNumber	string	Optional	Your own reference number, shown to the customer.

json

{
 "id": "inv_7d2c91",
 "status": "SENT",
 "invoiceNumber": "INV-2026-0142",
 "amountMinor": "45000",
 "currency": "EGP"
}

GET /api/v1/merchant/invoices/:id/pdf — download a PDF copy.
GET /api/v1/merchant/invoices/:id/timeline — every status change with a timestamp.
POST /api/v1/merchant/invoices/:id/mark-paid — record an out-of-band payment (e.g. bank transfer).
POST /api/v1/merchant/invoices/:id/resend — re-send the invoice email.
POST /api/v1/merchant/invoices/:id/cancel — void an unpaid invoice.

GET/api/v1/merchant/invoices/stats

Was this page helpful?