Integrating via Shopify

Use this guide when you want to offer Azupay Pay by Bank as a payment method in your Shopify store.

The Shopify integration allows you to add Azupay Pay by Bank into your Shopify checkout flow so customers can pay directly from their bank account. Depending on your agreed setup, you can offer:

PayID
PayTo
or both

Overview

With the Shopify integration, your customers can choose Pay by Bank during checkout and complete payment through Azupay’s hosted payment experience.

This is best suited to merchants who want to:

add Pay by Bank to an existing Shopify storefront
offer real-time bank payments at checkout
reduce payment friction for customers
support PayID, PayTo, or both within the one checkout experience

Before you begin

Before setting up the Shopify integration, make sure:

your Shopify store is ready for onboarding
Azupay has provided your installation URL during onboarding
your agreed payment options have been confirmed with Azupay
you know whether your checkout should offer PayID, PayTo, or both

Azupay will provide your Shopify installation URL as part of onboarding, typically through a Jira Service Desk ticket.

Install the Azupay Pay by Bank app

To install Azupay Pay by Bank into your Shopify store:

Log in to your Shopify admin panel.
Paste the installation URL provided by Azupay into your browser and open it.
Select the Shopify store you want to connect.
Click Install to add Azupay Pay by Bank to your store.

Activate Azupay Pay by Bank in Shopify

Once installed, activate Azupay Pay by Bank in your Shopify payment settings:

Log in to your Shopify admin panel.
Go to Settings.
Select Payments from the left-hand menu.
Find Additional payment methods and click Add payment method.
In Search by provider, search for Azupay.
Select Azupay Pay by Bank from the results.
Turn on PayID and/or PayTo based on the payment options enabled for your business.
Click Activate.

Enable discounts (optional)

If you want to offer discounts at checkout through Azupay Pay by Bank, you’ll need to update your existing install and add the discount widget to your checkout.

This step is only required if discounts are enabled for your business. If you’re not using discounts, you can skip this section.

Azupay must configure your discount percentage before you install (or reinstall) the app. If the discount percentage has not been set up on the Azupay side, no discount will be applied at checkout, even after the Azupay Discount Banner is added. Contact Azupay support to confirm your discount is configured before continuing.
To change an existing discount percentage, contact Azupay to update the value on their side, then reinstall the app following the Reinstall the app steps below so the new percentage takes effect.

Discounts require an updated version of the Azupay Pay by Bank app. If you installed the app before discounts were available, you’ll be prompted to accept new permissions during the reinstall.

Reinstall the app

The discount feature uses new Shopify permissions that aren’t granted by older installs, so you’ll need to reinstall the app to accept them.

Log in to your Shopify admin panel.
Go to Settings and select Apps and sales channels.
Open the Azupay Pay by Bank app.
Click Open app.
When prompted, review and accept the new permissions to complete the reinstall.

Add the Azupay Discount Banner to checkout

Once the app has been reinstalled, add the discount widget to your checkout layout:

In your Shopify admin, go to Settings and select Checkout.
Find the checkout configuration you want to update and click Customize.
In the top toolbar of the checkout editor, click the Apps icon.
In the Apps panel, find Azupay Discount Banner and click the + icon to add it to the checkout.
Click Save to apply your changes.

You can position the Azupay Discount Banner anywhere in your checkout layout. We recommend placing it close to the payment method selection so customers see the available discount at the point of payment.

What your customers will see

When Azupay Pay by Bank is enabled in your Shopify checkout, the customer journey is simple:

The customer adds items to their cart.
At checkout, they enter their details and select Azupay Pay by Bank as their payment method.
They are taken to Azupay’s hosted payment experience.
Depending on your setup, they will see:
- Bank transfer with PayID
- Pay by Bank with PayTo
- or both
The customer completes payment and is returned to the Shopify order flow.

If discounts are enabled for your business and you’ve added the Azupay Discount Banner to your checkout, customers will also see the banner at checkout, and any applicable discount is applied automatically when they pay with Azupay Pay by Bank.

sequenceDiagram
    participant C as Customer
    participant S as Shopify Checkout
    participant A as Azupay Pay by Bank
    participant B as Customer Bank

    C->>S: Add items and proceed to checkout
    C->>S: Select Azupay Pay by Bank
    S->>A: Redirect to hosted payment experience
    A->>C: Show PayID, PayTo, or both
    C->>B: Complete payment
    B-->>A: Payment confirmed
    A-->>S: Return customer to order flow

Manage orders in Shopify

Orders paid with Azupay Pay by Bank appear in the Orders section of your Shopify admin, alongside your other orders.

You can manage these orders through Shopify in the same way you manage orders paid with other payment methods.

Process refunds

Refunds can be initiated from within Shopify.

To refund an order:

Open the order you want to refund.
Click Refund in the top-right corner.
Select the refund method from the dropdown.
Enter the refund amount and reason.
Click Refund to submit the refund.

For more information about refunding orders in Shopify, see Refunding orders.

FAQs

What should I do if installation fails?

Check that:

you are using the installation URL provided by Azupay
you selected the correct Shopify store
your store is ready for onboarding
the installation has not already been completed for that store

If the problem continues, contact Azupay support.

What should I do if customers are having payment issues?

Check that:

Azupay Pay by Bank is activated in Shopify
the correct payment methods are enabled for your store
your store is using the agreed PayID and/or PayTo configuration

If the issue continues, contact Azupay support with the order details so the payment can be investigated.

What should I do if refunds are not working as expected?

Check that:

the refund was initiated from the Shopify order
the order was originally paid using Azupay Pay by Bank
the refund details entered in Shopify are correct

If the issue continues, contact Azupay support with the order and refund details.

Why am I being asked to accept new permissions?

The discount feature uses new Shopify permissions that weren’t part of the original Azupay Pay by Bank app. Accepting them is required to enable discounts — no other functionality is affected.

I can’t see the Azupay Discount Banner in the Apps panel.

Check that:

you have reinstalled the app and accepted the new permissions
you are editing the correct checkout configuration
discounts have been enabled for your business by Azupay

If the banner still doesn’t appear, contact Azupay support.

The banner is added but no discount is being applied.

Check that:

the customer is paying with Azupay Pay by Bank
the discount has been configured and is active for your business
the order meets any conditions set on the discount (such as minimum amount or eligible products)

If the issue continues, contact Azupay support with the order and refund details.

Why am I being asked to accept new permissions?

The discount feature uses new Shopify permissions that weren’t part of the original Azupay Pay by Bank app. Accepting them is required to enable discounts — no other functionality is affected.

I can’t see the Azupay Discount Banner in the Apps panel.

Check that:

you have reinstalled the app and accepted the new permissions
you are editing the correct checkout configuration
discounts have been enabled for your business by Azupay

If the banner still doesn’t appear, contact Azupay support.

Need help?

If you need help with onboarding, installation, activation, or troubleshooting, contact Azupay support and include:

your Shopify store name
the affected order number, if relevant
whether the issue relates to installation, payment, or refund