---
title: "Fetch checkout transaction"
method: GET
path: "/v1/checkout/transaction"
tags: ["Online Checkout"]
---

# Fetch checkout transaction

`GET /v1/checkout/transaction`

Fetch checkout transaction

## Query parameters

- `idType` 'ORDER_ID' | 'ORDER_REFERENCE'
- `id` string

## Headers

- `accountId` string, uuid, required

## Response `200`

OK - your request was successful.

- object
  - `code` string — Response Code
  - `description` string — response description
  - `data` CheckoutTransaction
    - `success` boolean — True if the transaction is already completed and successful, false otherwise
    - `message` string — Response message describing the transaction status
    - `order` OrderDetails
      - `orderId` string — Id generated by Nomba for the checkout order
      - `orderReference` string — Reference of the online checkout order to be created
      - `customerId` string — Customer id
      - `accountId` string — The account Id whose wallet will be credited when the order is paid
      - `callbackUrl` string — Merchant callback url for redirect after payment
      - `customerEmail` string — Customer email
      - `amount` number, double — Amount to pay
      - `currency` 'NGN' — Currency of the money
    - `transactionDetails` CheckoutTransactionDetails
      - `transactionDate` string, date-time — Date the transaction was created
      - `paymentReference` string — The payment reference for the transaction
      - `paymentVendorReference` string — The payment reference returned by the payment gateway
      - `tokenizedCardPayment` boolean — True if the payment was made by a tokenized card
      - `statusCode` string — transaction status code returned by the payment gateway
    - `transferDetails` CheckoutTransferDetails
      - `sessionId` string — Transfer sessionId
      - `beneficiaryAccountName` string — The account name associated with the Merchants Nombank account
      - `beneficiaryAccountNumber` string — The Flash account number, where the payment was made to
      - `originatorAccountName` string — The name of the person making the transfer
      - `originatorAccountNumber` string — Nuban account number of the person making the transfer
      - `narration` string — The naration added by the customer when making the transfer
      - `destinationInstitutionCode` string — Destination bank code
      - `paymentReference` string — Transfer payment reference passed in from NIBSS for the transfer
    - `cardDetails` CheckoutCardDetails
      - `cardPan` string — The masked card pan
      - `cardType` string — The Card type
      - `cardCurrency` string — The card currency
      - `cardBank` string — Card Bank code

## Other responses

- `400` — The request body sent by merchant did not pass the validation checks
- `401` — The access_token provided to access the resource is missing or invalid.
- `403` — The client does not have the permissions to access this resource
- `404` — The record that the client is trying to access does not exist.
- `429` — The client has maxed out the number of calls within a time period on this resource.
- `500` — Downstream system error.

---

[API](https://skmtc.net/nomba/apis/vendor-api.md) · [All operations](https://skmtc.net/nomba/apis/vendor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nomba/vendor-api/revisions/41727ac9be5f/schema)