General questions
What products does Antom offer?
Antom offers the following products:
Whether you can use multiple products simultaneously in the same business context depends on your contract. If contracts for multiple products have been executed, then you are allowed to use multiple products together.
What are the differences between Alipay, Alipay+, and Antom?
- Alipay: The largest third-party online payment platform in China, affiliated with Ant Group, primarily serving the Chinese market.
- Alipay+: A brand under Ant International that provides payment methods established through in-depth cooperation with Ant International, helping merchants integrate various global payment services
- Antom: The overseas acquiring service provided by Ant International for merchants.
How can I obtain the payment method logo?
Different payment methods correspond to different access ways:
- Alipay+ payment method: Refer to Brand asset to obtain the corresponding logo.
- Non-Alipay+ payment method: Contact Antom Technical Support to obtain the logo.
What is the interactive experience of each payment method?
Refer to each payment method's User experience for detailed payment processes.
How to obtain the payment result after redirecting to the payment method during payment?
After the payment is completed, you can call the inquiryPayment API to obtain the payment result. Antom also sends the asynchronous notification.
Will a notification be sent only if the payment is successful?
A notification will be sent for both successful and failed payments. You can also obtain the payment results through the inquiryPayment API.
How can I get the application installation package name of the payment method?
The application package name for the payment method is returned in the appIdentifier field of the pay API. Note that this field is only returned when the resultCode is PAYMENT_IN_PROCESS and the terminalType is APP or WAP.
Can I call the API to inquire about transactions from one year ago?
Yes, there is no time limit on transaction inquiries via the API.
Is the retry logic the same for all callback types?
Yes, the retry logic is the same for all callback types. Refer to notifyPayment for more information.
How can I get the error code of the payment method?
Antom maps the original payment method error codes to standardized error codes. You can find these codes on Antom Dashboard and in the result codes returned by the API. For more information regarding the error codes, refer to the pay API.
What parameters need to be modified when switching to live mode?
When switching from test mode to live mode, you need to update the CLIENT_ID to reflect live mode and update the keys accordingly. Ensure that the sandbox is manually removed from the API name. For example, if the API name of test mode is "/ams/sandbox/api/v1/payments/pay", then the API name of live mode is "/ams/api/v1/payments/pay".
Are there format requirements for specifying payment parameters?
Yes, some field values must adhere to specific format requirements. For example:
- The format for dateOfBirth is
YYYY_MM_DD. - businessNo must be a 10-digit business number.
- cardPasswordDigest should be a 2-digit number.
For additional information regarding the format requirements of other parameters, refer to the pay API.
How can I obtain the public key for verifying the signature during asynchronous notifications?
On Antom Dashboard, navigate to Quick start> Integration resources and tools > Antom public key.
After completing the subscription payment authorization process, why does it show that the authorization has failed when I’m redirected to the merchant page?
This failure can occur for two possible reasons:
- The subscriptionExpiryTime value in the create API for subscription payment is earlier than the current authorization time
To avoid authorization failure, you can adjust the subscriptionExpiryTime value, and set it to after the current authorization time. Refer to the create API for more information.
- The subscription payment product has not been activated on your acquiring contract
When you log in from Antom Dashboard, the checkout and auto debit contracts are signed by default. Integration of subscription payment products is currently not supported. Contact Antom Technical Support to modify the auto debit contract to support the subscription payment.
If the authorization failure persists after checking the previous reasons, contact Antom Technical Support for further assistance.