Ficha técnica

Se a sua empresa trabalha com antecipação de recebíveis para um volume grande de fornecedores, a API de Risco Sacado permite que você utilize o seu limite de crédito para antecipar pagamentos a fornecedores.

Segurança

📘 BTG Id

O Authorization Server do BTG Empresas se chama BTG Id. Usando o BTG Id, um aplicativo parceiro consegue consentimento e autorização para executar operações nas APIs do BTG em nome do cliente. Para saber mais, acesse a documentação do BTG Id

Escopos necessários

O token para consumir a API de Risco Sacado deve ser gerado usando o Client Credentials.

É necessário escolher um dos seguintes escopos:

Escopo	Descrição
empresas.btgpactual.com/scf/borderos	Permite criar e consultar conjuntos de recebíveis (borderôs).
empresas.btgpactual.com/scf/borderos.readonly	Permite consultar conjuntos de recebíveis (borderôs).
empresas.btgpactual.com/scf/companies	Permite cadastrar e consultar fornecedores.
empresas.btgpactual.com/scf/companies.readonly	Permite consultar fornecedores.
empresas.btgpactual.com/scf/operations	Permite criar e consultar operação de antecipação de recebíveis.
empresas.btgpactual.com/scf/operations.readonly	Permite consultar operação de antecipação de recebíveis.
empresas.btgpactual.com/scf/receivables	Permite enviar documentos relacionados a recebíveis.
empresas.btgpactual.com/scf/receivables.readonly	Permite consultar informações relacionadas a recebíveis.
empresas.btgpactual.com/scf/settlements	Permite cadastrar e consultar pagamento de recebíveis antecipados.
empresas.btgpactual.com/scf/settlements.readonly	Permite consultar pagamento de recebíveis antecipados.
empresas.btgpactual.com/scf/trades	Permite consultar antecipações de recebíveis.
empresas.btgpactual.com/scf/trades.readonly	Permite consultar antecipações de recebíveis em modo somente leitura.

Recursos Disponíveis

Os recursos da API de Risco Sacado estão disponíveis no API Reference.

📘 API Reference

Risco Sacado

Eventos de webhook

Os payloads disponíveis abaixo representam o conteúdo do campo data.

Evento	Descrição
receivables.calculated-fees	Curva de taxas publicada ou atualizada.
receivables.changed-status	Status de um recebível atualizado.

receivables.calculated-fees

{
  "taxIds": [
    "00006000000100"
  ],
  "product": "Cartao",
  "strategyId": "72e4d0db-841c-4bcd-9750-98e333507f67",
  "strategyName": "Estratégia padrão",
  "currency": "BRL",
  "feesCurve": [
    {
      "baseDate": "2026-08-12",
      "settlementDate": "2026-09-12",
      "monthlyFee": 0.0125,
      "totalFee": 0.0125
    }
  ]
}

receivables.changed-status

{
  "id": 0,
  "identification": "5120070562",
  "trades": [
    {
      "id": "string",
      "contractNumber": "123-12345",
      "disbursedAmount": 0,
      "disbursementDate": "2026-08-21"
    }
  ],
  "maturityDate": "2026-08-21",
  "status": "Aprovado",
  "payeeTaxId": "string",
  "payerTaxId": "string",
  "borderoTrackingId": "3382cc6f-1c59-4423-b364-c837deaf110d",
  "motivos": ["string"],
  "invoiceIdentification": "string",
  "nettedPaymentIdentification": "string",
  "eventTimestamp": "2026-08-21T18:41:33.159Z"
}