Consultar Cobranças PIX Saque por TxId (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 PIX Saque usando o TXID (ID de transação) criado no passo anterior.

Endpoints #

Produção: https://api2.bancosemear.com.br/paas-cashin-api/api/v1/public/billing-withdraws/<TXID>
Homologação: https://hmlapi2.bancosemear.com.br/paas-cashin-api/api/v1/public/billing-withdraws/<TXID>

Requisição (GET) #

Segue exemplo de requisição:

curl "https://hmlapi2.bancosemear.com.br/paas-cashin-api/api/v1/public/billing-withdraws/<TXID>" \
    --request GET \
    --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": "00.00",
        "modalidadeAlteracao": 0,
        "retirada": {
            "saque": {
                "valor": "01.08",
                "modalidadeAlteracao": 0,
                "modalidadeAgente": "AGTEC",
                "prestadorDoServicoDeSaque": "00795423"
            }
        }
    },
    "correlationId": "6234f103-1998-4be3-a4cd-8aa246a4a22d",
    "txid": "rskgq96spkfnbq5bz206268v812ve6llj6n",
    "endToEnd": "E00795423202404231255mh22jH3TCpD",
    "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: PENDENTE(indica que o registro se refere a uma cobrança que foi gerada mas ainda não foi paga nem esta expirada); PAGO(indica que o registro se refere a uma cobrança que já foi paga e, por conseguinte, não pode acolher outro pagamento); EXPIRADO (indica que o pix está expirado e não pode mais ser pago ou alterado).	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 nessa modalidade	int32
valor.retirada.saque.valor	Valor de saque do CASH-IN	String
valor.retirada.saque.modalidadeAlteracao	Valor 0 não permite alterar o valor de pagamento do PIX, valor 1 permite alterar o valor do pagamento.	Int32
valor.retirada.saque.modalidadeAgente	Agente de saque (AGTEC, AGTOT, AGFSS)*	String
valor.retirada.saque.prestadorDoServicoDeSaque	Facilitador de Serviço de Saque registrado.	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