Get Payment Status - CommerceCash

GET /api/payments/{transactionId}/status Returns the current status and full details of a payment transaction using the system-generated transactionId.

If you only have your own reference number, use Get Payment Status by Reference instead.

Path Parameters

transactionId

string

required

The unique transaction ID returned by the Initiate Payment response.Example: TXN-20240616143022-A7F9E2

Response

200 — Success

data

object

Show PaymentStatusResponse

transactionId

string

System-generated unique transaction ID.

referenceNo

string

Merchant reference number.

status

string

Current payment status.Common values: PENDING, INITIATED, CONFIRMED, SUCCESSFUL, FAILED

amount

number (decimal)

Payment amount as a decimal value (e.g., 150.00).

productCode

string

Product code associated with the transaction.

createdAt

string (ISO 8601)

UTC timestamp of transaction creation.

lastModifiedAt

string (ISO 8601) | null

UTC timestamp of the most recent status update.

providerReference

string | null

Transaction reference from the downstream payment provider, if available.

message

string | null

Additional status detail or error description.

extraProperties

string | null

Additional status data, serialised as a JSON string.

400 — Bad Request

transactionId is missing or empty in the request path.

404 — Not Found

No transaction exists for the given transactionId.

500 — Internal Server Error

Examples

GET /api/payments/TXN-20240616143022-A7F9E2/status

Confirm Payment Get Payment Status by Reference

​Path Parameters

​Response

​200 — Success

​400 — Bad Request

​404 — Not Found

​500 — Internal Server Error

​Examples

Path Parameters

Response

200 — Success

400 — Bad Request

404 — Not Found

500 — Internal Server Error

Examples