Pular para o conteúdo principal

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

sequencial

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.

CampoDescrição
nameNome completo do beneficiário
taxID.typeTipo do documento (BR:CNPJ ou BR:CPF)
taxID.taxIDNúmero do documento

account (Dados Bancários)

Representa os dados da conta bancária do beneficiário.

CampoDescrição
branchNúmero da agência bancária (ex: "0001")
accountNúmero da conta bancária (ex: "00000000000000000981")
accountTypeTipo da conta (ex: "TRAN" para conta corrente)

psp (Provedor de Serviço de Pagamento)

Representa a instituição financeira que processará o pagamento.

CampoDescrição
idIdentificador único do PSP
nameNome 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"
}
}'

creat

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"
}
}

confirm