Docs

Transfer API

Transaction status

Check the status of a transaction using either its id (SolFi's internal UUID) or its externalId (your own reference). The endpoint returns all information related to the transaction.

Method & URL

GEThttps://api.katika-bridge.com/transactions/{id}

Path parameters

ParameterTypeMandatoryDescription
idstringYesUnique identifier (UUID) or externalId of the transaction.

Example request

GET /transactions/{id}
curl -X GET "https://api.katika-bridge.com/transactions/123e4567-e89b-12d3-a456-426614174000" \
  -H "x-api-key: your_api_key_here" \
  -H "x-api-secret: your_api_secret_here"

Success response (200 OK)

The data object contains all technical and financial details of the operation.

200 OK
{
  "error": false,
  "statusCode": 200,
  "message": "Transaction details successfully retrieved",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "externalId": "uuid-string",
    "reference": "KTK-TR-882910",
    "amount": 5000,
    "currency": "XAF",
    "status": "SUCCESS",
    "description": "Payment invoice",
    "createdAt": "2026-02-02T18:49:51.234Z",
    "country": "CM",
    "walletNumber": "2376XXXXXXXX",
    "provider": "MTN_CM",
    "recipientName": "Client Name"
  }
}

Possible errors

HTTP codeDescription
400Invalid request (missing or malformed parameters)
400 / 404Authentication error — see Authentication
500Server error (internal problem during request processing)