Pay with E-wallet: Opay

Accept payment from customers via Opay Nigeria wallet

POST {{BASE_URL}}/partner/collection/ewallet/

This payment method requires multiple processes. Check below for the parameters required for each step.

STEP A

ewallet_name ['opay']
estep ['initialize']
pay_amount 
pay_currency
country_code 
holder_ip_address
holder_phone 
epin 
customer_ref
custom_data (optional)
pay_ext_ref (optional)

STEP A1

ewallet_name ['opay']
estep ['send_otp']
epass_ref 

STEP B

ewallet_name ['opay']
estep ['finalize_payment']
epass_ref
eotp

Parameter	Type	Description	Required
ewallet_name	string	This is the name of the e-wallet provider. The value for this is opay_ng	true
estep	string	This payment method is a two-way process. The value for the first step is initialize and the second step is finalize_payment. Also to resend OTP you will use send_otp	true
pay_amount	string	The amount the customer is required to pay.	false
pay_currency	string	Currency code (ISO 4217)	false
country_code	string	ISO 3166-1 alpha-2 code	false
holder_ip_address	string	IP Address of the customer who is paying	false
holder_phone	string	Phone number of the customer who is paying in e164 format.	false
epin	string	Customer's Opay pin.	false
customer_ref	string	The reference got from Create customer endpoint.	false
custom_data	string	Your custom data that will be returned	false
pay_ext_ref	string	Your unique reference. This can be used to fetch the payment details	false
epass_ref	string	This is passed after the initialize step	false

HEADERS

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

REQUEST

{
   "ewallet_name":"opay",
   "estep":"initialize",
   "pay_amount":"150",
   "pay_currency":"NGN",
   "country_code":"NG",
   "holder_ip_address":"192.0.2.1",
   "holder_phone":"[phone]",
   "epin":"123456",
   "holder_first_name":"John",
   "holder_last_name":"Doe",
   "customer_ref":"MC-34449119471023678325"
}

RESPONSE

INITIALIZE - 201

{
  "message": "collection initialized",
  "status": true,
  "status_code": 201,
  "epass_ref": "BNPay-m64pxm5mat1g06j9cccjxatenfpmt7"
}

OTP STEP SUCCESSFUL - 200

{
  "message": "OTP sent",
  "status": true,
  "status_code": 200,
  "epass_ref": "BNPay-m64pxm5mat1g06j9cccjxatenfpmt7"
}

FINALIZE PAYMENT - 200

{
  "message": "collection processing",
  "status": true,
  "status_code": 200,
  "epass_ref": "BNPay-m64pxm5mat1g06j9cccjxatenfpmt7"
}

BAD REQUEST - 400

{
   "message": "Payment wallet is required",
     "status": false,
     "status_code": 400
 }