Consultar Cobranças PIX por CorrelatioId (CASH-IN)

Sumário

Descrição
Endpoints
Requisição (GET)
- Parâmetros de Requisição
  - Cabeçalho
Resposta
- Parâmetros de Resposta
  - Corpo (JSON)

Descrição #

Este passo tem por finalidade verificar as informações de processamento do pagamento da chave PIX usando o CorrelatioId.

Endpoints #

Produção: https://api2.bancosemear.com.br/paas-cashin-api/api/v1/public/immediatly-billings/<CorrelatioId>
Homologação: https://hmlapi2.bancosemear.com.br/paas-cashin-api/api/v1/public/immediatly-billings/<CorrelationId>

Requisição (GET) #

Segue exemplo de requisição:

curl "https://hmlapi2.bancosemear.com.br/paas-cashin-api/api/v1/public/immediatly-billings/<CorrelationId>" \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer <APP_TOKEN>" \
    --header "client_id: <CLIENT_ID>" \
    --header "access_token: <ACCESS_TOKEN>" \
    --header "client-cert: <CERTIFICADO_CLIENTE>"

Parâmetros de Requisição #

Cabeçalho #

Content-Type: Indica o tipo do corpo da requisição
Authorization: Token Bearer de autenticação
client_id: ID de cliente usado para controle de acesso do gateway de APIs
access_token: Token recebido após executar o método oAuth
client-cert: Certificado usado para autenticar o usuário com a aplicação

Resposta #

Segue exemplo de resposta:

{
    "calendario": {
        "expiracao": 36000,
        "criacao": "2024-05-09T14:34:11.493"
    },
    "valor": {
        "original": "591.54",
        "valor pago": "591.54",
        "modalidadeAlteracao": 0
    },
    "correlationId": "9a5e6bc5-5790-470b-8b5a-6f7bc578a3ff",
    "txid": "tvei2pnuhrhelm1eaigw1us5c2rg8tmjtvp",
    "endToEnd": "E00795423202405091742DrOXHZ1z1dy",
    "status": "Pago",
    "devedor": {
        "nome": "Francisco Silva",
        "documento": "30702472026"
    },
    "chave": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "pixCopiaECola": "00020101021226920014BR.GOV.BCB.PIX2570spi-h.bancosemear.com.br/qrcode/gi/v2/0e2dc12e7a2a4c49b9e171afa8c0f30a5204000053039865802BR5923SPEED RACER AUTO MECANI6013BELOHORIZONTE61083013000862070503***6304B9CC",
    "qrCode": "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",
    "linkPagamento": "https://hml-semearpay.bancosemear.com.br/pay/pix/tvei2pnuhrhelm1eaigw1us5c2rg8tmjtvp",
    "informacoesAdicionais": [
        {
            "nome": "Sharable dedicated synergy",
            "valor": "web-enabled"
        }
    ],
    "revisao": 0
}

Parâmetros de Resposta #

Corpo (JSON) #

Propriedade	Descrição	Tipo
status	Status da cobrança: PAGO(indica que o registro se refere a uma cobrança que já foi paga e, por conseguinte, não pode acolher outro pagamento).	String
calendario.expiracao	Tempo de validade da chave (em segundos).	int32
calendario.criacao	Data de criação da chave	DateTime
txid	ID da transação	String
correlationId	Identificador interno de referencia do pix	String
endToEnd	EndToEnd da transação, gerado quando pix estiver com status PAGO	String
devedor.nome	Nome do devedor	String
devedor.documento	CPF ou CNPJ do devedor	String
valor.original	Valor do CASH-IN	String
valor.modalidadeAlteracao	Valor 0 não permite alterar o valor de pagamento do PIX, valor 1 permite alterar o valor do pagamento	int32
valor.valor pago	Valor liquido referente ao pagamento do pix.	String
revisao	valor de vezes que pix foi revisado/alterado	int32
linkPagamento	Link de pagamento do PIX	String
pixCopiaECola	Código do PIX	String
qrCode	Imagem PNG do código QR PIX codificado em base64	String
chave	Chave PIX de recebimento	String
informacoesAdicionais.nome	Chave opcional. Usado para informações específicas	String
informacoesAdicionais.valor	Valor opcional. Usado para informações específicas	String