Como validar Dados bancários Usando agência e conta
1. É necessario que você tenha uma API MASTER
Caso você não tenha, temos essa documentação que lhe ensina como criar uma API MASTER.
Após criar a API MASTER basta seguir o passo a passo.
Crie um pagamento de 1 centavo:
Para fazer este passo a passo é necessário que você tenha o PIXOUT habilitado em sua conta, então caso não tenha basta solicitar seguindo este artigo : Como solicitar o pagamento externo (PIX OUT)
Após isso você irá criar um pagamento para a chave-pix que deseja saber os dados bancários.
Sequência da integração
1. Crie o pagamento:
Nesta etapa você irá criar o pagamento seguindo os parâmetros de nosso endPoint: Create Payment request
Campos do Pagamento Manual
holder (Dados do Beneficiário)
Representa a pessoa ou empresa que vai receber o pagamento.
Campo | Descrição |
---|---|
name | Nome completo do beneficiário |
taxID.type | Tipo do documento (BR:CNPJ ou BR:CPF) |
taxID.taxID | Número do documento |
account (Dados Bancários)
Representa os dados da conta bancária do beneficiário.
Campo | Descrição |
---|---|
branch | Número da agência bancária (ex: "0001") |
account | Número da conta bancária (ex: "00000000000000000981") |
accountType | Tipo da conta (ex: "TRAN" para conta corrente) |
psp (Provedor de Serviço de Pagamento)
Representa a instituição financeira que processará o pagamento.
Campo | Descrição |
---|---|
id | Identificador único do PSP |
name | Nome da instituição financeira (ex: "WOOVI IP") |
curl --location 'https://api.woovi.com/api/v1/payment' \
--header 'Content-Type: application/json' \
--header 'Authorization: ****' \
--data '{
"value": 100,
"correlationID": "c0938e0c-a613-48a9-982a-672c062d0001",
"holder": {
"name": "teste",
"taxID": {
"type": "BR:CNPJ",
"taxID": "202********158"
}
},
"psp": {
"id": "54811417",
"name": "WOOVI IP LTDA"
},
"account": {
"account": "000********0981",
"branch": "00**",
"accountType": "TRAN"
}
}'
2. Confirme o pagamento:
Nesta etapa será necessário que você aprove o pagamento que criou seguindo o endpoint: Approve a Payment Request
Após a confirmação do pagamento irá gerar um payload com os dados bancários da chave-pix que fez o pagamento
curl --location 'https://api.woovi.com/api/v1/payment/approve' \
--header 'Content-Type: application/json' \
--header 'Authorization: ****' \
--data '{
"correlationID": "c0938e0c-a613-48a9-982a-672c062d0001"
}'
{
"payment": …,
"transaction": …,
"destination": {
"name": "Luc— – —--ar",
"taxID": "07*******61",
"pixKey": "07*******61",
"bank": "NU PAGAMENTOS - IP",
"branch": "1",
"account": "76******03"
}
}