Shopify Store Credit is a refund option that credits the refunded amount directly to a customer’s Shopify account.
Store credit accumulates on the customer profile, is visible in Shopify, and can be used at checkout when the customer is logged in. This creates a smoother customer experience and removes the need to manage gift card codes.
Shopify Store Credit can be offered alongside other return outcomes such as refunds and exchanges.
Prerequisites
To ensure Shopify Store Credit works correctly, the required store credit API scopes must be added in Shopify before enabling the feature in Swap.
If the required scopes are missing, store credit cannot be issued.
Required scopes
Swap must have access to:
read_store_credit_accounts
read_store_credit_account_transactions
write_store_credit_account_transactions
How to add the scopes
If using a custom app (configured via Shopify Admin)
In Shopify Admin, go to Settings → Apps → Develop apps
Select the Swap app
Go to Configuration
Next to Admin API integration, click Edit
Select the above scopes
Click Save
If using the public Swap app
Go to Apps
Click Swap
Click Open app
Approve the permission update when prompted
Shopify will automatically grant the required scopes.
How Shopify Store Credit works
When Shopify Store Credit is enabled:
A customer can select Store Credit as their refund option in the returns portal.
The return is reviewed and approved as normal.
When the return is moved to Processing, Swap adds store credit directly to the customer’s Shopify account.
The customer can use their available store credit at checkout on future orders.
Store credit is always issued in the currency used for the original order.
Enabling Shopify Store Credit
To enable Shopify store credit, you will need to enable two settings:
In Shopify Admin
Open Settings
Click ‘Customer accounts’
Enable ‘Store credit’
In the Swap Dashboard
To enable Shopify Store Credit in the Swap Dashboard, navigate to Settings → Returns → Store credit and click the toggle to enable.
Bonus amount (optional)
You can optionally offer a bonus amount when customers choose store credit.
The bonus portion is added directly to the customer’s store credit balance.
The bonus is calculated as a percentage of the return value.
Bonus calculation follows the same logic as Shop Later bonuses.
Expiration (optional)
You can choose whether store credit expires:
No expiration date, or
Expire after a fixed number of days.
If an expiration period is set, it applies to all store credit issued going forward.
Customer experience in the returns portal
When Store Credit is enabled, customers will see Credit to my account as a refund option in the returns portal.
Important notes:
Customers can choose only one credit option. They cannot select both gift card and Store Credit.
Store Credit appears alongside other refund options.
The available credit amount is clearly shown to the customer.
What happens in Shopify
Customer profile
Once the return is processed, store credit appears on the customer’s Shopify profile:
Credit balances accumulate over time.
Customers can view their available credit when logged in.
You can also access a customers’ profile and see the credit.
Using store credit
Shopify Store Credit can only be spent by customers who are logged in to their Shopify customer account.
How store credit is displayed and applied during checkout is controlled by Shopify.
Important notes and limitations
Customers must have a Shopify customer account to receive store credit.
If a customer account cannot be found during processing, the return will require manual review.
Store credit behaviour follows Shopify’s native store credit functionality.