Skip to main content
POST
/
billing
/
v1
/
transfer-recipients
/
validate
Validate A Transfer Recipient
curl --request POST \
  --url https://sandbox-api.payfonte.com/billing/v1/transfer-recipients/validate \
  --header 'Content-Type: application/json' \
  --header 'client-id: <api-key>' \
  --header 'client-secret: <api-key>' \
  --data '
{
  "currency": "USD, NGN, XOF, XAF",
  "country": "US, NG, CI, SN, CA, UK",
  "provider": "<string>",
  "account": {
    "phoneNumber": "2347012345678"
  }
}
'
{
  "data": {
    "currency": "USD, NGN, XOF, XAF",
    "country": "US, NG, CI, SN, CA, UK",
    "provider": "<string>",
    "accountLabel": "Bank Transfer | Zenith Bank | Dummy User | 0123456789",
    "account": {
      "phoneNumber": "2347012345678"
    }
  }
}

Authorizations

​
client-id
string
header
required
​
client-secret
string
header
required

Body

application/json

Validate a Transfer Recipient

​
currency
string
required

3 character currency code

Examples:

"NGN"

"USD"

"XOF"

"XAF"

​
country
string
required

2 character country code

Examples:

"NG"

"US"

"CI"

"SN"

"CA"

"UK"

​
provider
string
required

This is the provider we are validating the account against. Find full list of providers here Supported Providers

​
account
object
required

Response

201 - application/json

Transfer Recipient Successfully Validated

​
data
object