Antom, leading provider of tailored payment solutions
Contact Us
Log In

Quick start

Create a smooth EasySafePay process by using Antom's payment capabilities. Antom offers client- and server-side sample code for SDK integration, to help you easily build a secure and simple payment experience.
1
Set up the server

Install the Antom Java library

Maven
To import the Antom Java library, add the dependency to your pom.xml file. You can find the latest_version on GitHub.
<dependency>
<groupId>com.alipay.global.sdk</groupId>
<artifactId>global-open-sdk-java</artifactId>
<version>{latest_version}</version>
</dependency>
GitHub
You can also download the source code directly from GitHub to install the Antom Java library.
Server

Get integration resources

Get integration resources from the Developer section in Antom Dashboard. Configure the obtained integration resources in your application and these resources are to be further used when sending requests to the Antom server.
Server

Create a payment session

Add an endpoint on your server to call the createPaymentSession API. When the buyer makes the first payment, specify the authorization information, payment method, payment amount, payment currency, payment request ID, settlement currency, order information, and other required information for this payment. Subsequent payments do not require specifying authorization information, but you need to specify the token additionally.
Server

Specify the payment redirection URL

Set the payment redirection URL, where the buyer is to be redirected after completing the payment. You can guide the buyer with further actions on this page.
Server

Receive authorization notification

After the buyer completes authorization, the Antom server sends a notification to the Notification URL you set, including authorizationNotifyType, authState, accessToken, userLoginId, etc. Save the correspondence between the information and the buyer for future password-free payments.
Server

Inquire about the payment result

Add an endpoint on your server to get the payment result by calling the inquiryPayment AP. Display the payment result when needed.
Server
2
Build a checkout page on the client

Install Antom SDK

Install the SDK resource package via CDN.
Note: Please replace
{latest_version}
in the code with the latest version.
<script src="https://sdk.marmot-cloud.com/package/ams-checkout/{latest_version}/dist/umd/ams-checkout.min.js"></script>
Note: The Antom SDK complies with PCI guidelines and guarantees that the user's payment information goes straight to Antom without passing through your server.
Client

Build the checkout page

Display the EasySafePay methods that you offer to buyers on the checkout page.
Client

Initialize and instantiate the SDK

Create the SDK instance and specify basic configurations.
Client

Get a payment session

After the buyer selects the corresponding EasySafePay method, you send the createPaymentSession request with the corresponding payment method information and get a payment session.
Client

Invoke the SDK

Invoke the SDK by using the payment session obtained. After being invoked, the SDK guides the buyer to authorize the specified payment method and complete subsequent payments.
Client

Query the payment result

After the buyer completes authorization, the Antom server processes the payment based on the previously saved payment information and redirects the buyer to the specified redirection URL. You can obtain the payment result by using the inquiryPayment API on the server-side.
Client