Skip to main content
GET
Get transfer

Overview

Retrieves a single merchant-initiated transfer by ID for the authenticated merchant.

Authentication

string
required
Your merchant API key

Path Parameters

string
required
Transfer ID (UUID format)Example: 850e8400-e29b-41d4-a716-446655440000

Request Example

Response

string
required
Transfer ID (UUID)
string
required
Merchant-provided reference
string
required
External status: PROCESSING, SETTLED, or FAILED
string
required
Transfer rail: NGN_BANK, USD_BANK, or CRYPTO
string
required
Transfer currency (NGN, USD, SOL, or BNB)
string
required
Transfer amount in the target currency
string
required
Currency debited from the selected balance, such as USD or NGN.
string
required
Balance owner: MERCHANT or CUSTOMER.
string
required
Total removed from the selected balance, expressed in debit_currency. This already includes fee; do not add the fee again.
string
required
Fee charged for the transfer
object
Captured exchange rate snapshot (present for NGN transfers)
object
Resolved recipient details
object
Customer metadata if provided
string
required
When the transfer was created (ISO 8601)
string
When the transfer settled (ISO 8601)