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.
| Campo | Descrição |
|---|---|
| typeAccount | Tipo de conta bancária (Domínio 1.6) |
| bankBranch | Número de agência bancária |
| bankAccount | Número de conta bancária |
| document | Documento (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.
| Item | Descrição |
|---|---|
| Implementação do consumo dos endpoints | |
| Criação de url para validação de conta bancária | Conforme 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 pix | Conforme descrito na seção 4.0.2, deve-se implementar o endpoint para permitir ou rejeitar um envio de pix ou recebimento. |
| Teste | Passar por bateira de testes; |
Histórico de alterações
| Data | Versão | Descrição | Autor |
|---|---|---|---|
| 03/07/2024 | 1.0 | Versão inicial. | Cronos |