# Shopify offsite payments app From downloading the payments app to requesting your first test payment, learn how to get started with the Checkout.com offsite payments app for Shopify. --- ## Supported features - Automatic and manual capture, void, and refund from the Shopify Admin Portal - Partial capture and partial refunds - Cards and alternative payment methods - Webhooks for up-to-date payment statuses - [Hosted Payments Page](https://www.checkout.com/docs/integrate/hosted-payments-page.md) - [3D Secure 2.0](https://www.checkout.com/docs/risk-management/3d-secure.md) - Dynamic descriptors --- ## Supported payment methods > **Information** > > To enable payment methods in your account, contact your account manager or [request support](https://dashboard.checkout.com/support/new?topic=case_account_management_and_access&issue=issue_account_changes). The Shopify offsite payments app supports the following payment methods: - Apple Pay – MENA region only - Google Pay – MENA region only - Card payments - American Express - Cartes Bancaires - Diners Club International - Discover - JCB - MADA - Mastercard - UnionPay - Visa - ACH Direct Debit - AlipayCN - AlipayHK - Alma - Bancontact - Benefit - Bizum - Dana - EPS - GCash - iDEAL - KakaoPay - Klarna - KNET - MB WAY - MobilePay - Multibanco - PayNow - Przelewy24 - QPay - SEPA Direct Debit - stc pay - Swish - Tabby - Tamara - Touch 'n Go - TrueMoney - TWINT - Vipps --- ## Before you start To connect the Checkout.com Payments App to your Shopify store, you will need your API keys: 1. Sign in to your [Dashboard](https://dashboard.checkout.com) account. 2. Create a [secret API key](https://www.checkout.com/docs/resources/api-authentication/api-keys.md) associated with a single processing channel and entity. Copy the secret value securely, because you will not be able to view the full key after it's been generated. 3. Create a public API key. > **Note** > > Creating an API Key with the _Allow any processing channel_ option enabled causes the payments to fail. --- ## Install the payments app 1. Go to the [Checkout.com Payments App listing](https://apps.shopify.com/checkout-com-payments-app) on the Shopify app store and select _Add app_. 2. You'll be redirected to your Shopify store, where you'll be prompted to install the Checkout.com Payments App. Select _Install app_. --- ## Configure the payments app After installing the app, you will need to configure it before it can be activated. Select _Manage_ to enter the app configuration and settings. 1. Under _Account Type_, select _NAS Account_. 2. Enter your API credentials. If you do not have a Production secret API key, you can reuse your sandbox secret API key and remove the `_sbox` prefix. 3. Select the payment methods you want to support. 4. Select whether you want to enable 3DS authentication. 5. Enter the billing descriptor details. 6. Select _Save_. 7. After configuring the _Account Settings_ section, go to _Apps > Webhooks_ in the menu. 8. Select _Register Webhook_ for the environments you’ll be using. 9. In the _Account Settings_ section, ensure that the _Account Not Ready_ tag has changed to _Account Ready_. ### Activate the payments app When the application has been configured and the tag has changed to _Account Ready_, you can activate the payments app: 1. Go to _Settings > Payments_. 2. In the _Supported payment methods_ section, select _Add payment methods_. 3. Select _Search by provider_ and search for _Checkout.com_. 4. Select _Checkout.com – Offsite Payments_, and activate it. 5. You'll be redirected to the _Account Settings_ page. Select _Activate Checkout.com - Offsite Payments_ at the bottom – this will enable the Checkout.com Payments App on your store. --- ## Migrate to the Checkout.com Payments App If you currently have the legacy off-site integration activated, follow these steps to migrate to the Checkout.com Payments App: 1. From the Shopify Admin Portal, go to _Settings > Payments_. 2. In the _Supported payment methods_ section, select _Add payment methods_. 3. Select _Search by provider_, choose _Checkout.com - Offsite Payments_, and select either _Activate_ or _Activate the test mode_ to simulate transactions before going live. 4. When you're ready to go live, deactivate the legacy Checkout.com off-site integration: 1. From the Shopify Admin Portal, go to _Settings > Payments_. 2. In the _Supported payment methods_ section, find the legacy Checkout.com off-site integration and select _Manage_. 3. Select _Deactivate_ to disable the integration. When you deactivate the legacy off-site integration, its payment methods are no longer displayed on the checkout page. However, you can still manage refunds and captures for orders created with the deactivated integration, via Shopify Admin Portal or the Dashboard. > **Note** > > If you uninstall the legacy off-site integration, it will not be available for use with any outstanding order returns. --- ## Test your integration 1. From the Shopify Admin Portal, go to _Settings > Payments_. 2. In the _Supported payment methods_ section, find _Checkout.com - Offsite Payments_ and select _Manage_. 3. In the _Test mode_ section, select _Enable test mode_. 4. Go to your storefront and add a product to your cart. 5. Go to your cart and proceed to checkout. 6. Enter the required billing details. We recommend using a real email address so you can receive the order confirmation. 7. Select _Continue to shipping_, then _Continue to payment_. 8. After clicking _Complete order_, you will be redirected to our Hosted Payments Page to complete the test payment. 9. Enter the following card details: - Number – `4242 4242 4242 4242` - Expiry date – Any future date - CVV – `100` 10. Select _Pay_. After completing the 3DS authentication simulator, you'll be redirected to the order confirmation page. If you entered a real email address in the billing details, you'll also receive an order confirmation email. 11. In the Shopify store admin, go to _Orders_ to confirm that the order has gone through. 12. Sign in to your Checkout.com Dashboard account. 13. Go to _Payments_. The order payment will be displayed there with a status indication, such as _AUTH_. --- ## Go live If you're happy with the outcome of your testing and want to start taking payments right away, find _Checkout.com - Offsite Payments_ in the _Supported payment methods_ section, select _Manage_ and deselect _Enable Test Mode_. You are now live with the Checkout.com Payments App.