---
title: "Query checkout status"
method: GET
path: "/status"
tags: ["V1"]
---

# Query checkout status

`GET /status`

Get the status of a checkout.
To determine the status of the checkout, use the `result.code` and `result.description` fields in the response. For the full list of possible codes, see [Result codes](https://developer.peachpayments.com/docs/dashboard-response-codes#result-codes).
For more information, see the [documentation](https://developer.peachpayments.com/docs/checkout-payment-status), and for sample calls, see the [public Postman collection](https://www.postman.com/peachpayments/peach-payments-public-workspace/request/kvwxqv5/query-checkout-status?action=share&source=copy-link&creator=20323380&ctx=documentation).

## Query parameters

- `authentication.entityId` string, required
- `checkoutId` string
- `merchantTransactionId` string
- `signature` string, required

## Response `200`

Successfully retrieved the checkout status information.

- CheckoutStatus — Status response for checkout endpoints with detailed transaction information.
  - `amount` string, ^[0-9]{1,8}(\\.[0-9]{2})?$ — The checkout amount.
  - `card.bin` string — The first 6 digits of the card number (Bank Identification Number).
  - `card.expiryMonth` string — The expiry month of the card.
  - `card.expiryYear` string — The expiry year of the card.
  - `card.holder` string — The name of the card holder.
  - `card.last4Digits` string — The last 4 digits of the card number.
  - `checkoutId` string — The unique identifier for the checkout instance.
  - `currency` 'ZAR' | 'USD' | 'KES' | 'MUR' | 'GBP' | 'EUR' — The currency code of the payment request amount.
  - `customer.givenName` string — The customer's first name or given name (optional, may not be present in all responses).
  - `customer.surname` string — The customer's last name or surname (optional, may not be present in all responses).
  - `id` string — The unique transaction identifier.
  - `merchant.name` string — The name of the merchant.
  - `merchantTransactionId` string — Merchant-provided reference number unique for your transactions.
  - `paymentBrand` 'VISA' | 'MASTERCARD' | 'DINERS CLUB' | 'AMERICAN EXPRESS' | 'MASTERPASS' | 'MOBICRED' | 'MPESA' | '1FORYOU' | 'APLUS' | 'PAYPAL' | 'ZEROPAY' | 'PAYFLEX' | 'BLINKBYEMTEL' | 'CAPITECPAY' | 'PAYBYBANK' | 'MCBJUICE' | 'RCS' | 'FLOAT' | 'HAPPYPAY' | 'APPLE PAY' | 'GOOGLEPAY' | 'SAMSUNGPAY' | 'MAUCAS' | 'MONEYBADGER' | 'PAYSHAP' | 'NEDBANKDIRECTEFT' | 'ABSAEFT' — The payment method brand used for the transaction.
  - `paymentType` 'DB' | 'PA' — The payment type for the request.
  - `result.code` string — A code representing the transaction result.
  - `result.description` string — A human-readable description of the transaction result.
  - `resultDetails.AcquirerResponse` string — The response code from the acquiring bank.
  - `resultDetails.MerchantAdviceCode` string — Merchant Advice Code (MAC) indicating retry strategy for failed transactions. Common values are 01 (new account information available), 02 (cannot approve at this time), 03 (re-initiate transaction), 04 (do not try again).
  - `schemeTransactionId` string — Scheme-level transaction identifier for tracking and reconciliation.
  - `cardholderInitiatedTransactionId` string — Cardholder-initiated transaction identifier for tracking and reconciliation.
  - `signature` string — Token to verify the integrity of the response.
  - `timestamp` string, date-time — Date and time when the transaction was processed.

## Other responses

- `400` — Invalid request state or parameters, check the response body for more details.
- `500` — Internal server error.

---

[API](https://skmtc.net/peachpayments/apis/checkout.md) · [All operations](https://skmtc.net/peachpayments/apis/checkout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peachpayments/checkout/revisions/3a98165665f8/schema)