Install Asaas Pix on Shopify

Use the Asaas Pix App to offer Pix as a payment method in the Shopify checkout.

After completing the order, the buyer is redirected to the Asaas payment page, where they can pay using the Pix QR Code or Pix Copy and Paste.

Before you start

You need:

• a Shopify store;
• an Asaas account;
• a Pix key registered in the Asaas account;
• a Production API key;
• optionally, a Sandbox account and API key for testing.

The Production key is required to configure the app. The Sandbox key is only needed to use Test mode.

See how to create and manage API keys.

1. Install the Asaas Pix App

Go to Pix - Asaas on the Shopify App Store.

With your store logged in, click Install.

On the next screen, review the permissions required for the app to work. To continue, click Install again.

2. Configure the API keys

Enter:

• Production API key: used for real transactions;
• Sandbox API key: used for testing.

Production and Sandbox have independent accounts and keys. Use the credential that matches the configured environment.

You can use the same API key in the different Asaas Apps for Shopify. To make identification and maintenance easier, prefer creating identifiable keys, for example:

Chave API Shopify Pix

3. Configure notifications

In Enable Asaas charge notifications, define whether you want to use Asaas notifications to charge the customer.

Then, click Save.

If an error occurs when saving, confirm that:

• the key is active and was copied in full;
• the key belongs to the corresponding environment;
• the account has API access.

4. Choose the environment and activate the app

Use Test mode to define which environment will process new transactions:

To use the Sandbox, provide a Sandbox key before enabling Test mode.

After defining the environment, activate the Asaas Pix App and click Save.

Expected result

The Pix option should be available among the payment methods in the Shopify checkout.

Before operating in Production, make a test purchase and confirm the payment flow and the order update.

Payment experience

After selecting Pix at checkout and clicking Pay Now, the buyer is redirected to the Asaas payment page.

Payment can be made using the Pix QR Code or Pix Copy and Paste.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Complete the purchase"] --> B["Select Pix"]
B --> C["Open the Asaas payment page"]
C --> D["Make the payment"]
D --> E["Confirm the Pix"]
E --> F["Update the order on Shopify"]
F --> G["Display the thank-you page"]

classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

class A inicio
class B,C,D,E,F validacao
class G sucesso

linkStyle default stroke:#94A3B8,stroke-width:2px

After the payment is confirmed, the order is updated according to the integration flow and the buyer is redirected to the Shopify thank-you page.

Next steps

• See the Shopify general settings
• Configure Asaas Boleto on Shopify
• Configure Asaas Credit Card on Shopify
• See the Shopify FAQ
• Test your integration in the Sandbox