Mobile Web Payment

The merchant's application is a mobile web page that requires payment completion on handheld terminals such as phones/tablets, please refer to the solutions provided in this section to access PayCloud payment.

Integration Description

Mobile web payment refers to merchants displaying goods or services on a mobile web page (usually opened in mobile browsers like Chrome, Safari, or the default browser of the mobile device system, and also some built-in browsers within mobile applications that can display web pages). When users select a payment method on the merchant's page, the browser automatically redirects to the PayCloud mobile web cashier to complete the payment and then redirects back to the merchant's page.

The PayCloud mobile web cashier integrates numerous banks/acquirers/third-party payment service providers' mobile web cashiers, including online bank card payments/mobile wallet account payments/mobile wallet app payments, etc.

After completing the payment, merchants can receive payment notifications from PayCloud, and they can also proactively call the order query interface to obtain the payment result. After obtaining the payment result, synchronize and update the order to complete the remaining product and service processes.

When placing an order, if no payment method (pay_method_id) is passed, users will be redirected to the PayCloud cashier's payment method selection page. Although this method can reduce the merchant's development workload, we still recommend you develop and host your own cashier page. This not only provides a consistent payment experience for users but also reduces the risk of the payment page being inaccessible due to our domain being blocked.

Important Notes

Merchants using WeChat Pay, Alipay+ must ensure that online payment permissions have been enabled when calling this interface, and the payment request is initiated from the phone's default browser or third-party browsers (not within the built-in browsers of WeChat or Alipay), otherwise, users will not be able to complete the payment normally. The H5 payment we usually refer to is this scenario.

Use Case

Development Guide

We provide a set of REST APIs, please refer to the table below. These APIs offer SDKs in several languages; visit SDK section.

API Name	Description
Mobile Web Payment Order	Submit a payment order via this API
Cancel Order	Close unpaid orders through this api and refund the user if payment has already occurred
Submit a refund request	If you submit a refund request through this API and the refund does not arrive immediately, you can call the refund inquiry API to get the progress of the refund.
Query order	Query the transaction result (consumption/pre-authorization/pre-authorization completion) of a positive transaction order through this API
Query refund	Query the transaction results of negative transaction orders (consumption cancellation/pre-authorization cancellation/consumption refund/pre-authorization completion refund) through this API
Transaction result notification	After the transaction, notify the merchant through this webhook to tell the merchant the result of the transaction

Important Notes

Alipay Payment Notes

1. pay_method_id should only pass Alipay+, not Alipay. If you only want to show Alipay without other A+ wallets like Gcash, TNG, AlipayHK, set sub_pay_method_id = Alipay.

WeChat H5 Payment Notes

1. By default, we do not enable H5 payment for you. If needed, please inform our business personnel separately. More certification materials are required for WeChat H5 payment applications, please follow Newage's prompts to submit application materials.

2. WeChat will verify your payment initiation domain, which is your web domain before redirecting to WeChat's page. This domain needs to be configured in the WeChat backend, as shown in the configuration interface. Please submit the domain you need to apply for to Newage. If you have not set the values for the pay_method_id and wechatpay_product_type parameters, and the domain name of the initiating page that WeChat detects is "Newage", then the H5 payment will fail.

3. Set pay_method_id to WeChatPay, and the parameter wechatpay_product_type to H5.

4. After passing the above parameters and configurations, you can request our API and get the return parameter pay_url. Redirect to this WeChat H5 cashier page, which will automatically initiate H5 payment.

5. If you encounter the following error, check if you have followed the steps mentioned above.