Fluxo de Iniciação de pagamentos

Fluxo de Iniciação de Pagamentos

Quando o desenvolvedor deseja testar as APIs destinadas a Informações de Conta, é necessário criar um aplicativo em seu painel do tipo de produto BRAZIL PISP

O cliente consente com seu parceiro que gostaria de compartilhar suas informações bancárias e escolhe o PSP
O desenvolvedor contata o PSP e envia uma solicitação de consentimento de conta
- O PSP verifica se o Id do aplicativo do desenvolvedor (client_id) tem as autorizações necessárias
- PSP usa as informações e cria recursos de consentimento e inicializa o processo, alterando o status para AwaitingAuthorisation
O PSP responde ao desenvolvedor com uma resposta de consentimento, que também instrui o desenvolvedor sobre como proceder com a autenticação e autorização
O desenvolvedor redireciona o cliente do PSP para o site do PSP para autenticação e confirmação de consentimento
Após as verificações necessárias, o PSP envia o token de acesso ao desenvolvedor, que por sua parte, o utiliza para recuperar as informações da conta do Usuário

Teste através do Portal do Desenvolvedor

Os seguintes passos devem ser realizados para a Iniciação de Pagamentos

1. Selecionar APP

Clique Test para o APP selecionado, sendo redirecionado ao Swagger UI

2. Autenticação do Desenvolvedor

Primeiro passo no fluxo é a autenticação do App-Id do desenvolvedor. Clique no botão Autorizar e preencha o APP secret para obter o token de acesso específico para o Desenvolvedor

3. Chamada de Solicitação de Consentimento para Informações de Conta

O bearer token obtido pelo passo anterior deve ser preenchido no Endpoint de Iniciação de Pagamentos - POST /payments/v1/consents

Como exemplo, use a chave privada abaixo para assinar a solicitação (corresponde aos JWKs fornecidos em App creation), cole no campo application signing private key acima do botão Autorizar

O valor exclusivo deve ser fornecido para o campo x-idempotency-key
Utilize o payload abaixo para enviar requisições de iniciação de pagamentos.
Substitua o valor da data de pagamento por uma data futura. Substitua também os valores de CNPJ e CPF com base nos detalhes do usuário da PSU

{
  "data": {
    "businessEntity": {
      "document": {
        "identification": "11111111111111",
        "rel": "CNPJ"
      }
    },
    "loggedUser": {
      "document": {
        "identification": "11111111111",
        "rel": "CPF"
      }
    },
    "creditor": {
      "name": "Marco Antonio de Brito",
      "cpfCnpj": "58764789000137",
      "personType": "PESSOA_NATURAL"
    },
    "payment": {
      "date": "2025-03-01",
      "amount": "10.12",
      "currency": "BRL",
      "details": {
        "proxy": "1f212beb-d25c-44c5-aca7-3a046d921d46",
        "localInstrument": "DICT",
        "creditorAccount": {
          "number": "1234567890",
          "accountType": "CACC",
          "ispb": "12345678",
          "issuer": "1774"
        }
      },
      "type": "PIX",
      "ibgeTownCode": "5300108"
    }
  }
}

Se a solicitação for bem sucedida, o desenvolvedor receberá a seguinte resposta.A resposta do servidor será exibida no formato JWT.

Você pode analisar esse token JWT no site do JWT e visualizar a resposta JSON e obter o ID de consentimento.

4. Autenticação de Usuário

Clique em Autorizar no topo para iniciar a autenticação do Usuário.

O botão Authorizar é utilizado para autenticar o Usuário. Após login e captura de consentimento, o token do Usuário já estará disponível para acesso a informações de conta.

5. Consultar consentimento para iniciação de pagamento

GET /payments/v1/consents/{consentId}

Insira o valor consentId obtido do endpoint de criação de consentimento.
A resposta do servidor será exibida como JWT.

Você pode analisar este JWT e o status de consentimento deve ser 'AUTORIZADO'.

6. Chamadas para a API de Pagamentos

O desenvolvedor pode usar o access_token do Usuário para obter detalhes sobre o status do pagamento. Um pagamento pode ter um ou mais autorizadores. Com access_token, o PSIP pode recuperar o status de todas as autorizações. Ele também pode obter o status do pagamento em si.

Submit payment instruction

POST /payments/v1/pix/payments

Use o abaixo Payload

{
  "data": {
    "endToEndId": "E00000000202301241741qiWXx73Jy67",
    "localInstrument": "DICT",
    "payment": {
      "amount": "10.12",
      "currency": "BRL"
    },
    "creditorAccount": {
      "ispb": "12345678",
      "issuer": "1774",
      "number": "1234567890",
      "accountType": "CACC"
    },
    "remittanceInformation": "Pagamento da nota XPTO035-002.",
    "proxy": "1f212beb-d25c-44c5-aca7-3a046d921d46",
    "cnpjInitiator": "50685362000135",
    "ibgeTownCode": "5300108"
  }
}

A resposta do servidor será exibida

Você pode analisar esta resposta JWT e obter o PaymentId, ConsentId.