Modules:Alipay Wechat Verystar
Contents |
Introduction
Alipay & Wechat payment integration through Verystar provider is a commercial module that allows the WebPOS to pay with Alipay and Wechat payment solutions. Specifically this module allows to:
- Show client's barcode to pay
- Let the customer scan the QR code generated
Configuration
It is needed to create a record in Verystar Configuration window and fill it with the values required. The following values were provided by Verystar so please check them and confirm if they are the proper ones.
- URL PAY: URL of Payment WS
- URL Unit Payment: URL of WS QR Generation
- URL Order Query: URL of WS Check Status
- URL Refund: URL of Refund WS
- URL Close Order: URL of Cancel Payment
- Proxy: This can be empty, set it only if a proxy is needed on the server
- Alipay Length for Barcode: Length of the Barcode to identify if it is an Alipay Barcode
- Alipay Starts With: Initial characters of Alipay Barcode
- WeChat Length for Barcode: Length of the Barcode to identify if it is an Wechat Barcode
- WeChat Starts With: Initial characters of Wechat Barcode
If more values are added on length and start fields please separate them with commas: x,y,z
Configuration per Store
There is also configuration on Organization Window:
- App Key: Configuration of Verystar Account
- App Secret: Configuration of Verystar Account
Configuration per Payment Method
Finally it should be needed to configure the payment methods with its payment providers:
Alipay
It needs to be configured as a normal payment method but in POS Terminal Type the field Payment provider has to be “Alipay Payment Provider with Verystar”. Refundable checkbox has to be selected and the field Refund provider has to be “Alipay Refund Provider”. In addition, there is a new search key: OBVER_payment.alipay that needs to be added in POS Terminal Type and POS Terminal screen.
It needs to be configured as a normal payment method but in POS Terminal Type the field Payment provider has to be “WeChat Payment Provider with Verystar”.Refundable checkbox has to be selected and the field Refund provider has to be “Wechat Refund Provider”. In addition, there is a new search key: OBVER_payment.weChat that needs to be added in POS Terminal Type and POS Terminal screen.
Mobile Payment
It needs to be configured as a normal payment method but in POS Terminal Type the field Payment provider has to be “Mobile Payment Provider with Verystar”. Refundable checkbox has to be selected and the field Refund provider has to be “Mobile Refund Provider”. In addition, there is a new search key: OBVER_payment.mobilePayment that needs to be added in POS Terminal Type and POS Terminal screen.
Preferences
Preferences for the Payment Methods
Each payment method should have a preference created in order to be active in WebPOS. They are the following:
WebPOS Alipay Payment WebPOS WeChat Payment WebPOS Mobile Payment
Configured as:
- Property: WebPOS Alipay Payment or WebPOS WeChat Payment or WebPOS Mobile Payment
- Value: Y
- Visibility: Here it can be configured if this applies to a specific organization, user or role.
Force Approval
A preference has been created in order to generate an approval when a transaction with mobile payment is forced.
WebPOS Approval to Force Mobile Payments
Configured as:
- Property: WebPOS Approval to Force Mobile Payments
- Value: Y
- Visibility Role: Role who is going to be the approver of the action
Preferences to Hide/Show Payment Methods
Alipay and Wechat can be hidden from WebPOS with the following preferences:
Show Alipay Payment Method on WebPOS Show WeChat Payment Method on WebPOS
Configured as:
- Property: Show Alipay Payment Method on WebPOS or / Show WeChat Payment Method on WebPOS
- Value: N/Y
- Visibility: Here it can be configured if this applies to a specific organization, user or role.
Functionality
Payment with Barcode (Mobile Payment)
Select Mobile Payment as Payment method and a pop up to scan the code will be shown:
Cashier scans barcode from client phone or enters the code manually and clicks OK and then the payment can be finished. System is able to identify if the transaction is from Alipay or WeChat based on the configuration provided.
Other options are clicking cancel that will close the pop up or Force. Force is the scenario where by any chance payment from the customer has been done but it is not showing in web POS (connectivity issues for instance). In this case Force will show an approval to complete transaction.
In the case of Timeout the following window will appear:
Force is the scenario mentioned above that will display an approval to complete transaction:
Check status will send the petition again and if connection is restored the cashier will be able to be complete it.
If not it will go back to the same Timeout pop up.
Cancel will close the pop up and close the order as well.
Payment with QR Code (Alipay/WeChat)
Select Alipay or WeChat to make a payment and a QR code will be displayed on the screen:
Client then will scan the QR code with his phone and transaction will be done.
Other options in the QR code pop up are clicking cancel or Force. Cancel will close the pop up and Force is the scenario where by any chance payment from the customer has been done but it is not showing in WebPOS (connectivity issues for instance). In this case Force will show an approval to complete transaction as the same as Mobile Payment.
Void Payment
It is possible to void a payment done with Mobile payment (Barcode or QR) by clicking in the X after the code has been scanned. As a result, the money will be refunded to the customer:
Refund
Select Alipay, We Chat or Mobile payment method when doing a return and a pop up will appear:
Is it possible to get the Original Out_SN from customer's phone but is is a good practice to print it on the ticket.
Force is the scenario mentioned previously where by any chance refund has been done but it is not showing in web POS (connectivity issues for instance). In this case Force will show an approval to complete transaction.
Complementary Modules
This integration can be complemented with the Self Check Out module:
http://wiki.openbravo.com/wiki/Modules:Selfcheckout