Create a bill payment

post https://api.flutterwave.com/v3/billers/{biller_code}/items/{item_code}/payment

This document shows you how to create bill payments

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

biller_code

string

required

Defaults to BIL099

The unique identifier for the biller. This is returned as data[i].biller_code in the get billers response.

item_code

string

required

Defaults to AT099

This is the item_code returned from bills categories endpoint as data[i].item_code

Body Params

country

string

required

Defaults to NG

This is the country attached to the service being bought e.g. if service is Airtime and country is NG it means you are buying airtime in Nigeria.

customer_id

string

required

Defaults to +23490803840303

This is the customer identifier. For airtime, the value must be the customer's phone number. For DSTV, it must be the customer's smartcard number

amount

float

required

Defaults to 500

This is the amount for the service you would like to buy.

reference

string

Defaults to 9300049404444

This is a unique reference passed by the developer to identify transactions on their end

callback_url

string

Defaults to https://webhook.site/5f9a659a-11a2-4925-89cf-8a59ea6a019a

Merchant-specific URL for bill payment callbacks

Headers

Authorization

string

required

Defaults to Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X

Pass your secret key as a bearer token in the request header to authorize this call

Responses

Language


xxxxxxxxxx
14
1
curl --request POST \
2
     --url https://api.flutterwave.com/v3/billers/BIL099/items/AT099/payment \
3
     --header 'Authorization: Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X' \
4
     --header 'Content-Type: application/json' \
5
     --header 'accept: application/json' \
6
     --data '
7
{
8
  "country": "NG",
9
  "customer_id": "+23490803840303",
10
  "amount": 500,
11
  "reference": "9300049404444",
12
  "callback_url": "https://webhook.site/5f9a659a-11a2-4925-89cf-8a59ea6a019a"
13
}
14
'


xxxxxxxxxx
15
 
1
{
2
  "status": "success",
3
  "message": "Bill payment successful",
4
  "data": {
5
    "phone_number": "0025401100",
6
    "amount": 1800,
7
    "network": "DSTV Access",
8
    "code": "200",
9
    "tx_ref": "CF-FLYAPI-20240311124623867907",
10
    "reference": "247891569224",
11
    "batch_reference": null,
12
    "recharge_token": null,
13
    "fee": 100
14
  }
15
}

200200

400400