Skip to main content

Fetch Collection Transaction

​
GET /v1/global-collection/mobile-money/transaction/{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/mobile-money/transaction/a822e327-4bcd-40ec-ac61-ed3622eac000 \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

​
Path parameters

​
transactionId
string
required
The transactionReference returned when the inflow was initiated.

​
Response body

​
transactionId
string
required
The unique collection transaction ID.
​
coreUserId
string
The Nomba account ID that received the collection.
​
account
string
The customer’s mobile money account (phone number).
​
status
string
required
Current status of the collection.
ValueDescription
PENDINGPayment prompt sent; awaiting customer action.
APPROVEDCustomer completed the payment successfully.
FAILEDThe collection could not be completed.
CANCELLEDThe transaction was cancelled by the customer or system.
​
amount
number
required
The collected amount.
​
currency
string
required
The currency of the collection.