Recebimento
Nesta seção, disponibilizamos operações que permitem o acompanhamento dos recebimentos na conta do cliente.
Consulta de recebimento por parâmetros
Importante:
Mudança na consulta das API's, de recebimentos e pagamentos.
Diante do nosso compromisso de evolução e melhoria contínua de nossos serviços, a partir de 20/08 somente será possível realizar a consulta dos pagamentos e recebimentos PIX feitos por meio de API's, mediante seleção do dia a ser consultado e não mais por período.
Funcionalidade permite recuperar os recebimentos no período especificado, podendo informar o TxId da transação para uma consulta específica.
Solicitamos os campos:
| Campo | Descrição | Formato | Obrigatório |
|---|---|---|---|
| Inicio | Início do período desejado de pesquisa | date-time | Sim |
| Fim | Fim do período desejado de pesquisa | date-time | Sim |
| TxId | Identificador da transação de cobrança | string | Não |
Resposta:
| Campo | Descrição | Formato | Nullable |
|---|---|---|---|
| endToEndId | Identificador da transação Pix | string | Sim |
| recebimentoId | Identificador do recebimento gerado pelo Banco BS2 | integer | Não |
| txId | Identificador da transação da cobrança | string | Sim |
| data | Data do recebimento | string | Não |
| valor | Valor da transação Pix | number | Nao |
| status | Status do recebimento, conforme tabela Status recebimento | string | Não |
| pagador | Dados do pagador do Pix (banco, agência, conta, documento) | object | Sim |
| recebedor | Dados do recebedor do Pix (banco, agência, conta, documento) | object | Sim |
| chaveDict | Chave DICT do recebedor | string | Sim |
| campoLivre | Mensagem informada pelo pagador ao recebedor, se desejar | string | Sim |
| situacao | Situação da transação, conforme tabela Situação da transação | string | Não |
| devolucoes | Informações de devolução, se houve alguma associado ao recebimento | Array | Sim |
Recebimento - Consultar por parâmetros
Consultar de recebimentos por EndToEndId
Funcionalidade permite recuperar um recebimento pelo EndToEndId que é o identificador único de uma transação Pix.
Solicitamos os campos:
| Campo | Descrição | Formato | Obrigatório |
|---|---|---|---|
| endToEndId | Identificador da transação Pix | string | Sim |
| Inicio | Início do período desejado de pesquisa | date-time | Não |
| Fim | Fim do período desejado de pesquisa | date-time | Não |
| TxId | Identificador da transação da cobrança | string | Não |
Resposta:
| Campo | Descrição | Formato | Nullable |
|---|---|---|---|
| endToEndId | Identificador da transação Pix | string | Sim |
| recebimentoId | Identificador do recebimento | integer | Não |
| txId | Identificador da transação da cobrança | string | Sim |
| data | Data do recebimento | string | Não |
| valor | Valor da transação Pix | number | Nao |
| status | Status do recebimento, conforme tabela Status recebimento | string | Não |
| pagador | Dados do pagador do Pix (banco, agência, conta, documento) | object | Sim |
| recebedor | Dados do recebedor do Pix (banco, agência, conta, documento) | object | Sim |
| chaveDict | chave DICT do recebedor | string | Sim |
| campoLivre | Mensagem destinada ao recebedor | string | Sim |
| situacao | Status do recebimento, conforme tabela Status recebimento | string | Não |
| devolucoes | Informações de devolução, se houve alguma associado ao recebimento | Array | Sim |
Recebimento - Consultar por EndToEndId
Consulta de recebimentos por RecebimentoId
Funcionalidade permite recuperar um recebimento pelo identificador do recebimento.
Solicitamos o campo:
| Campo | Descrição | Formato | Obrigatório |
|---|---|---|---|
| recebimentoId | Identificador do recebimento | integer | Sim |
Resposta:
| Campo | Descrição | Formato | Nullable |
|---|---|---|---|
| endToEndId | Identificador da transação Pix | string | Sim |
| recebimentoId | Identificador do recebimento | integer | Não |
| txId | Identificador da transação da cobrança | string | Sim |
| data | Data do recebimento | string | Não |
| valor | Valor da transação Pix | number | Nao |
| status | Status do recebimento, conforme tabela Status recebimento | string | Não |
| pagador | Dados do pagador do Pix (banco, agência, conta, documento) | object | Sim |
| recebedor | Dados do recebedor do Pix (banco, agência, conta, documento) | object | Sim |
| chaveDict | chave DICT do recebedor | string | Sim |
| campoLivre | Mensagem destinada ao recebedor | string | Sim |
| situacao | Status do recebimento, conforme tabela Status recebimento | string | Não |
| devolucoes | Informações de devolução, se houve alguma associado ao recebimento | Array | Sim |
Recebimento - Consultar por RecebimentoId
Consulta de recebimentos por QrCodeId
Funcionalidade permite recuperar um recebimento pelo identificador do QR CODE.
Solicitamos o campo:
| Campo | Descrição | Formato | Obrigatório |
|---|---|---|---|
| qrCodeId | Identificador do QR CODE | integer | Sim |
Resposta:
| Campo | Descrição | Formato | Nullable |
|---|---|---|---|
| id | Identificador do recebimento | integer | Não |
| identificadorTransacao | Identificador da transação da cobrança | string | Sim |
| data | Data do recebimento | date-time | Não |
| valor | Valor da transação Pix | number | Nao |
| status | Status do recebimento, conforme tabela Status recebimento | string | Não |
| pagadorConta | Dados bancários do pagador do Pix | object | Sim |
| pagadorDocumento | Dados do pagador do PIX (documento, nome, nome fantasia) | object | Sim |
| recebedorConta | Dados bancários do recebedor do Pix | object | Sim |
| recebedorDocumento | Dados do recebedor do Pix (documento, nome, nome fantasia) | object | Sim |
| chaveDict | Chave DICT do recebedor | string | Sim |
| msgId | Mensagem informada no QR CODE para o pagador | object | Sim |
| endToEndId | Identificador da transação Pix | string | Sim |
| campoLivre | Mensagem destinada ao recebedor | object | Sim |
| msgId2 | Mensagem informada no QR CODE para o pagador | object | Sim |
| originalId | Identificador da transação Pix | string | Sim |
| endToEndId2 | Identificador da transação Pix | object | Sim |
| situacao | Status do recebimento, conforme tabela Status recebimento | string | Não |
| devolucoes | Informações de devolução, se houve alguma associado ao recebimento | Array | Sim |
Updated about 1 month ago