Get the QR charge status for an invoice (reconciles on read)

GET https://api.leapa.co/v2/invoices/{invoiceId}/qr-status

This endpoint needs your API key

Send it as a bearer token in the Authorization header. A request without one is answered with 401. See Authentication for where to find your key and how to keep it secret.

Request

curl -X GET "https://api.leapa.co/v2/invoices/inv_7c1f9a2b48/qr-status" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Accept: application/json"

Response

{
  "invoice_id": "inv_7c1f9a2b48",
  "status": "pending",
  "charge_id": "chg_5a90bc71de",
  "resumable": false,
  "regenerated": false,
  "qr_reference": "QR2026013100147",
  "expires_at": 1769850251000,
  "qr_as_text": "00020101021226580014BI.CBB.QR0111...",
  "qr_as_image": "data:image/png;base64,iVBORw0KGgo...",
  "amount": 45000,
  "currency": "BIF",
  "settlement_pending_record": false,
  "message": "Request sent to the payer"
}

Path parameters

Values that go into the URL itself.

invoiceIdstringrequired
Example:inv_7c1f9a2b48

Response

application/json

invoice_idstring
statusstring
Allowed values:pendingpaidcancelledexpired
charge_idstring
resumableboolean
regeneratedboolean
qr_referencestring
expires_atinteger<int64>
qr_as_textstring
qr_as_imagestring
amountinteger<int64>
currencystring
settlement_pending_recordboolean
messagestring

Status codes

200OK
400Bad request
401Unauthorized
402Payment required
403Forbidden
404Not found
428Precondition required
500Server error

Response

{
  "invoice_id": "inv_7c1f9a2b48",
  "status": "pending",
  "charge_id": "chg_5a90bc71de",
  "resumable": false,
  "regenerated": false,
  "qr_reference": "QR2026013100147",
  "expires_at": 1769850251000,
  "qr_as_text": "00020101021226580014BI.CBB.QR0111...",
  "qr_as_image": "data:image/png;base64,iVBORw0KGgo...",
  "amount": 45000,
  "currency": "BIF",
  "settlement_pending_record": false,
  "message": "Request sent to the payer"
}