Como configurar os Webhooks de retorno (Apenas em Produção)? – Celcoin

Os webhooks avisam o Cobransaas quando um boleto foi registrado, pago ou cancelado. Utilize um cliente HTTP (como Postman ou cURL) seguindo a ordem abaixo:

Passo 1: Autenticação (Obter Token)

Bash

curl --location 'https://auth.flowfinance.com.br/oauth2/token' \
--header 'Content-Type: application/json' \
--header 'Authorization: [Inserir_Token_Basic_Aqui]' \
--data 'grant_type=client_credentials'

Passo 2: Consultar ID da Conta

Bash

curl --location 'https://platform.credit.celcoin.com.br/escrow/api/v1/accounts' \
--header 'Authorization: Bearer [Inserir_Token_Passo_1]'

Passo 3: Cadastrar os Webhooks na Conta Encontrada

(Substitua o ID da conta 86227c7e... no exemplo abaixo pelo ID retornado no Passo 2)

Boleto Registrado (CHARGE-CREATE):

Bash

curl --location 'https://platform.credit.celcoin.com.br/escrow/api/v1/accounts/86227c7e-f0ff-4f90-8f95-34b169a8572d/webhook-configurations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [Token]' \
--data '{"webhookType": "CHARGE-CREATE", "url": "https://crediopay.cobransaas.com.br/hooks/cnab/escrow"}'

Boleto Pago (CHARGE-SETTLEMENT):

Bash

curl --location 'https://platform.credit.celcoin.com.br/escrow/api/v1/accounts/86227c7e-f0ff-4f90-8f95-34b169a8572d/webhook-configurations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [Token]' \
--data '{"webhookType": "CHARGE-SETTLEMENT", "url": "https://crediopay.cobransaas.com.br/hooks/cnab/escrow"}'

Boleto Cancelado (CHARGE-CANCELATION):

Bash

curl --location 'https://platform.credit.celcoin.com.br/escrow/api/v1/accounts/86227c7e-f0ff-4f90-8f95-34b169a8572d/webhook-configurations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer [Token]' \
--data '{"webhookType": "CHARGE-CANCELATION", "url": "https://crediopay.cobransaas.com.br/hooks/cnab/escrow"}'

Passo 4: Cadastrar Webhooks Pix

Cadastre as URLs substituindo {tenant} pelo subdomínio do cliente:

PIX-PAYMENT-IN: {"webhookType": "PIX-PAYMENT-IN", "url": "https://{tenant}.cobransaas.com.br/hooks/pix/escrow"}
PIX-PAYMENT-OUT: {"webhookType": "PIX-PAYMENT-OUT", "url": "https://{tenant}.cobransaas.com.br/hooks/pix/escrow"}

Dica: Realize uma chamada GET na mesma rota do Passo 3 para validar se todos constam como ativos.