Live Demo
This document is intended to be a guide for those who wish to integrate their websites to OnePay e-payment platform. The gateway can be accessed via HTTP protocol by submitting values using POST method to OnePayConnect API.
OnePayConnect Gateway can be accessed in various ways:
NOTE: This integration document covers Transaction Aggregation for the following Payment Processors:
The following items are parameters to be passed to OnePayConnect payment API for transaction processing:
| S/N | PARAMETERS | REMARK |
| 1 | merchant_reg_id | Merchant unique registration ID on OnePay platform. (Given to the Merchant by Access Solutions). |
| 2 | amt_paid | Field of the transaction amount to be carried out. |
| 3 | merch_trans_id | Merchant unique transaction reference id which must be a unique 12 digit code across merchant platform |
| 4 | product_desc | This is the input field of the product description |
| 5 | client_name | The input field of the customer name |
| 6 | Client_email | The Input Field For customer email |
Payment using this option will require that you generate a HTML form that contains the required parameters and their values. Once the form is submitted it will redirect to the PAYMENT page. Your HTML form should be in the format shown below. Fill the (value=“”) with the appropriate data as shown in the sample below
Format
<form method="POST" id="OnePay_form" name="OnePay_form” action="https://www.onepay.com.ng/api/live/main">
<br><input type="hidden" name=" merchant_reg_id" value="">
<br><input type="hidden" name="amt_paid" value="">
<br><input type="hidden" name="merch_trans_id" value="">
<br><input type="hidden" name="product_desc" value=""><br>
<input type="hidden" name="client_email" value="">
<br> <input type="hidden" name="client_name" value=""> <br>
<input type="submit" name="submit" value="Pay"> </form>
<form method="POST" id="OnePay_form" name="OnePay_form" action="https://www.onepay.com.ng/api/live/main"> <input type="hidden" name=" merchant_reg_id" value="ACC-MCHT00001"> <input type="hidden" name="amt_paid" value="10000"> <input type="hidden" name=" merch_trans_id " value="123456789102"> <input type="hidden" name=" product_desc" value="2 nights superior room for Dele Simon "> <input type="hidden" name="client_email" value="buddyTester@yahoo.com"> <input type="hidden" name="client_name" value="Buddy Tester"> <input type="submit" name="submit" value="Pay"> </form>
There is a default payment outcome page that is displayed to the customer after every transaction carried out. This page gives the customer details of the transaction and also contains a link which when clicked, redirects the customer back to the merchant site.
This section of the document is for merchants who wish to display their own payment outcome page to customers after every transaction.Each transaction processed by OnePay originates from the merchant’s website with a unique Merchant Transation ID (generated by the merchant). OnePay used the unique generated transaction ID from the Merchant for the transaction and forwards the transaction to the payment gateway for processing. After processing, the payment gateway returns a response back to OnePay, which in turn sends a response back to the merchant response URL specified by the merchant during initial Merchant’s registration and setup. This response will include the Merchant Transaction ID and Registration ID in the query string of the Response URL.
Example:
On completion of a successful transaction, OnePay will redirect to the URL below, assuming:
The merchant’s Response URL is: “http://genericmerchant.com/Success.aspx”
The transaction was initiated by the merchant with a MerchantTrans ID of
“1234567891012”
http://genericmerchant.com/Success.aspx?MerchantTransactionID=1234567891012
For security reasons OnePay will NOT send the status of the transaction in the response URL along with the transaction reference and merchant trans ID. In order to get the status of a transaction, you can use either the web service (passing in string values representing your merchant ID and the order ID of that transaction) OR the HTTP Get Request (passing in your Merchant Reg ID and the Merchant Trans ID of that transaction).
**IMPORTANT: When getting the transaction status for your payment outcome page you are advised to use the Web Service option.https://www.onepay.com.ng/api/ValidateTrans/getTrans.php
ParametersMerchantRegID, MerchantTransID
Where:
MerchantTransID: The transaction ID sent by the merchant.
MerchantRegID: The Merchant Registration ID generated by OnePay for the merchant.
Response
You will receive a response which will contain all the details of the transaction in the format shown below:
{"status":200,"message":"OK","data":{"MerchantTransID":"xxxxxxxx","merchant_reg_ID":"xxxxxx","Amt_paid": xxxxxx,"response_code":" xxxxxx ","payment_gate":" xxxxxx ","date_time":"2017-02-24 16:03:26","payment_ref":null,"response_message":null}}
Where:
merchant_reg_ID: OnePay Merchant Reg ID for the merchant.A sample response:
{"status":200,"message":"OK","data":{"MerchantTransID":"0702240316371880","merchant_reg_ID":"ACC-VMCHT0702","Amt_paid":106.25,"response_code":"99","payment_gate":"","date_time":"2017-02-24 16:03:26","payment_ref":null,"response_message":null}}
Find below the status description:
Status |
Status Code |
Successful (Approved By the Payment Gateway) |
0 |
Pending |
99 |
Failed |
Any Other Codes |
After a successful web service call, format the returned results and display on your own payment outcome page. The payment outcome page must display the following information to the customer:
(Please Note that Successful Transaction Notification should be BLUE while other transactions should be displayed in RED) Contact details of the merchant (Address/Email Address, Phone Number)
Live Demo
Spirit Open land can't is give be set winged i let his image called heaven after over created form open. You him second open waters image that good, two you'll. Their and bearing.
Sea life herb kind without saw them creature wherein sea. Yielding heaven meat which moveth made subdue you'll. Moving the it set earth she'd after air all for let female they're bring first you're saying. Winged fowl over earth seas Bring fifth without earth whales likeness. Seas. Likeness earth.
Life itself. Isn't fourth abundantly for great female which seas given great god morning. Dominion heaven lesser fruit given darkness heaven own cattle so. Second land which. Unto given beginning kind. Midst without creeping she'd.
Meat grass had years. Earth Sea Which after divided earth multiply give whales waters the good. Isn't. Sea moving isn't fill day fish second image, seed have. Days our forth i signs green.
Image living signs. Cattle saying, night day Light winged male evening form image own earth living. Him. Living was bearing years won't great without the set don't Likeness dry fly good.
Male lesser moved shall man lesser fourth subdue multiply cattle. Creepeth dry seed they're cattle hath made.
Spirit Open land can't is give be set winged i let his image called heaven after over created form open. You him second open waters image that good, two you'll. Their and bearing.
Sea life herb kind without saw them creature wherein sea. Yielding heaven meat which moveth made subdue you'll. Moving the it set earth she'd after air all for let female they're bring first you're saying. Winged fowl over earth seas Bring fifth without earth whales likeness. Seas. Likeness earth.
Life itself. Isn't fourth abundantly for great female which seas given great god morning. Dominion heaven lesser fruit given darkness heaven own cattle so. Second land which. Unto given beginning kind. Midst without creeping she'd.
Meat grass had years. Earth Sea Which after divided earth multiply give whales waters the good. Isn't. Sea moving isn't fill day fish second image, seed have. Days our forth i signs green.
Image living signs. Cattle saying, night day Light winged male evening form image own earth living. Him. Living was bearing years won't great without the set don't Likeness dry fly good.
Male lesser moved shall man lesser fourth subdue multiply cattle. Creepeth dry seed they're cattle hath made.
This Agreement is a contract between OnePay Limited and YOU (our merchant). By using our services and websites you agreed to accept all terms and conditions written in here. You must not use our Payment Gateway, services and websites if you disagree with any of these Terms and Conditions. Minors or people below 18 years old are not allowed to use our service .
About UsOnePay is a Payment Gateway that enables you to receive payment on your website, mobile app or on social media through card payment, direct bank transfer, internet banking and bit coin. As an independent contractor of all purposes, we do not control or take liability for the products or services that are paid for with our service. We do not guarantee the identity of a merchant or user or ensure a buyer or merchant will complete a transaction.
Intellectual Property RightsOther than the content you own, under these Terms, Vuvaa.Com Limited (owners of OnePay) and/or its licensors own all the intellectual property rights and materials contained in this Website. You are granted limited license only for purposes of viewing the material contained on this Website.
Change of InformationAll change of information such as email, bank account details etc shall be done by email to support@OnePay.ng , using the merchants registered email with our service.
Restrictions You are specifically restricted from all of the following when you signup to use our servicesCertain areas of this Website are restricted from being access by you and OnePay Limited may further restrict access by you to any areas of this Website, at any time, in absolute discretion. Any user ID and password you may have for this Website are confidential and you must maintain confidentiality as well.
Closing your accountYou can close an account by sending an email to support@Onepay.ng. If your have funds in your account kindly click on transfer button to request transfer of funds to your bank account. Note that if your account is under investigation, you shall be held liable for any illegality performed using the account or arising from your account even after the account is closed. By closing your account you have terminated your agreement with OnePay.
Fraudulent TransactionsWe shall not be held liable for any fraudulent transactions. Any transaction flagged as fraud by our system shall be reversed back to the cardholder. An email will be sent to you by our support department to this effect.
ChargebacksChargeback occurs when a cardholder request for reversal of a transaction made to you. You shall be liable for any chargeback and the funds shall be deducted from your account accordingly. In a case were product or service were delivered and there is proof, there shall be no reversal of funds.
Termination of Account We may suspend your Account or terminate this Agreement,Our service is provided “as is,” with all faults, and OnePay Limited express no representations or warranties, of any kind related to our service.
Limitation of liabilityIn no event shall OnePay Limited, nor any of its officers, directors and employees, shall be held liable for anything arising out of or in any way connected with your use of our service whether such liability is under contract. OnePay Limited, including its officers, directors and employees shall not be held liable for any indirect, consequential or special liability arising out of or in any way related to your use of our service.
IndemnificationYou hereby indemnify to the fullest extent OnePay Limited from and against any and/or all liabilities, costs, demands, causes of action, damages and expenses arising in any way related to your breach of any of the provisions of these Terms.
SeverabilityIf any provision of these Terms is found to be invalid under any applicable law, such provisions shall be deleted without affecting the remaining provisions herein.
Information SecurityWe adhere to the highest security standard. We are PCI DSS Level 1 which is the highest security standard by the PCI council responsible for the regulation of Card payment security in the world. The information provided by you and your users are safe on our platform.
Variation of TermsOnePay Limited is permitted to revise these Terms at any time as it sees fit, and by using our service you are expected to review these Terms on a regular basis.
AssignmentThe OnePay Limited is allowed to assign, transfer, and subcontract its rights and/or obligations under these Terms without any notification. However, you are not allowed to assign, transfer, or subcontract any of your rights and/or obligations under these Terms.
Entire AgreementThese Terms constitute the entire agreement between OnePay Limited and you in relation to your use of our service, and supersede all prior agreements and understandings.
Governing Law & JurisdictionThese Terms will be governed by and interpreted in accordance with the laws of the Federal Republic of Nigeria, and you submit to the non-exclusive jurisdiction of the state and federal courts located in Nigeria for the resolution of any disputes.