GuidesCommunity

Receber pagamento de uma cobrança - QR Code

Fluxo passivo de recebimento de Pix-In (recebimento do QR Code)

Suggest Edits

Para receber os saldos das cobranças na wallet interna da plataforma, o fluxo é passivo.
Basta que haja o pagamento da cobrança numa instituição bancária, via PIX, o valor será recebido na conta bancária vinculada na wallet do sistema.

Porém disponibilizados um endpoint para os testes de recebimento de recursos que está disponível apenas no ambiente de testes (staging).

Este fluxo é um endpoint exclusivo para a simulação do pagamento de uma cobrança externa e então o cliente pode acompanhar o recebimento do valor de

Usado para:

  • simular pagamentos externos realizados das cobranças geradas;

📘

Relembrando:

O endpoint de pagamento de QR Code não está disponível em ambiente de produção.
É apenas uma facilidade para o cliente acompanhar de forma clara como é feito o recebimento dos pagamentos em seu ambiente de homologação (staging).

Como pagar cobrança - QR Code

ENDPOINT: https://kaizen.bt-staging.app/pix-service/wallets/:walletId/qrcode/pay

Esse endpoint utiliza o método POST.

Modelo de requisição:

POST {{baseurl}}/pix-service/wallets/:walletId/qrcode/pay

curl --location --request POST '{{baseurl}}/pix-service/wallets/:walletId/qrcode/pay' \
--header 'Authorization: Bearer TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": "{{qrCodeBase64}}",
    "amount": "1.11",
    "asset": "BRLP",
    "source": "33046597-0382-445f-afe1-275b1f9bf1f1"

{
    "data": "{{qrCodeBase64}}",
    "amount": "{{transactionAmount}}",
    "asset": "BRLP",
    "source": "f0937bd7-64bb-4354-a7f3-5819a8388769"
}

Modelo de resposta:

{
    "id": "6f551805-c2f7-4f46-bfea-d58c059a8553",
    "type": "payment",
    "status": "AUTHORIZED",
    "createdAt": "2022-09-15T04:27:50.971Z",
    "updatedAt": "2022-09-15T04:27:50.971Z",
    "additionaldata": {
        "type": "internal-transfer",
        "paidAt": "2022-09-15T04:27:48.741Z",
        "source": {
            "ispb": "32778350",
            "bankNumber": "32778350",
            "accountType": "checking",
            "branchNumber": "0001",
            "accountNumber": "49695269",
            "accountHolderName": "Kiana Fay",
            "accountHolderType": "personal",
            "accountHolderTaxId": "72974107214"
        },
        "arrangement": "pix",
        "destination": {
            "ispb": "03311443",
            "bankNumber": "03311443",
            "accountType": "payment",
            "branchNumber": "0001",
            "accountNumber": "10000000121",
            "accountHolderName": "Kaizen pix-cobranca prod",
            "accountHolderType": "corporate",
            "accountHolderTaxId": "73244653000190"
        },
        "requestedAt": "2022-09-15T04:27:48.720Z",
        "remittanceInfo": "develop Descricao do serviço sendo cobrado em PIX COBRANÇA",
        "userTransactionId": "NAT-HSIzAruExLOxWlI6cI4bPYrk",
        "paymentInitiationMode": "DYNAMIC_QRCODE"
    }
}

Descrição dos campos:

Os campos em negrito são obrigatórios:

campotipodescrição
data string(base64)- base64 do QR Code que deseja pagar;
- o QR Code deve ser de uma cobrança gerada na plataforma;
amount string- valor do pagamento;
- decimais separados por ponto;
asset string- asset do sistema;
- moeda do pagamento;
- padrão: BRLP
source string(uuid)- wallet de origem que irá pagar o QR Code não é a wallet do cliente, é a wallet que será disponibilizada pela equipe de Integração para os testes;

📘

Importante:

Para execução do teste de pagamento de um QR Code, é necessário utilizar uma "wallet source" (pagadora) válida para testes. Para isso, use a wallet source f0937bd7-64bb-4354-a7f3-5819a8388769

Lembrando que esse endpoint só existe em ambiente de homologação.

Updated 8 months ago