Atome Redirect Component

This page explains how to add Atome to your existing Android Components integration.

You can use our Redirect Component to handle the redirect to Atome.

Requirements

Show Atome in your payment form

Include Atome in the list of available payment methods, and collect the required shopper details:

1. Specify in your /paymentMethods request one of the following combinations of countryCode and amount.currency:

   Country/region	countryCode	amount.currency
   Malaysia	MY	MYR
   Singapore	SG	SGD

   The response contains paymentMethod.type: atome.

2. Collect the following shopper details:

   • Full name
   • Email address
   • Billing address and delivery address.
   Atome uses these information for risk checks.

   We provide an Atome logo which you can use on your payment form. For more information, refer to Downloading logos.

Make a payment

To make an Atome payment, you need to:

• Collect shopper details beforehand, and specify these in your payment request. Atome uses these for risk checks.
• Provide information about the purchased items in your payment request.

When the shopper proceeds to pay:

1. Make a /payments request from your server, specifying:

Parameter	Required	Description
paymentMethod		Set to atome.
shopperName		The shopper's full name.
shopperEmail		The shopper's email address.
telephoneNumber		The shopper's phone number.
billingAddress		The postal address to be included on the invoice.
lineItems		Price and product information about the purchased items.
returnUrl		The URL where the shopper is redirected back to after completing the payment.
deliveryAddress		The postal address where the goods will be shipped. Optional if billingAddress and deliveryAddress are the same.

In the /payments response, note the action object. This contains the information needed to redirect the shopper.

2. Pass the action object to your client app. You need this to initialize the Redirect Component.

Handle the redirect

1. Use the Redirect Component to redirect the shopper to Atome.

2. After the shopper returns to your app, make a POST /payments/details request from your server, providing:

   • details: The actionComponentData.details object from the Redirect Component.

You receive a response containing:

• resultCode: Use this to present the payment result to your shopper.
• pspReference: Our unique identifier for the transaction.

Present the payment result

Use the resultCode that you received in the /payments/details response to present the payment result to your shopper.

The resultCode values you can receive for Atome are:

If the shopper failed to return to your website or app, wait for webhooks to know the outcome of the payment:

Refunds and cancellations

Partial refunds

To partially refund a payment, specify in your /payments/{paymentPspReference}/refunds request:

• amount: The amount to be refunded to the shopper.

Test and go live

To test Atome payments, you need a test shopper account in the Atome sandbox environment. To request a test account, reach out to your Adyen contact. If you are testing in multiple countries/regions, use a different test account for each location.

To test the QR code flow, download one of the following test apps:

For Malaysia (MY)

• Android app
• iOS app

For Singapore (SG)

• Android app
• iOS app

You can check the status of test payments in your Customer Area > Transactions > Payments.

To accept live Atome payments, you must contact our Support Team to add Atome in your live Customer Area.

See also