Skip to main content
POST
/
transfers
/
preview
cURL
curl --request POST \
  --url https://api.example.com/transfers/preview \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipientCountryCode": "NGA",
  "reference": "your-transfer-referencex",
  "amount": 3000,
  "customer": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "johndoe@gmail.com",
    "phoneNumber": "090123456789"
  }
}
'
{
  "success": true,
  "message": "Operation Successful",
  "data": {
    "recipientName": "bsuitetest llc",
    "reference": "your-transfer-referencex",
    "amount": 3000,
    "currencyCode": "NGN",
    "url": "<unknown>",
    "channels": [
      [
        "card"
      ]
    ]
  },
  "meta": {
    "timestamp": "2026-03-20T13:36:18Z"
  }
}

Body

application/json
recipientCountryCode
string
required
Example:

"NGA"

reference
string
required
Example:

"your-transfer-referencex"

amount
number
required
Example:

3000

customer
object
required

Response

201 - application/json

Preview created

success
boolean
Example:

true

message
string
Example:

"Operation Successful"

data
object
meta
object