​

Overview

• Retrieve the checkout intent status by checkout_intent_id
• Poll status after creating a checkout intent and redirecting users to hosted checkout

​

Important Design Notes

• All enum values are represented as integers in API requests and responses
• API consumers must always send and receive integer values
• This endpoint returns only the status integer (in payload)

​

Authentication

​

Notes

• X-Nonce must be unique per request
• X-Timestamp must be within allowed time window
• Signature must be generated using raw request body bytes
• Requests are protected against replay attacks

​

GET /v1/checkout_intents//status

​

Description

​

Request

​

Path Parameters

​

Headers

X-API-Key: <your_api_key>
X-Timestamp: <unix_timestamp>
X-Nonce: <uuid>
X-Signature: v1=<signature>

Note: This is a GET request, so there is no request body.

​

Successful Response

{
  "code": 0,
  "payload": 2,
  "error": null,
  "request_id": "req_xxxxx"
}

• payload is the checkout intent status integer.

​

Response Fields

​

Possible Errors

​

Notes

• This endpoint enforces permission checks: the checkout intent must belong to the authenticated store/business context.
• Always log request_id for debugging.
• Since payload is an int, do not expect payload.status or other nested fields.

​

Appendix — Checkout Intent Status Enum