FAQ - Shopify

This section brings together the main questions about the Asaas integration with Shopify, to support the configuration and use of the solution.

Use this FAQ for questions that involve more than one Asaas App or integration behaviors that are not part of the step-by-step guide for a specific payment method.

To install or configure Boleto, Pix, or Credit Card, use the corresponding guide.

1. Can I use a single Asaas account in more than one Shopify store?

Yes. The same Asaas account can be used in more than one Shopify store.

However, each store must have its Asaas Apps installed and configured separately.

🚧
Important
Even when using the same Asaas account, the settings of each Shopify store must be configured separately.
This includes app installation, API keys, the environment used, installment settings, and settings specific to each payment method.

2. Does each payment method need its own app?

Yes. Boleto, Pix, and Credit Card use separate Apps:

Install only the payment methods you want to offer.

A payment method appears at checkout when the respective app is installed, configured, and active.

3. Can I use the same API key in all apps?

Yes. You can use the same API key in the different Shopify Apps, as long as it belongs to the correct Asaas account and is valid.

To make identification and maintenance easier, prefer keys with names that indicate where they are used.

Chave API - Shopify Boleto
Chave API - Shopify Pix
Chave API - Shopify Cartão

Separating keys is an organizational recommendation, not a requirement for the apps to work.

🚧
Attention
The API key is displayed only once, at the time it is created.
Store the key in a safe place. If it is lost, you will need to generate a new key.

See how to create and manage API keys.

4. How do Production and Sandbox work?

The Production API key is required when configuring the Shopify Apps. The Sandbox key is optional and should be provided when the store needs to run tests.

The environment used depends on Test mode:

Setting	Environment used
Test mode disabled	Production
Test mode enabled	Sandbox

To run a transaction in the Sandbox, configure a Sandbox key and enable Test mode.

🚧
Important
If Test mode is enabled but the Sandbox key has not been provided correctly, test transactions may fail.

Changing Test mode affects only new transactions. Orders or payments already processed are not migrated between environments.

5. Why are fewer installments shown than the configured limit?

For Credit Card, the number of installments displayed depends on:

the total purchase amount;
the configured maximum number of installments;
the minimum amount per installment.

Therefore, configuring up to 12 installments does not mean all of them will be displayed for every purchase.

📘
Example
If the store configures installments of up to 12x but sets a minimum amount per installment, the checkout will display only the options that meet this minimum amount.
Thus, a low-value purchase may display fewer installments than the configured maximum limit.

The settings can be changed in the Credit Card App.

Installment changes affect only new purchases. Orders, charges, and payments already processed are not recalculated.

🚧
Important
After changing the installment settings, we recommend making a test purchase to validate how the options will be displayed in the Shopify checkout.

See the Asaas Credit Card configuration.

6. Why does Credit Card show inconsistencies at checkout?

To use the Asaas Credit Card App, configure Shopify to use email only as the customer contact method.

Go to:

Settings > Checkout > Customer contact method

Select Email only.

❗️
Attention
If the store allows contact methods other than email, Credit Card payments may show inconsistencies during checkout.

See the Shopify integration general settings.

7. Do I need to register a Pix key to use Pix on Shopify?

Yes. Register a Pix key in your Asaas account at:

Pix > My Keys

❗️
Attention
If the account does not have a registered Pix key, charges may be cleared late, affecting order confirmation on Shopify.

After the Pix payment is confirmed, the order is updated according to the integration flow.

If this does not happen, confirm that:

the Pix key is registered;
the Pix App is active;
the API key is correct;
the configured environment is the expected one.

See the Asaas Pix configuration.

8. Can Boleto offer Pix as a payment option?

Yes. In some scenarios, the Asaas invoice opened by the Boleto App may also allow payment by Pix when the account has a registered Pix key.

📘
Important
If the store intends to offer Pix directly in the Shopify checkout, also use the Asaas Pix App.

Boleto and Pix remain separate Apps at checkout.

9. Why doesn't a payment method appear at checkout?

Check:

Situation	What to check
Payment method does not appear	Whether the corresponding app is installed and active
Test transaction fails	Whether `Test mode` is enabled and there is a valid Sandbox key
Pix does not confirm as expected	Whether there is a registered Pix key
Card shows inconsistencies	Whether customer contact is set to email only
Fewer installments are displayed	Whether the minimum amount per installment is restricting the options
Authentication error	Whether the key is active and belongs to the environment in use

If the problem is related to a specific payment method, see the respective installation guide before changing other store settings.

10. How do chargebacks and refunds work?

The Asaas Apps for Shopify support chargebacks and refunds according to the payment method and the flow available on Shopify or Asaas.

Completion may depend on the payment method and the required processing. Do not consider reconciliation complete just because the refund request was initiated.

When retrieving a charge through the Asaas API, consider the refund complete when the corresponding item in the refunds array returns status equal to DONE.

See how to interpret refunds.

What to validate after installing or changing an app

🚧
Attention
Before activating the operation in Production, make a test purchase to validate that the payment method appears correctly at checkout and that the order is updated after the payment is confirmed.

After an installation or a relevant change, confirm:

whether the payment method appears at checkout;
whether Production or Sandbox is configured correctly;
whether the transaction is processed;
whether the order is updated after payment;
for Credit Card, whether the installments appear as configured;
for Pix, whether the account's Pix key is registered.

Next steps

Updated 7 days ago

Did this page help you?