Skip to main content
POST
Cancel an invoice
Documentation for invoices: Overview, Fees, Create invoice, Cancel invoice, Callbacks.For new integrations, consider using payment requests instead.
Use this endpoint to cancel an invoice. You can only cancel invoices while they are still at the created, pending or processing stage. Invoices that have the confirmed or failed statuses cannot be cancelled.

Authorizations

X-Processing-Key
string
header
required

Your API key.

Headers

X-Processing-Signature
string
required

Hex-encoded HMAC-SHA512 signature of the request body, generated using your secret key.

Path Parameters

foreign_id
string
required

The unique identifier of the invoice you need to cancel.

Example:

"invoice_123"

Body

application/json

This endpoint does not accept any request parameters. Both an empty JSON object ({}) and a completely empty (zero-byte) body are accepted. Content-Type: application/json is still required if you send {} — but if the body is truly empty (zero bytes), Content-Type isn't checked at all (it can be omitted or set to any value).

Response

OK

Last modified on July 31, 2026