{"section":"tutorials","requestedLocale":"en","requestedSlug":"pix-faq","locale":"en","slug":"pix-faq","path":"docs/en/tutorials/payments/payment-methods-and-conditions/pix/pix-faq.md","branch":"main","content":"Pix (Brazil) is the instant payment method of the [Banco Central do Brasil](https://www.bcb.gov.br/) (Bacen). VTEX stores can configure Pix (Brazil) as a payment method and offer it to customers at checkout.\n\nThis article covers the most common questions about choosing the partner that processes payments for your ecommerce website, integrating that partner with VTEX via [Payment Provider Protocol](https://developers.vtex.com/docs/guides/payments-integration-payment-provider-protocol), configuring Pix (Brazil) in the VTEX Admin, and your customers' payment experience.\n\n## Partners and integration\n\n### Do I need a payment partner to accept Pix?\n\nYes. To process Pix payments, you need a payment partner, such as a bank, acquirer, or gateway.\n\n### Which payment providers are already available?\n\nProviders that already process payments via Pix on VTEX are listed in the **Process with the provider** option during [Pix configuration](/en/docs/tutorials/setting-up-pix-as-a-payment-method). If your bank, acquirer, or gateway isn't listed, it hasn't yet been integrated with VTEX for this payment method. In this case, contact the partner and request that they complete the integration via [Payment Provider Protocol](https://developers.vtex.com/docs/guides/payments-integration-payment-provider-protocol), following the [specific integration documentation for Pix](https://developers.vtex.com/docs/guides/payments-integration-pix-instant-payments-in-brazil).\n\n### How does the platform display my store's QR code to the customer? How does this integration work?\n\nAt checkout, the payment partner integrated with VTEX sends the QR code to VTEX's internal system via an API call, and VTEX displays it at checkout so the customer can pay for the order.\n\n### Can I use Pix in a marketplace with split payment?\n\nNo. Pix isn't supported in marketplaces that split transactions. To understand the available split models and the payment methods compatible with each one, see [Split Payment](/en/docs/tutorials/split-payment).\n\n### Are Pix payments affected by Contingency Mode?\n\nNo. [Contingency Mode](/en/docs/tutorials/mode-off-faq) doesn't block transactions via Pix. That said, other issues can interrupt payment processing, and in those cases, retries typically occur every 5 minutes.\n\n## Configuration\n\n### How can I configure Pix in my online store?\n\nOnce your payment partner completes the integration via Payment Provider Protocol, you can configure Pix as a payment method in the VTEX Admin by following the tutorial [Setting up Pix as a payment method](/en/docs/tutorials/setting-up-pix-as-a-payment-method).\n\n### Can I accept payments with Pix using Mercado Pago?\n\nYes. To accept Pix with Mercado Pago Pro, you need to [configure Mercado Pago Pro as a payment method](/en/docs/tutorials/how-to-configure-mercado-pago-pro-as-a-payment-method) and add a Pix key in Mercado Pago.\n\n### Is there any additional cost to accept Pix in my online store?\n\nNo. VTEX doesn't charge anything extra for payments via Pix. The processing cost for this payment method must be negotiated with the chosen payment provider, whether a gateway, acquirer, or bank.\n\n### Can I offer discounts for payments via Pix?\n\nYes. When [creating a regular promotion](/en/docs/tutorials/regular-promotion), use the **Payment methods** condition and select Pix. The promotion only applies when the order uses a single payment method; therefore, it doesn't apply to orders split between Pix and gift cards.\n\n### Can I accept Pix in physical stores using VTEX Sales App?\n\nYes, in stores in Brazil. In addition to configuring the Pix payment condition, you need to set Pix to be displayed in the app. See the instructions in [Setting up Pix](/en/docs/tracks/setting-up-pix) in VTEX Sales App.\n\n## Customer experience\n\n### What does the Pix payment screen look like for my customer?\n\nThe option to pay via Pix appears in the checkout list, alongside the other payment options. When the customer selects Pix, a QR code is generated with the purchase details, and the customer has until the QR code expires to complete payment at their preferred financial institution.\n\n![Checkout_Pix](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/meios-e-condições-de-pagamento/pix/pix-faq_1.png)\n\n![QRCode_Pix](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/pagamentos/meios-e-condições-de-pagamento/pix/pix-faq_2.png)\n\n### What happens to the order when the QR code expires?\n\nThe QR code expiration time is set by the payment provider for each transaction and can range from 15 to 60 minutes. If the customer doesn't complete the payment within this period, the order is canceled, and a new purchase must be made. To change the expiration time in your store, contact your payment provider.\n\n### When is an order paid with Pix included in approved revenue?\n\nUnlike orders paid by credit card, which are recorded as approved revenue when the acquirer validates the card's available credit and details, Pix orders are only counted after payment confirmation. To learn more, see [Understanding the value of approved revenues](/en/docs/tutorials/understanding-the-value-of-approved-revenues).\n\n### Can a payment be split between Pix and another payment method?\n\nCurrently, on VTEX, you can only split a payment between Pix and a [gift card](/en/docs/tutorials/gift-card).\n\n### How does a Pix payment refund work?\n\nRefunds for payments via Pix depend on the payment provider. If the provider processes Pix refunds automatically via the VTEX integration, the platform completes the refund. Otherwise, the provider indicates to VTEX that the refund must be processed manually, and you need to complete it directly with the provider, outside the platform. To learn more about full and partial refunds, see [Payment refunds](/en/docs/tutorials/payment-refunds).\n\n## API reference\n\n### How is the Pix payment method identified in the Get order endpoint JSON?\n\nIn the JSON response of the [Get order](https://developers.vtex.com/docs/api-reference/orders-api#get-/api/oms/pvt/orders/-orderId-) endpoint from the Orders API, Pix is identified in `paymentData.transactions[].payments[]` by the `paymentSystemName` field, with the value `Pix`, and by the `group` field, with the value `instantPayment`."}