{"title":"Atome for API only","category":"default","creationDate":1776961628,"content":"<p>You can add Atome to your existing integration. The following instructions show only what you must add to your integration specifically for Atome.<\/p>\n<p>If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.<\/p>\n<h2>Requirements<\/h2>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that you have an existing <a href=\"\/pt\/online-payments\/build-your-integration\/advanced-flow\/?platform=Web&amp;integration=API%20only\">API-only integration<\/a>.<\/td>\n<td> <\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Action handling<\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that your existing integration is set up to <a href=\"\/pt\/online-payments\/build-your-integration\/advanced-flow\/?platform=Web&amp;integration=API%20only#additional-action\">handle the additional action<\/a>. <br> <code>action.type<\/code>: <span translate=\"no\"><strong>redirect<\/strong><\/span>.<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\"> Before you begin, <a href=\"\/pt\/payment-methods\/add-payment-methods\">add Atome in your Customer Area<\/a>. <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<ol>\n<li>The shopper selects Atome as the payment method.<\/li>\n<li>The shopper enters their details in the <a href=\"#build-your-payment-form\">payment form that you build<\/a>.<\/li>\n<li>When you make the payment request, you <a href=\"#additional-parameters-payments\">include additional information about the items that the shopper intends to purchase<\/a>.<\/li>\n<li>Atome starts the repayment period for the shopper.<\/li>\n<\/ol>\n<h2 id=\"build-your-payment-form\">Build your payment form<\/h2>\n<p>Include fields to collect the following information from your shopper in the payment form.<\/p>\n<p>If you are using  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/paymentMethods\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentMethods<\/a> to show which payment methods are available to the shopper,<br \/>\nspecify the following combination of  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/paymentMethods\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">countryCode<\/a> and  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/paymentMethods#request-amount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount.currency<\/a>&#58;<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Country\/region<\/th>\n<th style=\"text-align: left;\"><code>countryCode<\/code><\/th>\n<th style=\"text-align: left;\"><code>amount.currency<\/code><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Malaysia<\/td>\n<td style=\"text-align: left;\"><strong>MY<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>MYR<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Singapore<\/td>\n<td style=\"text-align: left;\"><strong>SG<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>SGD<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>To perform risk checks, Atome requires you to collect the following shopper details:<\/p>\n<ul>\n<li>Shopper's full name<\/li>\n<li>Email address<\/li>\n<li>Phone number<\/li>\n<li>Billing address and delivery address<\/li>\n<\/ul>\n<div class=\"notices green\">\n<p>You can <a href=\"\/pt\/online-payments\/build-your-integration\/advanced-flow\/?platform=Web&amp;integration=API%2Bonly&amp;version=71#downloading-logos\">download the logo for Atome<\/a> to use in your form.<\/p>\n<\/div>\n<h2>Get Atome as an available payment method<\/h2>\n<p>When you make the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/paymentMethods\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/paymentMethods<\/a> to <a href=\"\/pt\/online-payments\/build-your-integration\/advanced-flow\/?platform=Web&amp;integration=API%20only#get-available-payment-methods\">get available payment methods<\/a>, specify the following so that Atome is included in the response.<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th>Values<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/paymentMethods#request-countryCode\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">countryCode<\/a><\/td>\n<td><span translate=\"no\"><strong>MY<\/strong><\/span>, <span translate=\"no\"><strong>SG<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/paymentMethods#request-amount-currency\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount.currency<\/a><\/td>\n<td><span translate=\"no\"><strong>MYR<\/strong><\/span>, <span translate=\"no\"><strong>SGD<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Example request for available payment methods'\" :id=\"'payment-methods-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/checkout-test.adyen.com\\\/v72\\\/paymentMethods \\\\\\n-H 'x-api-key: ADYEN_API_KEY' \\\\\\n-H 'idempotency-key: YOUR_IDEMPOTENCY_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST\\n-d '{\\n   \\&quot;merchantAccount\\&quot;: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n   \\&quot;countryCode\\&quot;: \\&quot;SG\\&quot;,\\n   \\&quot;amount\\&quot;: {\\n      \\&quot;currency\\&quot;: \\&quot;SGD\\&quot;,\\n\\t  \\&quot;value\\&quot;: 1000\\n   },\\n   \\&quot;shopperLocale\\&quot;: \\&quot;sg-SG\\&quot;\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v40.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.checkout.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.model.RequestOptions;\\nimport com.adyen.service.checkout.*;\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nClient client = new Client(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nAmount amount = new Amount()\\n  .currency(\\&quot;SGD\\&quot;)\\n  .value(1000L);\\n\\nPaymentMethodsRequest paymentMethodsRequest = new PaymentMethodsRequest()\\n  .amount(amount)\\n  .merchantAccount(\\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;)\\n  .countryCode(\\&quot;SG\\&quot;)\\n  .shopperLocale(\\&quot;sg-SG\\&quot;);\\n\\n\\\/\\\/ Send the request\\nPaymentsApi service = new PaymentsApi(client);\\nPaymentMethodsResponse response = service.paymentMethods(paymentMethodsRequest, new RequestOptions().idempotencyKey(\\&quot;UUID\\&quot;));&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v28.3.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\Checkout\\\\Amount;\\nuse Adyen\\\\Model\\\\Checkout\\\\PaymentMethodsRequest;\\nuse Adyen\\\\Service\\\\Checkout\\\\PaymentsApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$amount = new Amount();\\n$amount\\n  -&gt;setCurrency(\\&quot;SGD\\&quot;)\\n  -&gt;setValue(1000);\\n\\n$paymentMethodsRequest = new PaymentMethodsRequest();\\n$paymentMethodsRequest\\n  -&gt;setAmount($amount)\\n  -&gt;setMerchantAccount(\\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;)\\n  -&gt;setCountryCode(\\&quot;SG\\&quot;)\\n  -&gt;setShopperLocale(\\&quot;sg-SG\\&quot;);\\n\\n$requestOptions['idempotencyKey'] = 'UUID';\\n\\n\\\/\\\/ Send the request\\n$service = new PaymentsApi($client);\\n$response = $service-&gt;paymentMethods($paymentMethodsRequest, $requestOptions);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .NET API Library v32.2.1\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.Checkout;\\nusing Adyen.Service.Checkout;\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nAmount amount = new Amount\\n{\\n  Currency = \\&quot;SGD\\&quot;,\\n  Value = 1000\\n};\\n\\nPaymentMethodsRequest paymentMethodsRequest = new PaymentMethodsRequest\\n{\\n  Amount = amount,\\n  MerchantAccount = \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  CountryCode = \\&quot;SG\\&quot;,\\n  ShopperLocale = \\&quot;sg-SG\\&quot;\\n};\\n\\n\\\/\\\/ Send the request\\nvar service = new PaymentsService(client);\\nvar response = service.PaymentMethods(paymentMethodsRequest, requestOptions: new RequestOptions { IdempotencyKey = \\&quot;UUID\\&quot;});&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v30.0.0\\nconst { Client, CheckoutAPI } = require('@adyen\\\/api-library');\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nconst config = new Config({\\n  apiKey: \\&quot;ADYEN_API_KEY\\&quot;,\\n  environment: EnvironmentEnum.TEST\\n});\\n\\nconst client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nconst paymentMethodsRequest = {\\n  merchantAccount: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  countryCode: \\&quot;SG\\&quot;,\\n  amount: {\\n    currency: \\&quot;SGD\\&quot;,\\n    value: 1000\\n  },\\n  shopperLocale: \\&quot;sg-SG\\&quot;\\n}\\n\\n\\\/\\\/ Send the request\\nconst checkoutAPI = new CheckoutAPI(client);\\nconst response = checkoutAPI.PaymentsApi.paymentMethods(paymentMethodsRequest, { idempotencyKey: \\&quot;UUID\\&quot; });&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v21.1.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v21\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v21\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v21\\\/src\\\/checkout\\&quot;\\n)\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\namount := checkout.Amount{\\n  Currency: \\&quot;SGD\\&quot;,\\n  Value: 1000,\\n}\\n\\npaymentMethodsRequest := checkout.PaymentMethodsRequest{\\n  Amount: &amp;amount,\\n  MerchantAccount: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  CountryCode: common.PtrString(\\&quot;SG\\&quot;),\\n  ShopperLocale: common.PtrString(\\&quot;sg-SG\\&quot;),\\n}\\n\\n\\\/\\\/ Send the request\\nservice := client.Checkout()\\nreq := service.PaymentsApi.PaymentMethodsInput().IdempotencyKey(\\&quot;UUID\\&quot;).PaymentMethodsRequest(paymentMethodsRequest)\\nres, httpRes, err := service.PaymentsApi.PaymentMethods(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v14.0.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;merchantAccount\\&quot;: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  \\&quot;countryCode\\&quot;: \\&quot;SG\\&quot;,\\n  \\&quot;amount\\&quot;: {\\n    \\&quot;currency\\&quot;: \\&quot;SGD\\&quot;,\\n    \\&quot;value\\&quot;: 1000\\n  },\\n  \\&quot;shopperLocale\\&quot;: \\&quot;sg-SG\\&quot;\\n}\\n\\n# Send the request\\nresult = adyen.checkout.payments_api.payment_methods(request=json_request, idempotency_key=\\&quot;UUID\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v11.0.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :merchantAccount =&gt; 'ADYEN_MERCHANT_ACCOUNT',\\n  :countryCode =&gt; 'SG',\\n  :amount =&gt; {\\n    :currency =&gt; 'SGD',\\n    :value =&gt; 1000\\n  },\\n  :shopperLocale =&gt; 'sg-SG'\\n}\\n\\n# Send the request\\nresult = adyen.checkout.payments_api.payment_methods(request_body, headers: { 'Idempotency-Key' =&gt; 'UUID' })&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v30.0.0\\nimport { Client, CheckoutAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nconst config = new Config({\\n  apiKey: \\&quot;ADYEN_API_KEY\\&quot;,\\n  environment: EnvironmentEnum.TEST\\n});\\n\\nconst client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nconst amount: Types.checkout.Amount = {\\n  currency: \\&quot;SGD\\&quot;,\\n  value: 1000\\n};\\n\\nconst paymentMethodsRequest: Types.checkout.PaymentMethodsRequest = {\\n  amount: amount,\\n  merchantAccount: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  countryCode: \\&quot;SG\\&quot;,\\n  shopperLocale: \\&quot;sg-SG\\&quot;\\n};\\n\\n\\\/\\\/ Send the request\\nconst checkoutAPI = new CheckoutAPI(client);\\nconst response = checkoutAPI.PaymentsApi.paymentMethods(paymentMethodsRequest, { idempotencyKey: \\&quot;UUID\\&quot; });&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Example response with Atome available'\" :id=\"'payment-methods-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"paymentMethods\\\": [\\n        {\\n            \\\"name\\\": \\\"Atome\\\",\\n            \\\"type\\\": \\\"atome\\\"\\n        }\\n    ]\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"additional-parameters-payments\">Add additional parameters to your \/payments request<\/h2>\n<p>When you <a href=\"\/pt\/online-payments\/build-your-integration\/advanced-flow\/?platform=Web&amp;integration=API%20only#make-a-payment\">make a payment<\/a>, add the following parameters:<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th>Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-paymentMethod\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">paymentMethod.type<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td><strong>atome<\/strong><\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-shopperName\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">shopperName<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The shopper's full name.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-shopperEmail\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">shopperEmail<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The shopper's email address.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-telephoneNumber\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">telephoneNumber<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The shopper's phone number.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-billingAddress\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">billingAddress<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>The postal address to be included on the invoice.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-lineItems\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">lineItems<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>Price and product information about the purchased items.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-deliveryAddress\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">deliveryAddress<\/a><\/td>\n<td><\/td>\n<td>The postal address where the goods will be shipped. Optional if <code>billingAddress<\/code> and <code>deliveryAddress<\/code> are the same.<\/td>\n<\/tr>\n<tr>\n<td> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-countryCode\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">countryCode<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td>For Malaysia set to <strong>MY<\/strong>, for Singapore set to <strong>SG<\/strong>. Make sure that you use a supported combination of country\/region and currency: <strong>MY<\/strong> with <strong>MYR<\/strong>, and <strong>SG<\/strong> with <strong>SGD<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Example payment request for Atome'\" :id=\"'payments-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/checkout-test.adyen.com\\\/v72\\\/payments \\\\\\n-H 'x-API-key: ADYEN_API_KEY' \\\\\\n-H 'idempotency-key: YOUR_IDEMPOTENCY_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST\\n-d '{\\n  \\&quot;amount\\&quot;:{\\n    \\&quot;currency\\&quot;:\\&quot;SGD\\&quot;,\\n    \\&quot;value\\&quot;:1000\\n  },\\n  \\&quot;paymentMethod\\&quot;:{\\n      \\&quot;type\\&quot;:\\&quot;atome\\&quot;\\n  },\\n  \\&quot;reference\\&quot;:\\&quot;YOUR_ORDER_NUMBER\\&quot;,\\n  \\&quot;returnUrl\\&quot;:\\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;,\\n  \\&quot;merchantAccount\\&quot;:\\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  \\&quot;shopperName\\&quot;:{\\n     \\&quot;firstName\\&quot;:\\&quot;Simon\\&quot;,\\n     \\&quot;lastName\\&quot;:\\&quot;Hopper\\&quot;\\n  },\\n  \\&quot;shopperEmail\\&quot;:\\&quot;s.hopper@example.com\\&quot;,\\n  \\&quot;countryCode\\&quot;:\\&quot;SG\\&quot;,\\n  \\&quot;telephoneNumber\\&quot;:\\&quot;6512345678\\&quot;,\\n  \\&quot;billingAddress\\&quot;:{\\n       \\&quot;city\\&quot;:\\&quot;Singapore\\&quot;,\\n       \\&quot;country\\&quot;:\\&quot;SG\\&quot;,\\n       \\&quot;houseNumberOrName\\&quot;:\\&quot;109\\&quot;,\\n       \\&quot;postalCode\\&quot;:\\&quot;179097\\&quot;,\\n       \\&quot;stateOrProvince\\&quot;:\\&quot;Singapore\\&quot;,\\n       \\&quot;street\\&quot;:\\&quot;North Bridge Road\\&quot;\\n  },\\n  \\&quot;deliveryAddress\\&quot;:{\\n       \\&quot;city\\&quot;:\\&quot;Singapore\\&quot;,\\n       \\&quot;country\\&quot;:\\&quot;SG\\&quot;,\\n       \\&quot;houseNumberOrName\\&quot;:\\&quot;109\\&quot;,\\n       \\&quot;postalCode\\&quot;:\\&quot;179097\\&quot;,\\n       \\&quot;stateOrProvince\\&quot;:\\&quot;Singapore\\&quot;,\\n       \\&quot;street\\&quot;:\\&quot;North Bridge Road\\&quot;\\n  },\\n  \\&quot;lineItems\\&quot;:[\\n       {\\n          \\&quot;description\\&quot;:\\&quot;Shoes\\&quot;,\\n          \\&quot;quantity\\&quot;:\\&quot;1\\&quot;,\\n          \\&quot;amountIncludingTax\\&quot;:\\&quot;400\\&quot;,\\n          \\&quot;amountExcludingTax\\&quot;: \\&quot;331\\&quot;,\\n          \\&quot;taxAmount\\&quot;: \\&quot;69\\&quot;,\\n          \\&quot;id\\&quot;:\\&quot;Item #1\\&quot;\\n       },\\n       {\\n          \\&quot;description\\&quot;:\\&quot;Socks\\&quot;,\\n          \\&quot;quantity\\&quot;:\\&quot;2\\&quot;,\\n          \\&quot;amountIncludingTax\\&quot;:\\&quot;300\\&quot;,\\n          \\&quot;amountExcludingTax\\&quot;: \\&quot;248\\&quot;,\\n          \\&quot;taxAmount\\&quot;: \\&quot;52\\&quot;,\\n          \\&quot;id\\&quot;:\\&quot;Item #2\\&quot;\\n       }\\n  ]\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v41.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.checkout.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.model.RequestOptions;\\nimport com.adyen.service.checkout.*;\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nClient client = new Client(\\&quot;ADYEN_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nLineItem lineItem1 = new LineItem()\\n  .quantity(1L)\\n  .amountExcludingTax(331L)\\n  .description(\\&quot;Shoes\\&quot;)\\n  .id(\\&quot;Item #1\\&quot;)\\n  .amountIncludingTax(400L)\\n  .taxAmount(69L);\\n\\nLineItem lineItem2 = new LineItem()\\n  .quantity(2L)\\n  .amountExcludingTax(248L)\\n  .description(\\&quot;Socks\\&quot;)\\n  .id(\\&quot;Item #2\\&quot;)\\n  .amountIncludingTax(300L)\\n  .taxAmount(52L);\\n\\nAmount amount = new Amount()\\n  .currency(\\&quot;SGD\\&quot;)\\n  .value(1000L);\\n\\nShopperName shopperName = new ShopperName()\\n  .firstName(\\&quot;Simon\\&quot;)\\n  .lastName(\\&quot;Hopper\\&quot;);\\n\\nDeliveryAddress deliveryAddress = new DeliveryAddress()\\n  .country(\\&quot;SG\\&quot;)\\n  .stateOrProvince(\\&quot;Singapore\\&quot;)\\n  .city(\\&quot;Singapore\\&quot;)\\n  .houseNumberOrName(\\&quot;109\\&quot;)\\n  .street(\\&quot;North Bridge Road\\&quot;)\\n  .postalCode(\\&quot;179097\\&quot;);\\n\\nPaymentDetails paymentDetails = new PaymentDetails()\\n  .type(PaymentDetails.TypeEnum.ATOME);\\n\\nBillingAddress billingAddress = new BillingAddress()\\n  .country(\\&quot;SG\\&quot;)\\n  .stateOrProvince(\\&quot;Singapore\\&quot;)\\n  .city(\\&quot;Singapore\\&quot;)\\n  .houseNumberOrName(\\&quot;109\\&quot;)\\n  .street(\\&quot;North Bridge Road\\&quot;)\\n  .postalCode(\\&quot;179097\\&quot;);\\n\\nPaymentRequest paymentRequest = new PaymentRequest()\\n  .reference(\\&quot;YOUR_ORDER_NUMBER\\&quot;)\\n  .lineItems(Arrays.asList(lineItem1, lineItem2))\\n  .amount(amount)\\n  .shopperName(shopperName)\\n  .telephoneNumber(\\&quot;6512345678\\&quot;)\\n  .merchantAccount(\\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;)\\n  .deliveryAddress(deliveryAddress)\\n  .countryCode(\\&quot;SG\\&quot;)\\n  .paymentMethod(new CheckoutPaymentMethod(paymentDetails))\\n  .shopperEmail(\\&quot;s.hopper@example.com\\&quot;)\\n  .billingAddress(billingAddress)\\n  .returnUrl(\\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;);\\n\\n\\\/\\\/ Send the request\\nPaymentsApi service = new PaymentsApi(client);\\nPaymentResponse response = service.payments(paymentRequest, new RequestOptions().idempotencyKey(\\&quot;UUID\\&quot;));&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v29.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\Checkout\\\\LineItem;\\nuse Adyen\\\\Model\\\\Checkout\\\\Amount;\\nuse Adyen\\\\Model\\\\Checkout\\\\ShopperName;\\nuse Adyen\\\\Model\\\\Checkout\\\\DeliveryAddress;\\nuse Adyen\\\\Model\\\\Checkout\\\\CheckoutPaymentMethod;\\nuse Adyen\\\\Model\\\\Checkout\\\\BillingAddress;\\nuse Adyen\\\\Model\\\\Checkout\\\\PaymentRequest;\\nuse Adyen\\\\Service\\\\Checkout\\\\PaymentsApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_API_KEY\\&quot;);\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$lineItem1 = new LineItem();\\n$lineItem1\\n  -&gt;setQuantity(1)\\n  -&gt;setAmountExcludingTax(331)\\n  -&gt;setDescription(\\&quot;Shoes\\&quot;)\\n  -&gt;setId(\\&quot;Item #1\\&quot;)\\n  -&gt;setAmountIncludingTax(400)\\n  -&gt;setTaxAmount(69);\\n\\n$lineItem2 = new LineItem();\\n$lineItem2\\n  -&gt;setQuantity(2)\\n  -&gt;setAmountExcludingTax(248)\\n  -&gt;setDescription(\\&quot;Socks\\&quot;)\\n  -&gt;setId(\\&quot;Item #2\\&quot;)\\n  -&gt;setAmountIncludingTax(300)\\n  -&gt;setTaxAmount(52);\\n\\n$amount = new Amount();\\n$amount\\n  -&gt;setCurrency(\\&quot;SGD\\&quot;)\\n  -&gt;setValue(1000);\\n\\n$shopperName = new ShopperName();\\n$shopperName\\n  -&gt;setFirstName(\\&quot;Simon\\&quot;)\\n  -&gt;setLastName(\\&quot;Hopper\\&quot;);\\n\\n$deliveryAddress = new DeliveryAddress();\\n$deliveryAddress\\n  -&gt;setCountry(\\&quot;SG\\&quot;)\\n  -&gt;setStateOrProvince(\\&quot;Singapore\\&quot;)\\n  -&gt;setCity(\\&quot;Singapore\\&quot;)\\n  -&gt;setHouseNumberOrName(\\&quot;109\\&quot;)\\n  -&gt;setStreet(\\&quot;North Bridge Road\\&quot;)\\n  -&gt;setPostalCode(\\&quot;179097\\&quot;);\\n\\n$checkoutPaymentMethod = new CheckoutPaymentMethod();\\n$checkoutPaymentMethod\\n  -&gt;setType(\\&quot;atome\\&quot;);\\n\\n$billingAddress = new BillingAddress();\\n$billingAddress\\n  -&gt;setCountry(\\&quot;SG\\&quot;)\\n  -&gt;setStateOrProvince(\\&quot;Singapore\\&quot;)\\n  -&gt;setCity(\\&quot;Singapore\\&quot;)\\n  -&gt;setHouseNumberOrName(\\&quot;109\\&quot;)\\n  -&gt;setStreet(\\&quot;North Bridge Road\\&quot;)\\n  -&gt;setPostalCode(\\&quot;179097\\&quot;);\\n\\n$paymentRequest = new PaymentRequest();\\n$paymentRequest\\n  -&gt;setReference(\\&quot;YOUR_ORDER_NUMBER\\&quot;)\\n  -&gt;setLineItems(array($lineItem1, $lineItem2))\\n  -&gt;setAmount($amount)\\n  -&gt;setShopperName($shopperName)\\n  -&gt;setTelephoneNumber(\\&quot;6512345678\\&quot;)\\n  -&gt;setMerchantAccount(\\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;)\\n  -&gt;setDeliveryAddress($deliveryAddress)\\n  -&gt;setCountryCode(\\&quot;SG\\&quot;)\\n  -&gt;setPaymentMethod($checkoutPaymentMethod)\\n  -&gt;setShopperEmail(\\&quot;s.hopper@example.com\\&quot;)\\n  -&gt;setBillingAddress($billingAddress)\\n  -&gt;setReturnUrl(\\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;);\\n\\n$requestOptions['idempotencyKey'] = 'UUID';\\n\\n\\\/\\\/ Send the request\\n$service = new PaymentsApi($client);\\n$response = $service-&gt;payments($paymentRequest, $requestOptions);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v33.0.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.Checkout;\\nusing Adyen.Service.Checkout;\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nLineItem lineItem1 = new LineItem\\n{\\n  Quantity = 1,\\n  AmountExcludingTax = 331,\\n  Description = \\&quot;Shoes\\&quot;,\\n  Id = \\&quot;Item #1\\&quot;,\\n  AmountIncludingTax = 400,\\n  TaxAmount = 69\\n};\\n\\nLineItem lineItem2 = new LineItem\\n{\\n  Quantity = 2,\\n  AmountExcludingTax = 248,\\n  Description = \\&quot;Socks\\&quot;,\\n  Id = \\&quot;Item #2\\&quot;,\\n  AmountIncludingTax = 300,\\n  TaxAmount = 52\\n};\\n\\nAmount amount = new Amount\\n{\\n  Currency = \\&quot;SGD\\&quot;,\\n  Value = 1000\\n};\\n\\nShopperName shopperName = new ShopperName\\n{\\n  FirstName = \\&quot;Simon\\&quot;,\\n  LastName = \\&quot;Hopper\\&quot;\\n};\\n\\nDeliveryAddress deliveryAddress = new DeliveryAddress\\n{\\n  Country = \\&quot;SG\\&quot;,\\n  StateOrProvince = \\&quot;Singapore\\&quot;,\\n  City = \\&quot;Singapore\\&quot;,\\n  HouseNumberOrName = \\&quot;109\\&quot;,\\n  Street = \\&quot;North Bridge Road\\&quot;,\\n  PostalCode = \\&quot;179097\\&quot;\\n};\\n\\nPaymentDetails paymentDetails = new PaymentDetails\\n{\\n  Type = PaymentDetails.TypeEnum.Atome\\n};\\n\\nBillingAddress billingAddress = new BillingAddress\\n{\\n  Country = \\&quot;SG\\&quot;,\\n  StateOrProvince = \\&quot;Singapore\\&quot;,\\n  City = \\&quot;Singapore\\&quot;,\\n  HouseNumberOrName = \\&quot;109\\&quot;,\\n  Street = \\&quot;North Bridge Road\\&quot;,\\n  PostalCode = \\&quot;179097\\&quot;\\n};\\n\\nPaymentRequest paymentRequest = new PaymentRequest\\n{\\n  Reference = \\&quot;YOUR_ORDER_NUMBER\\&quot;,\\n  LineItems = new List&lt;LineItem&gt;{ lineItem1, lineItem2 },\\n  Amount = amount,\\n  ShopperName = shopperName,\\n  TelephoneNumber = \\&quot;6512345678\\&quot;,\\n  MerchantAccount = \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  DeliveryAddress = deliveryAddress,\\n  CountryCode = \\&quot;SG\\&quot;,\\n  PaymentMethod = new CheckoutPaymentMethod(paymentDetails),\\n  ShopperEmail = \\&quot;s.hopper@example.com\\&quot;,\\n  BillingAddress = billingAddress,\\n  ReturnUrl = \\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;\\n};\\n\\n\\\/\\\/ Send the request\\nvar service = new PaymentsService(client);\\nvar response = service.Payments(paymentRequest, requestOptions: new RequestOptions { IdempotencyKey = \\&quot;UUID\\&quot;});&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v30.1.0\\nconst { Client, CheckoutAPI } = require('@adyen\\\/api-library');\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nconst config = new Config({\\n  apiKey: \\&quot;ADYEN_API_KEY\\&quot;,\\n  environment: EnvironmentEnum.TEST\\n});\\n\\nconst client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nconst paymentRequest = {\\n  amount: {\\n    currency: \\&quot;SGD\\&quot;,\\n    value: 1000\\n  },\\n  paymentMethod: {\\n    type: \\&quot;atome\\&quot;\\n  },\\n  reference: \\&quot;YOUR_ORDER_NUMBER\\&quot;,\\n  returnUrl: \\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;,\\n  merchantAccount: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  shopperName: {\\n    firstName: \\&quot;Simon\\&quot;,\\n    lastName: \\&quot;Hopper\\&quot;\\n  },\\n  shopperEmail: \\&quot;s.hopper@example.com\\&quot;,\\n  countryCode: \\&quot;SG\\&quot;,\\n  telephoneNumber: \\&quot;6512345678\\&quot;,\\n  billingAddress: {\\n    city: \\&quot;Singapore\\&quot;,\\n    country: \\&quot;SG\\&quot;,\\n    houseNumberOrName: \\&quot;109\\&quot;,\\n    postalCode: \\&quot;179097\\&quot;,\\n    stateOrProvince: \\&quot;Singapore\\&quot;,\\n    street: \\&quot;North Bridge Road\\&quot;\\n  },\\n  deliveryAddress: {\\n    city: \\&quot;Singapore\\&quot;,\\n    country: \\&quot;SG\\&quot;,\\n    houseNumberOrName: \\&quot;109\\&quot;,\\n    postalCode: \\&quot;179097\\&quot;,\\n    stateOrProvince: \\&quot;Singapore\\&quot;,\\n    street: \\&quot;North Bridge Road\\&quot;\\n  },\\n  lineItems: [ {\\n    description: \\&quot;Shoes\\&quot;,\\n    quantity: \\&quot;1\\&quot;,\\n    amountIncludingTax: \\&quot;400\\&quot;,\\n    amountExcludingTax: \\&quot;331\\&quot;,\\n    taxAmount: \\&quot;69\\&quot;,\\n    id: \\&quot;Item #1\\&quot;\\n  }, {\\n    description: \\&quot;Socks\\&quot;,\\n    quantity: \\&quot;2\\&quot;,\\n    amountIncludingTax: \\&quot;300\\&quot;,\\n    amountExcludingTax: \\&quot;248\\&quot;,\\n    taxAmount: \\&quot;52\\&quot;,\\n    id: \\&quot;Item #2\\&quot;\\n  } ]\\n}\\n\\n\\\/\\\/ Send the request\\nconst checkoutAPI = new CheckoutAPI(client);\\nconst response = checkoutAPI.PaymentsApi.payments(paymentRequest, { idempotencyKey: \\&quot;UUID\\&quot; });&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v21.1.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v21\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v21\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v21\\\/src\\\/checkout\\&quot;\\n)\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\nlineItem1 := checkout.LineItem{\\n  Quantity: common.PtrInt64(1),\\n  AmountExcludingTax: common.PtrInt64(331),\\n  Description: common.PtrString(\\&quot;Shoes\\&quot;),\\n  Id: common.PtrString(\\&quot;Item #1\\&quot;),\\n  AmountIncludingTax: common.PtrInt64(400),\\n  TaxAmount: common.PtrInt64(69),\\n}\\n\\nlineItem2 := checkout.LineItem{\\n  Quantity: common.PtrInt64(2),\\n  AmountExcludingTax: common.PtrInt64(248),\\n  Description: common.PtrString(\\&quot;Socks\\&quot;),\\n  Id: common.PtrString(\\&quot;Item #2\\&quot;),\\n  AmountIncludingTax: common.PtrInt64(300),\\n  TaxAmount: common.PtrInt64(52),\\n}\\n\\namount := checkout.Amount{\\n  Currency: \\&quot;SGD\\&quot;,\\n  Value: 1000,\\n}\\n\\nshopperName := checkout.ShopperName{\\n  FirstName: \\&quot;Simon\\&quot;,\\n  LastName: \\&quot;Hopper\\&quot;,\\n}\\n\\ndeliveryAddress := checkout.DeliveryAddress{\\n  Country: \\&quot;SG\\&quot;,\\n  StateOrProvince: common.PtrString(\\&quot;Singapore\\&quot;),\\n  City: \\&quot;Singapore\\&quot;,\\n  HouseNumberOrName: \\&quot;109\\&quot;,\\n  Street: \\&quot;North Bridge Road\\&quot;,\\n  PostalCode: \\&quot;179097\\&quot;,\\n}\\n\\npaymentDetails := checkout.PaymentDetails{\\n  Type: common.PtrString(\\&quot;atome\\&quot;),\\n}\\n\\nbillingAddress := checkout.BillingAddress{\\n  Country: \\&quot;SG\\&quot;,\\n  StateOrProvince: common.PtrString(\\&quot;Singapore\\&quot;),\\n  City: \\&quot;Singapore\\&quot;,\\n  HouseNumberOrName: \\&quot;109\\&quot;,\\n  Street: \\&quot;North Bridge Road\\&quot;,\\n  PostalCode: \\&quot;179097\\&quot;,\\n}\\n\\npaymentRequest := checkout.PaymentRequest{\\n  Reference: \\&quot;YOUR_ORDER_NUMBER\\&quot;,\\n  LineItems: []checkout.LineItem{\\n      lineItem1, lineItem2,\\n  },\\n  Amount: amount,\\n  ShopperName: &amp;shopperName,\\n  TelephoneNumber: common.PtrString(\\&quot;6512345678\\&quot;),\\n  MerchantAccount: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  DeliveryAddress: &amp;deliveryAddress,\\n  CountryCode: common.PtrString(\\&quot;SG\\&quot;),\\n  PaymentMethod: checkout.PaymentDetailsAsCheckoutPaymentMethod(&amp;paymentDetails),\\n  ShopperEmail: common.PtrString(\\&quot;s.hopper@example.com\\&quot;),\\n  BillingAddress: &amp;billingAddress,\\n  ReturnUrl: \\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;,\\n}\\n\\n\\\/\\\/ Send the request\\nservice := client.Checkout()\\nreq := service.PaymentsApi.PaymentsInput().IdempotencyKey(\\&quot;UUID\\&quot;).PaymentRequest(paymentRequest)\\nres, httpRes, err := service.PaymentsApi.Payments(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v14.0.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_API_KEY\\&quot;\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;amount\\&quot;: {\\n    \\&quot;currency\\&quot;: \\&quot;SGD\\&quot;,\\n    \\&quot;value\\&quot;: 1000\\n  },\\n  \\&quot;paymentMethod\\&quot;: {\\n    \\&quot;type\\&quot;: \\&quot;atome\\&quot;\\n  },\\n  \\&quot;reference\\&quot;: \\&quot;YOUR_ORDER_NUMBER\\&quot;,\\n  \\&quot;returnUrl\\&quot;: \\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;,\\n  \\&quot;merchantAccount\\&quot;: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  \\&quot;shopperName\\&quot;: {\\n    \\&quot;firstName\\&quot;: \\&quot;Simon\\&quot;,\\n    \\&quot;lastName\\&quot;: \\&quot;Hopper\\&quot;\\n  },\\n  \\&quot;shopperEmail\\&quot;: \\&quot;s.hopper@example.com\\&quot;,\\n  \\&quot;countryCode\\&quot;: \\&quot;SG\\&quot;,\\n  \\&quot;telephoneNumber\\&quot;: \\&quot;6512345678\\&quot;,\\n  \\&quot;billingAddress\\&quot;: {\\n    \\&quot;city\\&quot;: \\&quot;Singapore\\&quot;,\\n    \\&quot;country\\&quot;: \\&quot;SG\\&quot;,\\n    \\&quot;houseNumberOrName\\&quot;: \\&quot;109\\&quot;,\\n    \\&quot;postalCode\\&quot;: \\&quot;179097\\&quot;,\\n    \\&quot;stateOrProvince\\&quot;: \\&quot;Singapore\\&quot;,\\n    \\&quot;street\\&quot;: \\&quot;North Bridge Road\\&quot;\\n  },\\n  \\&quot;deliveryAddress\\&quot;: {\\n    \\&quot;city\\&quot;: \\&quot;Singapore\\&quot;,\\n    \\&quot;country\\&quot;: \\&quot;SG\\&quot;,\\n    \\&quot;houseNumberOrName\\&quot;: \\&quot;109\\&quot;,\\n    \\&quot;postalCode\\&quot;: \\&quot;179097\\&quot;,\\n    \\&quot;stateOrProvince\\&quot;: \\&quot;Singapore\\&quot;,\\n    \\&quot;street\\&quot;: \\&quot;North Bridge Road\\&quot;\\n  },\\n  \\&quot;lineItems\\&quot;: [ {\\n    \\&quot;description\\&quot;: \\&quot;Shoes\\&quot;,\\n    \\&quot;quantity\\&quot;: \\&quot;1\\&quot;,\\n    \\&quot;amountIncludingTax\\&quot;: \\&quot;400\\&quot;,\\n    \\&quot;amountExcludingTax\\&quot;: \\&quot;331\\&quot;,\\n    \\&quot;taxAmount\\&quot;: \\&quot;69\\&quot;,\\n    \\&quot;id\\&quot;: \\&quot;Item #1\\&quot;\\n  }, {\\n    \\&quot;description\\&quot;: \\&quot;Socks\\&quot;,\\n    \\&quot;quantity\\&quot;: \\&quot;2\\&quot;,\\n    \\&quot;amountIncludingTax\\&quot;: \\&quot;300\\&quot;,\\n    \\&quot;amountExcludingTax\\&quot;: \\&quot;248\\&quot;,\\n    \\&quot;taxAmount\\&quot;: \\&quot;52\\&quot;,\\n    \\&quot;id\\&quot;: \\&quot;Item #2\\&quot;\\n  } ]\\n}\\n\\n# Send the request\\nresult = adyen.checkout.payments_api.payments(request=json_request, idempotency_key=\\&quot;UUID\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v11.1.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_API_KEY'\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :amount =&gt; {\\n    :currency =&gt; 'SGD',\\n    :value =&gt; 1000\\n  },\\n  :paymentMethod =&gt; {\\n    :type =&gt; 'atome'\\n  },\\n  :reference =&gt; 'YOUR_ORDER_NUMBER',\\n  :returnUrl =&gt; 'https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..',\\n  :merchantAccount =&gt; 'ADYEN_MERCHANT_ACCOUNT',\\n  :shopperName =&gt; {\\n    :firstName =&gt; 'Simon',\\n    :lastName =&gt; 'Hopper'\\n  },\\n  :shopperEmail =&gt; 's.hopper@example.com',\\n  :countryCode =&gt; 'SG',\\n  :telephoneNumber =&gt; '6512345678',\\n  :billingAddress =&gt; {\\n    :city =&gt; 'Singapore',\\n    :country =&gt; 'SG',\\n    :houseNumberOrName =&gt; '109',\\n    :postalCode =&gt; '179097',\\n    :stateOrProvince =&gt; 'Singapore',\\n    :street =&gt; 'North Bridge Road'\\n  },\\n  :deliveryAddress =&gt; {\\n    :city =&gt; 'Singapore',\\n    :country =&gt; 'SG',\\n    :houseNumberOrName =&gt; '109',\\n    :postalCode =&gt; '179097',\\n    :stateOrProvince =&gt; 'Singapore',\\n    :street =&gt; 'North Bridge Road'\\n  },\\n  :lineItems =&gt; [ {\\n    :description =&gt; 'Shoes',\\n    :quantity =&gt; '1',\\n    :amountIncludingTax =&gt; '400',\\n    :amountExcludingTax =&gt; '331',\\n    :taxAmount =&gt; '69',\\n    :id =&gt; 'Item #1'\\n  }, {\\n    :description =&gt; 'Socks',\\n    :quantity =&gt; '2',\\n    :amountIncludingTax =&gt; '300',\\n    :amountExcludingTax =&gt; '248',\\n    :taxAmount =&gt; '52',\\n    :id =&gt; 'Item #2'\\n  } ]\\n}\\n\\n# Send the request\\nresult = adyen.checkout.payments_api.payments(request_body, headers: { 'Idempotency-Key' =&gt; 'UUID' })&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v30.1.0\\nimport { Client, CheckoutAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\n\\\/\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\nconst config = new Config({\\n  apiKey: \\&quot;ADYEN_API_KEY\\&quot;,\\n  environment: EnvironmentEnum.TEST\\n});\\n\\nconst client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nconst lineItem1: Types.checkout.LineItem = {\\n  quantity: 1,\\n  amountExcludingTax: 331,\\n  description: \\&quot;Shoes\\&quot;,\\n  id: \\&quot;Item #1\\&quot;,\\n  amountIncludingTax: 400,\\n  taxAmount: 69\\n};\\n\\nconst lineItem2: Types.checkout.LineItem = {\\n  quantity: 2,\\n  amountExcludingTax: 248,\\n  description: \\&quot;Socks\\&quot;,\\n  id: \\&quot;Item #2\\&quot;,\\n  amountIncludingTax: 300,\\n  taxAmount: 52\\n};\\n\\nconst amount: Types.checkout.Amount = {\\n  currency: \\&quot;SGD\\&quot;,\\n  value: 1000\\n};\\n\\nconst shopperName: Types.checkout.ShopperName = {\\n  firstName: \\&quot;Simon\\&quot;,\\n  lastName: \\&quot;Hopper\\&quot;\\n};\\n\\nconst deliveryAddress: Types.checkout.DeliveryAddress = {\\n  country: \\&quot;SG\\&quot;,\\n  stateOrProvince: \\&quot;Singapore\\&quot;,\\n  city: \\&quot;Singapore\\&quot;,\\n  houseNumberOrName: \\&quot;109\\&quot;,\\n  street: \\&quot;North Bridge Road\\&quot;,\\n  postalCode: \\&quot;179097\\&quot;\\n};\\n\\nconst paymentDetails: Types.checkout.PaymentDetails = {\\n  type: Types.checkout.PaymentDetails.TypeEnum.Atome\\n};\\n\\nconst billingAddress: Types.checkout.BillingAddress = {\\n  country: \\&quot;SG\\&quot;,\\n  stateOrProvince: \\&quot;Singapore\\&quot;,\\n  city: \\&quot;Singapore\\&quot;,\\n  houseNumberOrName: \\&quot;109\\&quot;,\\n  street: \\&quot;North Bridge Road\\&quot;,\\n  postalCode: \\&quot;179097\\&quot;\\n};\\n\\nconst paymentRequest: Types.checkout.PaymentRequest = {\\n  reference: \\&quot;YOUR_ORDER_NUMBER\\&quot;,\\n  lineItems: [lineItem1, lineItem2],\\n  amount: amount,\\n  shopperName: shopperName,\\n  telephoneNumber: \\&quot;6512345678\\&quot;,\\n  merchantAccount: \\&quot;ADYEN_MERCHANT_ACCOUNT\\&quot;,\\n  deliveryAddress: deliveryAddress,\\n  countryCode: \\&quot;SG\\&quot;,\\n  paymentMethod: paymentDetails,\\n  shopperEmail: \\&quot;s.hopper@example.com\\&quot;,\\n  billingAddress: billingAddress,\\n  returnUrl: \\&quot;https:\\\/\\\/your-company.com\\\/checkout?shopperOrder=12xy..\\&quot;\\n};\\n\\n\\\/\\\/ Send the request\\nconst checkoutAPI = new CheckoutAPI(client);\\nconst response = checkoutAPI.PaymentsApi.payments(paymentRequest, { idempotencyKey: \\&quot;UUID\\&quot; });&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>The response includes the <code>action.type<\/code>: <span translate=\"no\"><strong>redirect<\/strong><\/span>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Example response with an additional action'\" :id=\"'payments-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"resultCode\\\":\\\"RedirectShopper\\\",\\n    \\\"action\\\":{\\n        \\\"paymentMethodType\\\":\\\"atome\\\",\\n        \\\"method\\\":\\\"GET\\\",\\n        \\\"url\\\":\\\"https:\\\/\\\/checkoutshopper-test.adyen.com\\\/checkoutshopper\\\/checkoutPaymentRedirect?redirectData=...\\\",\\n        \\\"type\\\":\\\"redirect\\\"\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2>Refunds and cancellations<\/h2>\n<h3 id=\"partial-refunds\">Partial refunds<\/h3>\n<p>To <a href=\"\/pt\/online-payments\/refund\">partially refund<\/a> a payment, specify in your  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/(paymentPspReference)\/refunds\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments\/{paymentPspReference}\/refunds<\/a> request:<\/p>\n<ul>\n<li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/(paymentPspReference)\/refunds#request-amount\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">amount<\/a>&#58; The amount to be refunded to the shopper.<\/li>\n<\/ul>\n<h2>Test and go live<\/h2>\n<p>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.<\/p>\n<p>To test the QR code flow, download one of the following test apps:<\/p>\n<h4>For Malaysia (MY)<\/h4>\n<ul>\n<li><a href=\"https:\/\/www.pgyer.com\/vBsC\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Android app<\/a><\/li>\n<li><a href=\"https:\/\/testflight.apple.com\/join\/SPxKJdnB\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">iOS app<\/a><\/li>\n<\/ul>\n<h4>For Singapore (SG)<\/h4>\n<ul>\n<li><a href=\"https:\/\/www.pgyer.com\/m4OL\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Android app<\/a><\/li>\n<li><a href=\"https:\/\/testflight.apple.com\/join\/SPxKJdnB\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">iOS app<\/a><\/li>\n<\/ul>\n<p>You can check the status of test payments in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> &gt; <strong>Transactions<\/strong> &gt; <strong>Payments<\/strong>.<\/p>\n<p>To accept live Atome payments, you must contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to add Atome in your live Customer Area.<\/p>\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/online-payments\/build-your-integration\/advanced-flow\/?platform=Web&amp;integration=API%20only\"\n                        target=\"_self\"\n                        >\n                    API-only integration guide\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/atome\/api-only","articleFields":{"description":"Add Atome to your API-only integration.","never_cache_twig":true,"parameters":{"flow":"Advanced","integration_guide_url":"\/online-payments\/build-your-integration\/advanced-flow\/?platform=Web&integration=API%20only","payment_method":"Atome","payment_method_type":"atome","payment_method_type_capitalized":"Atome","tx_variant":"atome","tx_variant_capitalized":"Atome","country_codes":"<span translate=\"no\"><strong>MY<\/strong><\/span>, <span translate=\"no\"><strong>SG<\/strong><\/span>","currency_codes":"<span translate=\"no\"><strong>MYR<\/strong><\/span>, <span translate=\"no\"><strong>SGD<\/strong><\/span>","additional_api":"true","api_version":"none","action_type":"<span translate=\"no\"><strong>redirect<\/strong><\/span>","pm_directory":"atome","contact":"false"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/atome\/api-only","title":"Atome for API only","content":"You can add Atome to your existing integration. The following instructions show only what you must add to your integration specifically for Atome.\nIf an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.\nRequirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have an existing API-only integration.\n \n\n\nAction handling\nMake sure that your existing integration is set up to handle the additional action.  action.type: redirect.\n\n\n\nSetup steps\n Before you begin, add Atome in your Customer Area. \n\n\n\nHow it works\n\nThe shopper selects Atome as the payment method.\nThe shopper enters their details in the payment form that you build.\nWhen you make the payment request, you include additional information about the items that the shopper intends to purchase.\nAtome starts the repayment period for the shopper.\n\nBuild your payment form\nInclude fields to collect the following information from your shopper in the payment form.\nIf you are using  \/paymentMethods to show which payment methods are available to the shopper,\nspecify the following combination of  countryCode and  amount.currency&#58;\n\n\n\nCountry\/region\ncountryCode\namount.currency\n\n\n\n\nMalaysia\nMY\nMYR\n\n\nSingapore\nSG\nSGD\n\n\n\nTo perform risk checks, Atome requires you to collect the following shopper details:\n\nShopper's full name\nEmail address\nPhone number\nBilling address and delivery address\n\n\nYou can download the logo for Atome to use in your form.\n\nGet Atome as an available payment method\nWhen you make the  \/paymentMethods to get available payment methods, specify the following so that Atome is included in the response.\n\n\n\nParameter\nValues\n\n\n\n\n countryCode\nMY, SG\n\n\n amount.currency\nMYR, SGD\n\n\n\n\n    \n\n\n    \n\nAdd additional parameters to your \/payments request\nWhen you make a payment, add the following parameters:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\n paymentMethod.type\n\natome\n\n\n shopperName\n\nThe shopper's full name.\n\n\n shopperEmail\n\nThe shopper's email address.\n\n\n telephoneNumber\n\nThe shopper's phone number.\n\n\n billingAddress\n\nThe postal address to be included on the invoice.\n\n\n lineItems\n\nPrice and product information about the purchased items.\n\n\n deliveryAddress\n\nThe postal address where the goods will be shipped. Optional if billingAddress and deliveryAddress are the same.\n\n\n countryCode\n\nFor Malaysia set to MY, for Singapore set to SG. Make sure that you use a supported combination of country\/region and currency: MY with MYR, and SG with SGD.\n\n\n\n\n    \n\nThe response includes the action.type: redirect.\n\n    \n\nRefunds and cancellations\nPartial refunds\nTo partially refund a payment, specify in your  \/payments\/{paymentPspReference}\/refunds request:\n\n amount&#58; The amount to be refunded to the shopper.\n\nTest and go live\nTo 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.\nTo test the QR code flow, download one of the following test apps:\nFor Malaysia (MY)\n\nAndroid app\niOS app\n\nFor Singapore (SG)\n\nAndroid app\niOS app\n\nYou can check the status of test payments in your Customer Area &gt; Transactions &gt; Payments.\nTo accept live Atome payments, you must contact our Support Team to add Atome in your live Customer Area.\nSee also\n\n\n                    API-only integration guide\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Atome","lvl3":"Atome for API only"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/atome","lvl3":"\/pt\/payment-methods\/atome\/api-only"},"levels":4,"category":"Payment method","category_color":"green","tags":["Atome"]},"articleFiles":{"payment-methods-request.js":"<p alt=\"\">payment-methods-request.js<\/p>","payment-methods-response.json":"<p alt=\"\">payment-methods-response.json<\/p>","payments-request.js":"<p alt=\"\">payments-request.js<\/p>","payments-response.json":"<p alt=\"\">payments-response.json<\/p>"}}
