Accept PIX

With PIX (Brazil's instant payment) active, the buyer chooses PIX on the payment step, gets a QR code and a copy-and-paste code, and pays in their banking app. The checkout detects the payment by itself and takes the buyer to the thank-you page.

Where PIX showsCopy Anchor Link

PIX shows at checkout when three conditions hold:

• The purchase is a one-time payment. Subscriptions only charge the card.
• The store has an active PIX payment flow, pointing to an active connection that accepts PIX.
• The price is in reais. PIX is a Brazilian payment method.

When you create a connection with a provider that accepts PIX, Vipter creates a PIX flow pointing to it, if the store doesn't have an active PIX flow yet. To check, open Payments›Payment flows and look for the PIX flow. To choose which account receives PIX, see Payment flows.

With card and PIX active, the buyer sees both options side by side on the payment step.

What the buyer seesCopy Anchor Link

1. On the payment step, the buyer chooses PIX. The checkout shows which tax ID the PIX will be issued to: the CPF (Brazilian individual taxpayer ID) or CNPJ (Brazilian company taxpayer ID) entered on the details step. To use another document, they correct the field above.
2. They click the button to generate the code.
3. The checkout shows the QR code, the copy-and-paste code with a copy button, and the time left before the code expires.
4. The buyer pays in their banking app. The page checks for the payment every few seconds and, once it is confirmed, moves on by itself to the post-purchase offers, if any, and to the thank-you page.

The code's expiry time is set by the provider. On Pagar.me and Mercado Pago, the code is valid for 24 hours.

If the store sends e-mails to buyers, the buyer also gets the PIX awaiting payment e-mail, with the copy-and-paste code and its expiry. That way they can pay even after closing the page. E-mails are in General›Settings›E-mails.

When the order becomes paidCopy Anchor Link

The order shows in Sales›Transactions as soon as the code is generated, with the PIX method and the Pending status. It moves to Paid when the provider confirms the payment.

The confirmation arrives through the provider's webhook. While the buyer has the page open, the checkout also asks for the status directly, so they aren't left waiting if the notice is late.

Once the order is paid, the same things happen as with a card sale: thank-you page, confirmation e-mail, download links, member area access, purchase events for the pixels and integrations.

For ad pixels, Vipter also records the PIX generated event when the code shows on screen.

When the code expiresCopy Anchor Link

• The checkout replaces the QR code with a notice that the code has expired and asks the buyer to reload the page. When they reload, they start the purchase again and generate a new code.
• The order with the expired code isn't paid.
• If the PIX expired e-mail is on, the buyer gets an e-mail with a button to go back to the checkout. This e-mail is off by default: turn it on in General›Settings›E-mails.

PIX in post-purchase offersCopy Anchor Link

Buyers who paid with PIX also see the offer's One-click Upsell steps, after the PIX is confirmed. Accepting an offer generates a new PIX, just for it. The original order stays paid even if the buyer doesn't pay the second PIX.

Common problemsCopy Anchor Link

• The PIX option doesn't show at checkout

  The offer is a subscription, the price isn't in reais, or there is no active PIX flow with an active connection. Check in Payments›Payment flows.

• The buyer paid, but the order is still pending

  The provider's webhook isn't registered or has the wrong secret, so the confirmation doesn't arrive. Register the webhook again following your provider's page. On Asaas, the webhook authentication token is required.

• The checkout refuses the CPF or CNPJ

  The check digits don't match. The buyer needs to correct the document on the details step.

What to do nextCopy Anchor Link

• Test your store with a low-value PIX purchase.
• Set up installments for buyers who prefer card.