Pay with Bank Transfer (Virtual account)

Accept payments from customers via bank transfer

POST {{BASE_URL}}/partner/collection/bank_transfer/

Parameter	Type	Description	Required
pay_va_step	string	This is the payment step. Some payment methods might require multiple steps but for this, it's just a step. And the default value will be direct.	true
country_code	string	ISO 3166-1 alpha-2 code.	true
pay_currency	string	Currency code (ISO 4217)	true
holder_account_type	string	The value of this could be temporary or permanent. Temporary(dynamic) account numbers are for instant usage and they expire. While permanent(static) account numbers can be used multiple times.	true
customer_ref	string	The reference got from Create customer endpoint.	true
pay_amount	number	The amount the customer is required to pay. Required only if holder_account_type is temporary	false
holder_legal_number	string	The BVN of the customer	true
bank_name	string	Use the List Payment Banks (Collections) ENDPOINT to fetch the list of supported payment banks	false
customer_name_only	boolean	The customer name will be set as the default account name if passed	false
pay_ext_ref	string	Your unique reference. This can be used to fetch the payment details.	false
custom_data	dict	Your custom data that will be returned	false
alternate_name	string	Set the account name. By default, merchant and customer names are used.	false
pay_expiry	int	This only applies to temporary (dynamic) account numbers. The value should be in days.	false

HEADERS

{
     'Authorization': 'Bearer xhscIjHgpm2ZiPjzKos4ivl4GhyZp5',
      'Content-Type': 'application/json',
      'moni-signature': 'wed332eeddrdbdbdbdbvdvdvdvvsbsvsd'
 }

REQUEST

{
   "pay_va_step":"direct",
   "country_code":"NG",
   "pay_amount":"105.24",
   "pay_currency":"NGN",
   "holder_account_type":"temporary",
   "customer_ref":"MC-DHEG123EHEH33H2H2",
   "pay_ext_ref":"12gddhetwdgedgdge"
}

RESPONSE

CREATED 201

{
  "message": "Make payment.",
  "status": true,
  "status_code": 201,
  "payment_reference": "WMPay-hfjw7rmtpazwpfrek5z3rmtszshckr",
  "holder_account_number": "7470000000",
  "holder_bank_name":"Casa Bank",
  "amount":"105.24",
  "payment_ext_reference":"12gddhetwdgedgdge",
  "account_type": "temporary",
  "account_name": "Morty Inc/Roberto Firmino",
  "custom_data": null
}

BAD REQUEST 400

 {
    "message": "Customer ref is required",
    "status": false,
    "status_code": 400
 }