Get transaction details

---

GET /api/distributor/details

This GET method enables integrators to fetch detailed information about a previously created transaction.

Authentication

This endpoint requires an OAuth 2.0 Bearer Token. Pass the access_token obtained from the authentication flow in the Authorization header:

Authorization: Bearer <access_token>

Request details

Query parameters

Parameter	Type	Required	Description
transaction_id	number	✅	Unique identifier of the transaction in Keepz system.

Response details

✅ Success Response

If the request is valid, the API returns next payload:

{
  "value": {
    "transactionId": 26,
    "status": "SUCCESS",
    "statusDescription": "success",
    "amount": 1,
    "toIban": "GE34TB0000000000000000",
    "currency": "GEL",
    "paymentDescription": "string",
    "uniqueId": "3fa85f64-1011-4562-b3fc-2c963f66afa6",
    "createdAt": "2024-07-29T17:54:12.853213",
    "commissionAmount": 0.01
  }
}

Inside value object, the following parameters are available:

Parameter	Type	Description
transactionId	number	Unique identifier of the transaction in the Keepz system.
status	string	Current status of the transaction. See Transaction Status Codes.
statusDescription	string	Human-readable description of the current transaction status.
amount	number	Transaction amount.
toIban	string	Beneficiary's IBAN.
currency	string	Transaction currency. Possible values: GEL, USD, EUR.
paymentDescription	string	Narrative/payment purpose text provided during creation.
uniqueId	string (UUID v4)	Unique transaction identifier provided by the client. Ensures idempotency.
createdAt	string (ISO 8601 datetime)	Timestamp when the transaction was created.
commissionAmount	number	Commission fee applied to the transaction (if any).

❌ Error Response

If an error occurs, the API returns next payload:

{
  "message": "Incorrect credentials",
  "statusCode": 5021
}

Parameter	Type	Description
message	string	Error message. Details are provided in the dedicated section below.
statusCode	number	Error status code. Details are provided in the dedicated section below.

⚠️ Important: Make sure to include the Bearer token in the Authorization header for all requests. The transaction ID must be a valid number in the Keepz system.

Details can be found at Error Code Description.