USSD
Collect USSD payments from customers in Nigeria.
We recommend you read the method overview before you proceed.
Last updated 13 September 2026
Collect USSD payments from customers in Nigeria. We recommend you read the method overview before you proceed.
https://api.flutterwave.com/v3/charges?type=ussd
authorization string required
Pass your secret key as a bearer token in the request header to authorize this call
FILL IN ALL REQUIRED FIELDS
account_bank string required
This is the bank numeric code e.g 058. You can get a list of supported banks and their respective codes below.
amount int 32 required
This is the amount to be charged. Expected value is NGN
currency string required
This is the specified currency to charge in. (expected value: NGN)
email string required
This is the email address of the customer
tx_ref string required
This is a unique reference, unique to the particular transaction being carried out.
fullname string
This is the customers full name. It should include first and last name of the customer
phone_number string
This is the phone number linked to the customer's mobile money account
client_ip string
IP - Internet Protocol. This represents the current IP address of the customer carrying out the transaction
device_fingerprint string
This is the fingerprint for the device being used. It can be generated using a library on whatever platform is being used
meta object
This is used to include additional payment information
FILL IN ALL REQUIRED FIELDS
flightID string
This could be the extra information you want to pass
sideNote string
This could be any message you'd like to associate with this call
FILL IN ALL REQUIRED FIELDS
status string
message string
data object
FILL IN ALL REQUIRED FIELDS
id integer
tx_ref string
flw_ref string
device_fingerprint string
amount integer
charged_amount integer
app_fee number
merchant_fee integer
processor_response string
auth_model string
currency string
ip string
narration string
status string
payment_type string
fraud_status string
charge_type string
created_at string
account_id integer
customer object
FILL IN ALL REQUIRED FIELDS
id integer
phone_number string
name string
email string
created_at string
payment_code string
meta object
FILL IN ALL REQUIRED FIELDS
authorization object
Shell