Get Invoice Status
GET
/api/v1/invoices/{id}/statusCoreFive-field projection of the invoice, cheap enough to poll while the buyer is on the checkout page. Prefer the payment.completed webhook for settlement; use this to reconcile after a missed delivery or to decide whether an unpaid invoice is still inside its window.
Authentication
Signature Pattern
HMAC-SHA256(apiSecret, "{t}\nGET\n/api/v1/invoices/{id}/status\n{sha256(\"\")}")| Header | Value | Description |
|---|---|---|
X-API-Key | a3f9c1e84b7d2065f1a4c8e93b6d0271 | Merchant point API key, a hex string issued with its secret when the point is created. Identifies the point whose invoices you can reach. |
X-Signature | t=1787735662,v1=8c1f0b7d4a29e63f5b0c8d17a4e92f6b3d05c7a81e4f9b26d3c07a5e18b4f962 | Request signature, format t={unix_seconds},v1={hex_hmac_sha256}. Timestamp tolerance is 300s. |
Content-Type | application/json | Always application/json. The signature is taken over the raw body bytes, so send exactly what you signed. |
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | Path parameter — invoice CUID. Unknown or out-of-scope ids return INVOICE_NOT_FOUND. |
Response Parameters
| Field | Type | Example |
|---|---|---|
id | string | "clyv3n8x40001qh7m2k9d5b1t" |
referenceId | string | "INV-260826-041C" |
status | string | "PAID" |
paidAt | string | "2026-08-26T09:31:47.118Z" |
expiresAt | string | "2026-08-26T10:14:22.481Z" |
Response Example
JSONResponse
{
"success": true,
"data": {
"id": "clyv3n8x40001qh7m2k9d5b1t",
"referenceId": "INV-260826-041C",
"status": "PAID",
"paidAt": "2026-08-26T09:31:47.118Z",
"expiresAt": "2026-08-26T10:14:22.481Z"
},
"timestamp": "2026-08-26T13:41:02.477Z",
"requestId": "req_V1StGXR8_Z5j"
}Error shape
JSONError
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
},
"timestamp": "2026-08-26T13:41:02.477Z",
"requestId": "req_V1StGXR8_Z5j"
}Status Codes
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
Try itMockapi2.havala.io
GEThttps://api2.havala.io