Shopify is a user-friendly e-commerce platform that helps businesses create, customize, and manage online stores. It offers templates for easy website creation and a range of features, including shopping cart, store management, marketing, and SEO tools, to support your selling needs.

Follow this guideline to start integrating Xendit with your Shopify store.

Requirements

Before integrating Xendit with Shopify, ensure the following:

You have a Shopify store (no specific plan required).
You are registered with Xendit and have your User ID and Key for Shopify integration.
Remove any IP whitelist settings from your Xendit dashboard.

Installation

Follow these easy steps to start accepting payments on your Shopify store using the Xendit Payment's App

Log in to your Xendit Dashboard, and on the tab menu, open Integrations
Open the Shopify app details, and click ‘Install’ to open the Xendit Payments app
You will be redirected to the Shopify App Store, click ‘Add app’
The Xendit installation page will appear, follow the prompts to activate
You will be redirected back to the Shopify Settings, Select your supported payment channels
At the bottom of the page, click ‘Activate Xendit Payment Gateway’ in green
Installation is done

Add Payment Method in Shopify

When adding the payment provider, you just need to search for Xendit when you add the payment method in the provider list or payment method list

Please search for and select the Xendit Payment Gateway (New) from the "Search by payment method" or "Search by provider" tabs. To ensure you select the correct full integration, kindly search only for the provider name (Xendit) rather than individual channel names (such as DANA) in the search bar.

Abandoned and Pending Checkout Configuration

Unpaid orders can be set to go to pending or abandoned checkout status on the Shopify seller dashboard.

Go to the Xendit Dashboard > Integrations tab > My Integrations tab > Shopify > Settings
Change checkout flow to abandoned or pending
Click save

	Abandoned Checkout	Pending Checkouts
Unpaid Order Location	Unpaid orders show up in the abandoned checkouts tab.	Unpaid orders show up in Orders tab with a “pending” status.
Paid Order Location	Paid orders moved to Orders tab, order status “paid”	On Orders tab, Order status updates to “paid”
Stock Removal	Removed only after the order is paid. Higher chance of overselling	Removed after order placed, before order is paid. Less chance of overselling.
Shopify Customer Email Notification	Shopify confirmation Email sent to customer after order is paid.	Shopify confirmation sent to customers after order placed, but before order is paid.

Private notes

[Shopify Regional Merchant Payment Flow with Local Channels (e.g., DANA)]

Context

Some regional merchants (e.g., based in HongKong) want to accept payments from customers in other countries using local payment channels such as DANA in Indonesia.

To enable this, there are specific requirements and limitations from both Shopify and Xendit that merchants must follow.

Key Requirements

Activation for Local Channels

Merchants must be activated for the specific channel (e.g., DANA) in Xendit.

Only a limited set of local channels is available for regional accounts, since these are treated as foreign merchants.

Shopify Local Currency Setting

Shopify only allows one local currency per store.

If the merchant wants to accept payments in IDR via DANA, their Shopify default currency must be set to IDR.

If they also want to accept PHP, MYR, or other currencies, they must create separate Shopify stores for each currency.

UI vs. Checkout Currency

Shopify’s UI can display prices in multiple currencies for customer experience (e.g., HKD display on the storefront).

However, at checkout, the currency will always match the store’s default currency (in this case, IDR).

Flow example: HK merchant wants to accept DANA

Merchant setup:

Location: Hong Kong.

Xendit balance options: USD or HKD.

Shopify store default currency: IDR.

Activated for DANA channel in Xendit (regional account).

Customer experience:

Customer browses the Shopify store in HKD (display currency).

Proceeds to checkout → prices shown in IDR (default store currency). The conversion between UI currency and local currency is handled by Shopify, Xendit don't involve on this.

Payment process:

Shopify generates a Xendit Payment Link in IDR.

Customer selects DANA.

DANA payment page shows amount in IDR.

Customer pays IDR.

Settlement:

Xendit receives funds from DANA in IDR.

Xendit converts IDR to merchant’s settlement currency (USD or HKD) using Xendit’s FX rates.

This is the only FX conversion that we are able to monetization (default monetization for regional expansion)