Skip to main content

Create a payment request

You can create a payment request through a call to the Create Payment Request endpoint:

Sample Request
curl https://api.allawee.com/payment-requests
-H "Authorization: Bearer YOUR_SECRET_KEY"
-H "Content-Type: application/json"
-d '{
"method": "bank-transfer",
"options": {
"name": "string",
"bank": "providus"
},
"currency": "NGN",
"amount": 10000,
"customer": "string",
"reference": "string",
"account": "ac.2cbc123456",
"metadata": {
"key": "value"
}
}'
-X POST
Request Body ParametersRequired?Description
methodYesThe payment method, which may be bank-transfer, transfer, fx-transfer, fx-charge, billing, local-transfer.
optionsYesAn options object, which should contain a name and may optionally contain a bank for the request.
currencyYesThe payment request currency.
amountYesThe amount for the request in kobo.
customerNoThe customer code for the customer the request is related to.
referenceNoA unique reference you can use for payment requests.
accountNoThe account code for the account the request is being made against.
metadataNoYou can include any data you want associated with the request as a metadata.