This topic introduces multiple best practice solutions to help you enhance product experience and payment efficiency:

• Embedded authorization QR code
• Client-side experience optimization
• Payment result display
• Payment failure retry
• API timeout settings

Embedded authorization QR code

In the standard integration solution, your buyers will be redirected to the payment method page to scan a QR code for payment authorization. However, this process can be time-consuming and may lead to buyer drop-off. Antom provides you with an embedded authorization QR code solution, which displays the authorization QR code directly on the merchant page, reducing the need for redirection and lowering buyer drop-off rates.

This solution is suitable for devices like PC browsers, gaming consoles, and smart TVs, providing a seamless authorization experience for buyers.

User experience comparison

Key differences between the standard solution and the embedded authorization QR code solution are:

• Standard solution: Buyers are redirected to the payment method page to scan the QR code.
• Embedded authorization QR code solution: Buyers scan the QR code directly on your merchant page without redirection, streamlining the process and reducing dropout risks.

Integration steps

This optimized solution follows the standard integration workflow with minor adjustments. To enable this solution, refer to Obtain authorization.

Client-side experience optimization (App only)

Antom provides the following client-side optimization methods for App integration:

• Learn how to handle disambiguation dialog boxes on Android, refer to What is a disambiguation dialog box.
• Learn how to confirm whether the buyer has installed the payment method app, refer to:

• For iOS: Method 3: Handle the redirection according to whether the payment method app is installed
• For Android: Method 3: Handle the redirection according to whether the payment method app is installed

• Learn how to allow buyers complete authorization within your app, refer to:

• For iOS: Method 2: Open the authorization URL within the application
• For Android: Method 2: Open the authorization URL within the application

Payment result display

After calling the pay (Auto Debit) API, please handle the result according to the guidance provided:

• Payment is successful: Display shipping-related content on the payment result page.
• Payment failed: Notify the buyer of payment failure, and guide the buyer to retry payment to complete the order.
• Payment is being processed: Display a loading effect and pause for 3-5 seconds, then query the server again for the payment result. If the result remains unknown (neither success nor failure), display "Order processing" or "Check final result in Order Management Center". Avoid attributing delays to network processing. Antom will notify the final payment result within 1 minute.

Payment failure retry

If a payment attempt fails and the buyer can retry payment for the same order, follow the steps below to provide a seamless experience for the buyer:

1. In the pay (Auto Debit) request, set referenceOrderId to the order ID and paymentRequestId to the payment order ID.
2. Before retrying payment for the same order, please check the order status:

• If payment is successful, display "Payment completed" to the buyer.
• If payment fails, cancel the failed payment by calling the cancel API, and initiate a new payment by calling the pay (Auto Debit) API with a new paymentRequestId.

3. Ensure only one successful payment is associated with each merchant order. If multiple successful payments are detected for a single order, call the cancel API to initiate a refund for the buyer.

API timeout settings

Antom supports direct connections to multiple payment methods. In some cases, delays in processing order of payment method APIs may prevent timely responses. If you have set API timeout, it is recommended to set it to 10 seconds. If the payment API call times out, it is recommended to wait for the asynchronous notification or call the inquiryPayment API to obtain the payment result.