POST
/
billing
/
v1
/
disbursements
curl --request POST \
  --url https://sandbox-api.payfonte.com/billing/v1/disbursements \
  --header 'Content-Type: application/json' \
  --header 'client-id: <api-key>' \
  --header 'client-secret: <api-key>' \
  --data '{
  "reference": "<string>",
  "transferRecipientId": "6659692f019f6a143f7f90db",
  "amount": 100000,
  "narration": "Transfer of 100",
  "pin": "<string>"
}'
{
  "data": {
    "reference": "<string>",
    "amount": 100000,
    "amountPayable": 100000,
    "provider": "provider-slug",
    "currency": "NGN",
    "country": "NG",
    "status": "processing"
  }
}

Authorizations

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

Body

application/json
Request a Disbursement
​
transferRecipientId
string
required

id of a transfer recipient gotten from the response of TransferRecipient Call

Example:

"6659692f019f6a143f7f90db"

​
amount
integer
required

Amount should be in the subunit of the supported currency i.e value * 100

Example:

100000

​
reference
string

A reference code you'll generate to identify this transaction. This must be unique for every transaction. If you don't pass one, we will generate one for you.

​
narration
string
Example:

"Transfer of 100"

​
pin
string

This is your disbursement pin. This is a form of disbursement authorization. Alternative is an Authorization URL

Response

201 - application/json
Request for Disbursement Successful
​
data
object