Skip to main content
GET
Get a transaction by ID or reference
Retrieve a specific transaction by its unique ID or reference. Returns detailed information about the transaction including status, amounts, recipient details, and account details.

Authorizations

Authorization
string
header
required

JWT access token from POST /v1/auth/token/issue. Send as: Authorization: Bearer <access_token>

Path Parameters

id
string
required

Transaction ID or reference

Example:

"TXN-4DU24WAE6YIXPM5J"

Response

Transaction retrieved

id
string
required

Transfer request ID

Example:

"c17d2777-e604-45e2-b6d5-7743652eadf1"

reference
string
required

Transfer request reference

Example:

"TXN-2Z82FVYO6BW22RC7"

amount_sent
number
required

Amount to transfer

Example:

1000

source_currency
string
required

Currency code

Example:

"NGN"

amount_received
number
required

Amount that will be received

Example:

0.64

destination_currency
string
required

Destination currency code

Example:

"USDC"

rate
string
required

Exchange rate used

Example:

"1560.63"

fee
string
required

Transaction fee

Example:

"10.00"

status
enum<string>
required

Transfer status

Available options:
awaiting_payment,
expired,
payment_confirmed,
transaction_completed,
cancelled,
refunded,
failed
Example:

"awaiting_payment"

created_at
string<date-time>
required

Creation timestamp

Example:

"2024-01-15T10:30:00Z"

recipient
object
required

Recipient information

payment_account
object
required

Bank account details for NGN payment. Transfer the specified amount to this account to initiate transaction processing. A webhook notification will be sent upon successful payment receipt.

transaction_hash
string

Transaction hash after the transaction has been completed.

Example:

"0x1234567890abcdef..."

failure_reason
string

Failure reason if the transaction is canceled or fails. This field will be updated with the reason when a transaction fails.

Example:

"Insufficient funds"