Get Payment Session
GET/public/api/v1/sessions/:id
Retrieve the current state and details of a specific payment session.
This endpoint can be used to look up a session by its ID and inspect its lifecycle, including whether it is still pending, in progress, completed, or expired.
This endpoint is subject to rate limits and must not be used for continuous polling.
Instead, you should rely on the notificationUrl provided during session initialization to receive the outcome of the payment. This is the primary and recommended integration pattern.
Use this endpoint as a fallback mechanism - for example, if you did not receive a webhook or need to manually verify the final state of a session.
Request​
Responses​
- 200
- 400
- 422
- 500
Successful response containing the payment session and, when applicable, the resulting transaction.
The session object always reflects the latest state of the payment session.
If the session has reached the COMPLETED state, the transaction field will contain the successful transaction that finalized the session.
For all other session states, the transaction field will be null.
Standard error response returned when a request fails. Contains a machine-readable error code, a human-readable message.
Standard error response returned when a request fails.
Contains a machine-readable error code, a human-readable message,
and an errors object with field-specific validation issues.
Standard error response returned when a request fails. Contains a machine-readable error code, a human-readable message.