Skip to main content

Initiate Payment

This endpoint processes payments utilizing funds from a customer's wallet.

URL: https://developer-sandbox.accessbankplc.com/virtualpayapi/MakePayment

Method: POST

Request Parameters

TypeNameParameter RequiredDescription
stringchannel_codeRequiredClient application code
stringdebit_merchant_idRequiredID of merchant
stringdebit_customer_idRequiredUnique ID for customer on client system
stringcredit_accountRequiredBank account to be credited
stringcredit_bank_codeRequiredCBN bank code of account to be credited
stringdebit_virtual_accountRequiredVirtual account number or wallet ID
stringtransaction_amountRequiredTransaction amount
stringtransaction_narrationTransaction narration
stringtransaction_referenceRequiredUnique transaction reference

Sample Request

{
"debit_merchant_id": "YOUR MERCHANT ID",
"debit_customer_id": "07032755966",
"credit_account": "2085868519",
"credit_bank_code": "033",
"debit_virtual_account": "1444484348",
"transaction_amount": 200,
"transaction_narration": "Testing",
"transaction_reference": "BRZ12337GDUJEDU8378W5",
"channel_code": "YOUR CHANNEL CODE"
}

Sample Response

{
"response_code": "00",
"response_message": "Successful Request",
"payment_reference": "VPTU567UYGBNHYRE4567"
}