Pix QRCode Creation Flow

The transaction creation flow starts at sales checkout (app or website) or PoS when the user chooses to use Pix as the payment method. The process takes place in two steps:

  • Payer validation and operational limit;
  • QR Code generation;

Payer validation and operational limit calculation

Complying with regulatory criteria in Brazil and seeking to ensure the security of the transaction, KYC verification of the payer is carried out, using the payer's CPF/CNPJ (Brazil's official civil/business registry) as input data. At the same endpoint, the maximum possible value for this transaction will be returned.

If the user has some type of restriction, a Bad Request will be returned with the details of the error as described in the examples.

QR Code generation

After the payer's validation, the generation of a Pix QR Code will be requested to be displayed to the user using the following endpoint.

Complete request flow

The complete flow is described in this diagram with the indication of the steps and which endpoints will be executed respectively.