POST
/
billing
/
v1
/
transfer-recipients
/
validate
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": "NGN",
  "country": "NG",
  "provider": "provider-slug",
  "account": {
    "phoneNumber": "2347012345678"
  }
}'
{
  "data": {
    "currency": "NGN",
    "country": "NG",
    "provider": "provider-slug",
    "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

Example:

"NGN"

​
country
string
required

2 character country code

Example:

"NG"

​
provider
string
required

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

Example:

"provider-slug"

​
account
object
required

Response

201 - application/json
Transfer Recipient Successfully Validated
​
data
object