SinePay Payment Plugin for WooCommerce

Borrowing from SinePay Express, the SinePay Payment Plugin for WooCommerce is designed to do on-site payment processing (no redirects) using both JavaScript (JS) and PHP calls. Using only three calls: the pre-call, the payment confirmation, and final order processing, payments can be received from M-Pesa, Airtel Money, SinePay eWallet, and all other sources supported by SinePay Core Engine.

A pre-flight call is made by JS as soon as the person clicks on ‘Go to Checkout’ containing bare minimum transaction details as complete details will only be available after order placement. The pre-call returns with codes ready to be used for HTML rendering which will guide on payment making process.

On choosing SinePay as the processor, payment options will be presented, payment should be made as per one of the choices, and confirmation done by the client. A second JS call is then made to verify that the payment was made and if so, some updates are done at the server-side on the first call data. Success or failure messages are instantly returned when the ‘Confirm Payment’ button is pressed.

If the payment was successful, the internal WooCommerce ‘Place Order’ button will be automatically actioned and the final payment confirmation begins. The order details will be posted to the normal order-processing page where they will be captured for all necessary details – including SinePay’s own eShop identification tokens. These will be posted to SinePay servers for processing via PHP. At the server, the records will be re-validated and if correct, updates will be done including the internalization of the transaction as per the SinePay Core Engine (the 8-step transaction logging) automatically. A final ERROR or APPROVED message will then be returned instantly to the calling page. This result will be interpreted by the eShop resident payment gateway codes to either action the page to Success or Failure page. This ends the payment processing process.

Document Control Number: 2020/12/01

Use of 3rd Party Services

i) Before installation, it is important to know that this plugin relies on third-party services. However, the third-party so mentioned is the SinePay core engine at their severs – the providers of this plugin.
ii) By being a payment processor, just like many of its kind, it must send some transaction details to the third-party server (itself) for token generation and transaction logging.
iii)It is this transfer back and forth of data between your eShop and the SinePay servers that we would like to bring to your attention clearly and plainly.
iv) The main links to SinePay, its terms and conditions, and privacy policy are as listed:
— Home Page: https://www.sinepay.net
— Plugin Instruction page: https://sinepay.net/INSTRUCTIONS/payment-gateway-plugin.php
— Terms and Conditions: https://www.sinepay.net/tou.php
— Privacy: https://www.sinepay.net/privacy.php
v) Also, as will be seen in the installation instruction section, you will be required to have the SinePay mobile app from Google Play store so as to get the eWallet ID and other credentials;
vi) The data taken from your eShop are strictly the transaction details including buyer contacts for payment-receipt sending as well as other transaction notices;
v) The above records, the transaction details, are not treated as belonging to SinePay and are never used for any other purposes a part from the notices mentioned;
vi) But the records you use when registering your mobile app or the eShop are treated as per the privacy policy and the terms-of-usage.
vii)The external files referenced by this plugin, due to WordPress policy recommendations, are all include in the plugin directory. However, as already mentioned, external calls will be made to the following links:
– public/woocommerce/sipn.php ;token generation
– public/woocommerce/expresspaycheck.php ;payment confirmation
– woocommerce/sipnexpress.php ;final order confirmation and transaction logging
viii)We hope this clearly puts you in the know about the third-party services included in this plugin.