Refinanciamento (REFIN)
curl --request POST \
--url https://api.example.com/contract/refinancing \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/contract/refinancing"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/contract/refinancing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"requestId": "e7f8a9b0-c1d2-3456-e7f8-a9b0c1d23456",
"status": "queued"
}
Refinanciamento
Refinanciamento (REFIN)
Quita contratos ativos do trabalhador como alternativa à averbação de um novo contrato
POST
/
contract
/
refinancing
Refinanciamento (REFIN)
curl --request POST \
--url https://api.example.com/contract/refinancing \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/contract/refinancing"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/contract/refinancing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"requestId": "e7f8a9b0-c1d2-3456-e7f8-a9b0c1d23456",
"status": "queued"
}
Etapa opcional — usada apenas quando a operação é de refinanciamento, como alternativa à averbação.
Todos os endpoints requerem autenticação via Bearer token no header
Authorization.
Consulte o guia de autenticação para obter suas credenciais e gerar um token.Chamada
POST /contract/refinancing · processamento assíncrono (202 + requestId)
Fica sob a URL base https://hml.zipdin.com.br/dataprev-controller (homologação). Como toda operação de
/contract/*, é sempre assíncrona: a resposta imediata confirma o enfileiramento e o resultado chega por
consulta de status ou webhook.
Contratos originados com garantia só podem ser refinanciados 1 para 1.
Relação com a Averbação
O corpo do REFIN usa o mesmo schema da Averbação (assignee, endorsement, contractInfo, workerInfo, paymentList), com duas diferenças no bloco
endorsement:
| Campo | Averbação | Refinanciamento |
|---|---|---|
refinContracts | proibido | obrigatório — array de 1+ contratos a quitar (13-15 caracteres alfanuméricos cada) |
paidValue | — | obrigatório — valor de quitação (maior que 0) |
paymentList[].paymentValue deve ser
igual a endorsement.loanValue.
Exemplo
curl -X POST https://hml.zipdin.com.br/dataprev-controller/contract/refinancing \
-H "x-api-key: SUA_API_KEY" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "x-idempotency-key: 3f8a91b2-7c4d-4e5f-a6b7-8c9d0e1f2a3b" \
-H "Content-Type: application/json" \
-d '{
"assignee": "12345678000190",
"endorsement": {
"cpf": "52998224725",
"refinContracts": ["ABC1234567890"],
"paidValue": 5000.00,
"contract": "XYZ9876543210",
"loanValue": 8000.00,
"installmentsNumber": 48,
"installmentValue": 220.00,
"hasGuarantees": false
},
"paymentList": [
{ "cpfCnpj": "52998224725", "paymentValue": 8000.00, "pixKey": "52998224725" }
]
}'
O exemplo acima é reduzido para destacar os campos específicos do REFIN. Os blocos
endorsement,
contractInfo e workerInfo têm os mesmos campos obrigatórios da
Averbação — consulte a página de averbação para a lista
completa.{
"requestId": "e7f8a9b0-c1d2-3456-e7f8-a9b0c1d23456",
"status": "queued"
}