Fetch Transaction

`GET /v1/global-collection/transactions/{transactionId}`

Retrieve the status of any initiated mobile money transaction. Use this endpoint to confirm whether a collection was successful, pending, or failed — keeping your records accurate and your customers informed.

curl --request GET \
  --url https://api.nomba.com/v1/global-collection/transactions/a822e327-4bcd-40ec-ac61-ed3622eac000 \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

{
  "code": "00",
  "description": "Successful",
  "data": {
    "transactionId": "a822e327-4bcd-40ec-ac61-ed3622eac000",
    "coreUserId": "xxxx-xxxx-4402-97c0-6c3824cxxxxx",
    "account": "0980802918",
    "status": "SUCCESS",
    "amount": 10.00,
    "currency": "CDF",
    "vendor": "MPESA",
    "gatewayMessage": "APPROVED",
    "gatewayCode": "Merchant credited"
  }
}

Path parameters

string

required

The transactionReference returned when the inflow was initiated.

Response body

string

required

The unique collection transaction ID.

string

The Nomba account ID that received the collection.

string

The customer’s mobile money account (phone number).

string

required

Current status of the collection.

Value	Description
`PENDING`	Payment prompt sent; awaiting the customer’s action.
`APPROVED`	The charge was approved on the customer’s mobile money network.
`SUCCESS`	The collection completed.
`FAILED`	The collection did not complete.
`PENDING_APPROVAL`	No outcome was returned within the polling window, so the collection is unresolved. It can still settle later.

number

required

The collected amount.

string

required

The currency of the collection.

string

The customer’s mobile money network, echoing the topupVendor you sent.

string

The response from the customer’s mobile money network.

string

What that word means, in plain words.

`gatewayMessage`	`gatewayCode`
`ACCEPTED`	Awaiting customer approval
`APPROVED`	Merchant credited
`DECLINED`	Payment declined

Those are the three values gatewayMessage takes. Anything else leaves gatewayCode null.

Introduction

Getting Started

Products

API Basics

Guides

Fetch Transaction

Fetch Transaction

`GET /v1/global-collection/transactions/{transactionId}`

Path parameters

Response body

Fetch Transaction

​GET /v1/global-collection/transactions/{transactionId}

​Path parameters

​Response body

`GET /v1/global-collection/transactions/{transactionId}`

Path parameters

Response body