2.A Autorizar pelo fluxo da Celcoin

Cria uma solicitação de autorização de consentimento (assinatura) para o tomador, via WhatsApp ou E-mail. Esse endpoint é usado para obter o consentimento do cliente em operações de garantia.

Método:POST

Endpoint

https://sandbox.platform.flowfinance.com.br/banking/originator/guarantee/authorization-permission


Headers

ChaveValorDescrição
AuthorizationBearer {{originatorAccessToken}}Token de acesso do originador
Content-Typeapplication/jsonFormato do corpo da requisição

Payload

{
  "taxpayer_id": "TESTE",
  "product_id": "UIDI",
  "name": "celcoin teste",
  "mode": "WHATSAPP",
  "email": "[email protected]",
  "phone": {
    "country_code": "+55",
    "area_code": "11",
    "number": "TESTE"
  }
}
CampoTipoObrigatórioDescrição
taxpayer_idstringSimCPF ou CNPJ do cliente
product_idstringSimIdentificador do produto vinculado
namestringSimNome do cliente
modestringSimCanal de envio do consentimento (WHATSAPP ou EMAIL)
emailstringSimE-mail do cliente (sempre obrigatório, independentemente do mode)
phoneobjetoNãoDados de telefone (obrigatório se mode = WHATSAPP)

Exemplos de Requisição

Envio por WhatsApp

curl --location 'https://sandbox.platform.flowfinance.com.br/banking/originator/guarantee/authorization-permission' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{originatorAccessToken}}' \
--data-raw '{
  "taxpayer_id": "1234567890",
  "product_id": "330ab1f3-3b21-4188-b213-d853b98f0f92",
  "name": "Celcoin teste",
  "mode": "WHATSAPP",
  "email": "[email protected]",
  "phone": {
    "country_code": "+55",
    "area_code": "11",
    "number": "970291614"
  }
}'

Envio por E-mail

curl --location 'https://sandbox.platform.flowfinance.com.br/banking/originator/guarantee/authorization-permission' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{originatorAccessToken}}' \
--data-raw '{
  "taxpayer_id": "92041635851",
  "product_id": "760a6c7e-5dea-4a32-afad-8b9413d0aea7",
  "name": "teste Celcoin",
  "mode": "EMAIL",
  "email": "[email protected]"
}'

Exemplo de Resposta:

{
  "id": "56ce801c-030e-479b-8edc-107892a421c9",
  "status": "WAITING_SIGNATURE"
}
CampoTipoDescrição
idstringIdentificador da solicitação de autorização
statusstringStatus atual da assinatura (WAITING_SIGNATURE, SIGNED, EXPIRED, etc.)

⚠️ Atenção

Após o cliente concluir o processo de assinatura (via Celcoin), o sistema enviará uma confirmação automática através de um webhook previamente cadastrado, exclusivo para eventos de assinatura do termo de consentimento.