Skip to main content

Offsite Pix payments

Updated: Nov 14, 2025 Payments API also enables businesses to collect payments from their customers via WhatsApp using dynamic Pix codes. When using this integration, WhatsApp only facilitates the communication between merchants and buyers. Merchants are responsible for integrating with a bank or PSP in order to generate dynamic Pix codes, and confirm their payment.

Before you start

Familiarize yourself with the Orders API. Orders are the entrypoint for collecting payments in WhatsApp. You will need an existing integration with a bank or PSP to generate dynamic Pix codes and do automatic reconciliation when a payment is made. You must be able to update the order status as soon as a payment is made.

Integration steps

The following sequence diagram shows the typical integration with Pix. Image

1. Send an Order Details message

Follow the full integration guide in the Orders API page. If Pix is available on this order, you will need to provide a pix_dynamic_code to the payment_settings attribute.

Parameters object

Payment settings

Dynamic Pix code object

Payload example

2. Send an order status update

Once the payment is confirmed, you must send an order status update. Follow the integration guide in the Orders API page. Did you find this page helpful? Thumbs up icon Thumbs down icon ON THIS PAGE Before you start Integration steps 1. Send an Order Details message Parameters object Payment settings Dynamic Pix code object Payload example 2. Send an order status update