Skip to main content
Reconcile a mandate charge outcome and settle it with the card network. Call this after checking out with the credentials from Charge a Mandate. POST /v1/mandates/{id}/charges/{txnId}/report · Authenticated with your secret key (merchants) or Ed25519 signature (agents).

Path parameters

string
required
The mandate id.
string
required
The transactionId returned from Charge a Mandate.

Body

string
required
APPROVED or DECLINED.
string
required
PURCHASE.
string
Authorization code from your processor, max 128. Optional; recorded when supplied.
string
Processor response code, max 2. Optional.
string
Amount paid, decimal string. Optional.

Response

string
string
string
string
completed or failed.
string
The mandate’s status after settlement.
string
SUCCESS or FAILURE.

Notes

  • Reporting a one-time mandate charge as APPROVED moves the mandate to consumed; recurring mandates stay active.
  • authorization_code, response_code, and amount_paid are optional and recorded when supplied.

Error responses