Just like the Credit/Debit Card Payment Integration, Consuming or connecting your web apps to the OSOFTPAY Bank Branch services is very simple. The basic way is by using REST to make an HTTP POST to get OPR(OSOFTPAY REFERENCE) details and an HTTP GET to retrieve payment status. You need to know that a reference (OPR) will be generated for you to choose where to make payment. You might decide to make payment at any bank branch with this reference or use your phone USSD services. We have access also to QuickTeller, ATM Machines to facilitate payments for references generated through this method.
Note: The fields below are not all the fields available. These are the required/mandatory fields to POST OPR instructions to OSOFTPAY
|Field||Field Description||Data Type|
|MerchantNumber||This is a mandatory field that is provided by OSOFTPAY. It is used to identify the merchant placing the POST request. Note that the demonstration MerchantNumber can be obtained when you login to https://developer.osoftpay.net and create a Test Merchant||string|
|ServiceUrl||This is a mandatory field that you need to provide OSOFTPAY in your POST request to receive notification of your transaction.||url|
|CustomerName||This is a mandatory field that you need to provide OSOFTPAY in your POST request as the Name of the Customer.||string|
|ProcessedBy||This is a mandatory field that you need to provide OSOFTPAY in your POST request as an email address. Note that customers receives email notification on payments on this address. Therefore, make sure this is an email address.||string(email)|
|ItemName||This is a mandatory field that you need to provide OSOFTPAY in your POST request as the name of the Item you are generating OPR for.||string|
|Amount||This is a mandatory field that you need to provide OSOFTPAY in your POST request as the cost of the item. Please note that a fee of 1.5%+100 is attracted on each payment as commission. Therefore include the commission on your Item cost to get actual value of the Item cost.||money|
Note: The fields provided in the form above are required for a successful POST instruction to get OPR on the OSOFTPAY platform. You can customize the form to receive values as inputs depending on your development platform but make sure the name property is same as used on the sample form.
In order to experience a succesful test, you need to create a merchant on the developers portal.
Once you obtain your OPR, you are expected to take it to any bank of your choice for deposit, OR you can use USSD service to Make Payment OR use the QuickTeller to make Payment.
Here is a typical ASP.NET C# sample using HttpClient: