Skip to main content
GET
/
v1
/
transaction
Get transaction by ID or merchantTransactionId
curl --request GET \
  --url https://api.fingopay.io/v1/transaction \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "message": "Transaction fetched",
  "data": {
    "id": "txn_01j7b6f9p5y9h",
    "merchantTransactionId": "mtx_123",
    "processor": "mpesa",
    "processorReference": "ODI31...",
    "status": "completed",
    "type": "charge",
    "paymentMethod": "mobile_money",
    "amount": 10000,
    "chargedAmount": 10000,
    "fees": 0,
    "currency": "KES",
    "narration": "Invoice #1234",
    "chargedPhone": "+254712345678",
    "description": "<string>",
    "message": "Payment completed",
    "debitOrCredit": "credit",
    "destination": "customer_wallet",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "reference": "<string>",
    "externalReference": "<string>",
    "invoiceId": "<string>",
    "payoutId": "<string>",
    "stage": "<string>",
    "metadata": {}
  }
}
Also available as GET /v1/transactions/.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
transactionId
string
​
merchantTransactionId
string

Response

Transaction fetched

​
status
string
Example:

"success"

​
message
string
Example:

"Transaction fetched"

​
data
object
⌘I