Adding payment methods
After successfully integrating the Checkout Payment product and payment methods, adding a new payment method becomes a streamlined process. Minimal additional integration effort is needed, with the primary focus on the sandbox integration and production acceptance stages.
Sandbox integration
- Add payment methods to the checkout page.
Obtain logos using the provided tool. If you can't obtain logos through the tool, contact technical support for help.
2. Configure parameters and handle redirections.
a. Update payment method enumerations of the paymentMethodType field in the pay API. Refer to Payment methods to check supported enumerations for payment-method-related parameters.
b. After calling the pay API, the API response includes payment continuation URLs.
- To handle redirections correctly after you get the payment continuation URLs, follow Best practices for configuring the payment continuation URL.
- In addition, to check what type of URLs is to be returned for each payment method, see URLs returned for payment methods.
c. Pre-front solutions
Some payment methods support pre-front solutions, allowing the bank list, payment details, QR codes, or payment passwords to be displayed to buyers in advance during the payment process. This reduces the need for page redirection and enhances the buyer experience.
Check if the payment method supports the pre-front solution from Best practices for pre-front solution. If supported, it is recommended to follow the best practice to complete the integration.
3. Integrate refund APIs
- If your business does not involve refund scenarios or only processes refunds through Antom Merchant Portal, you can skip this section.
- If your business uses the refund API for refunds, refer to Summary of capabilities to check if each payment method supports refunds. For payment methods that support refunds, you can initiate refunds or get refund results by using the following methods:
Payment method | Obtain the refund result by using | |
inquiryRefund | notifyRefund | |
Alipay+ payment methods | ✔️ | ✔️ |
Other payment methods | ✔️ | ✔️ |
Production Acceptance
Perform payment and refund acceptance tests for the corresponding payment method.