Payment-method icon

Atome Redirect Component

Use the Redirect Component to handle the redirect to Atome.

On this page, you can find additional configuration for adding Atome to your Components integration.

Before you begin

Before starting your integration:

When making an Atome payment, you also need to:

  1. Collect shopper details, and specify these in your payment request. Atome uses these for risk checks.
  2. Provide information about the purchased items.
  3. Make sure you use a supported combination of country/region and currency.

API reference

Select which endpoint you're integrating:

This is the default with Components v5.0.0 or later.

Parameter Required Description
shopperName -white_check_mark- The shopper's full name.
shopperEmail -white_check_mark- The shopper's email address.
telephoneNumber -white_check_mark- The shopper's phone number.
billingAddress -white_check_mark- The postal address to be included on the invoice.
lineItems -white_check_mark- Price and product information about the purchased items.
deliveryAddress The postal address where the goods will be shipped. Optional if billingAddress and deliveryAddress are the same.

Component configuration

v5.0.0 or later

If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Atome Component:


If your integration uses an earlier version of iOS Components:

There are no configuration steps specific to Atome required for Components.

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)

For Singapore (SG)

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