Pix

O pix é um sistema de pagamentos instantâneos do Banco Central do Brasil.

O Pix possui duas bases de informações principais:

  • DICT - Diretório de identificadores de Contas Transacionais. Utiliza apelidos para identificar as contas transacionais, conhecidos como chave pix. Com esses “apelidos” facilita-se a identificação e envio de valores entre contas.
  • SPI - Sistema de pagamentos instantâneos: armazena os dados financeiros, dos pagamentos instantâneos efetuados.

Conceituação técnica

0 - Esse serviço é responsável pela regra de negócio de todo ecossistema PIX;

1 - Essa conceituação visa descrever o ecossistema para participantes que irão utilizar nossa base, controlando os próprios clientes, saldos, entradas e saídas de pix, entre outros;

2 - Clientes que não são participantes direto ou indireto, que consumirão a API através de uma autenticação de customer da v2, não utilizarão desses conceitos expostos a partir deste item, tendo em vista que o cliente em si ja está vínculado à própria autenticação, e não realiza controle de saldo e nem define os dados do cliente por parâmetro;

2.1 - Os clientes não participantes devem ignorar os parâmetros que estão marcados com “*gwc” em todos os endpoints; esses parâmetros serão ignorados caso sejam fornecidos.

3 - O cliente em si, identificado pelo participante indireto ou direto que consome os endpoints, é identificado pelos seguintes campos nos endpoints:

Obs: Todo endpoint contem marcado no parâmetro “*gwc” quando é a identificação do cliente.

CampoDescrição
typeAccountTipo de conta bancária (Domínio 1.6)
bankBranchNúmero de agência bancária
bankAccountNúmero de conta bancária
documentDocumento (cpf ou cnpj) do cliente
  • Nos endpoints de cobrança o cliente é identificado em receiver.*;
  • Nos endpoints de transferência o cliente é identificado em payer.*;
  • Nos endpoints de DICT, na raiz das propriedades.

TODO LIST INTEGRAÇÃO

  • Essa orientação destina-se à participantes.
ItemDescrição
Implementação do consumo dos endpoints
Criação de url para validação de conta bancáriaConforme descrito na seção 4.0.1, deve-se implementar a url para retorno de dados de acordo com dados bancários.
Criação de url para validação de recebimento ou envio de pixConforme descrito na seção 4.0.2, deve-se implementar o endpoint para permitir ou rejeitar um envio de pix ou recebimento.
TestePassar por bateira de testes;

Histórico de alterações

DataVersãoDescriçãoAutor
03/07/20241.0Versão inicial.Cronos