Segurança
BTG IdO 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 Crédito Solar deve ser gerado usando o Client Credentials.
É necessário escolher um dos seguintes escopos:
| Escopo | Descrição |
|---|---|
empresas.btgpactual.com/solar-credit | Permite enviar pré-analises e consultas, incluindo de integrador/distribuidor. |
empresas.btgpactual.com/solar-credit.readonly | Permite enviar apenas pré-analises e consultas de integrador/distribuidor. |
Eventos de webhook
Os payloads disponíveis abaixo representam o conteúdo do campo data, seguindo o formato do envio descrito em Eventos.
| Evento | Descrição |
|---|---|
credito-solar.analyzed | Crédito analisado |
credito-solar.changed-status | Mudança no status da análise |
credito-solar.analyzed
{
"taxId": "00000000000",
"effectiveness": "PreApproved",
"productLimit": 50000.0,
"limitDateExpire": "2024-03-13T00:00:00",
"product": "Solar",
"approvedPaymentTerms": [
{
"gracePeriod": 3,
"installmentsMin": 96,
"installmentsMax": 96,
"monthlyRate": 0.0162,
"yearRate": 0.21,
"monthCet": 0.02,
"yearCet": 0.22,
"amount": 130000.0,
"instalmentAmount": 1350.0
}
],
"originId": "93806596-15dd-4b80-a222-73deeb70d519",
"description": "O valor das parcelas mensais é estimado e poderá variar conforme data de assinatura do contrato de empréstimo, bem como da data escolhida para pagamento das prestações.\nA liberação dos recursos estará condicionada à prévia concordância dos termos do financiamento entre as partes e negociação e preparação de toda a documentação necessária em condições satisfatórias ao BTG Pactual, bem como da análise cadastral completa do Cliente e da perfeita formalização das garantias.\nA presente proposta é válida pelo prazo de 5 (cinco) dias úteis contados da presente data."
}credito-solar.changed-status
{
"taxId": "00000000000",
"status": "DocumentsAnalysis",
"originId": "93806596-15dd-4b80-a222-73deeb70d519",
"occurrenceDate": "2023-12-11T16:26:29.072171",
"productType": "Solar"
}Status possíveis:
| Descrição | Status Antigo | Status Novo |
|---|---|---|
| Aguardando análise interna dos dados cadastrais | EM_CADASTRO | AccountCreationAnalysis |
| Dados cadastrais foram pendenciados, necessário ajuste das informações | EM_CADASTRO | AccountCreationDataAdjustment |
| Abertura de conta reprovada | DOCUMENTOS_REJEITADOS | AccountCreationDisapproved |
| Proposta expirou na etapa de abertura de conta | VENCIDO | AccountCreationExpired |
| Iniciando abertura de conta do cliente | EM_CADASTRO | AccountCreationStartingOnboarding |
| Pendente envio de formulário de dados cadastrais | EM_CADASTRO | AccountCreationPendingSubmit |
| Pendente assinatura do termo de abertura de conta | EM_CADASTRO | AccountCreationWaitingSignatures |
| Valor do crédito desembolsado | CONCLUIDO | ContractingOperationDisbursed |
| Aguardando contratação do crédito pelo cliente | AGUARDANDO_DESEMBOLSO | ContractingWaitingOperation |
| Operação contratada, aguardando desembolso do crédito | AGUARDANDO_DESEMBOLSO | ContractingWaitingDisbursement |
| Aguardando assinaturas para liberação do crédito | AGUARDANDO_DESEMBOLSO | ContractingWaitingSignatures |
| Proposta foi reprovada na etapa de contratação | DOCUMENTOS_REJEITADOS | ContractingDisapproved |
| Proposta expirou na etapa de contratação | VENCIDO | ContractingExpired |
| Aguardando análise interna dos documentos de comprovação | ANALISE_DOCUMENTACAO | DocumentsAnalysis |
| Documentos foram pendenciados, necessário ajuste das informações | AJUSTE_DOCUMENTACAO | DocumentsDataAdjustment |
| Proposta expirou na etapa de envio de documentos | VENCIDO | DocumentsExpired |
| Pendente envio dos documentos de comprovação das informações da proposta | PENDENTE_DOCUMENTACAO | DocumentsPendingSubmit |
| Documentos foram rejeitados | DOCUMENTOS_REJEITADOS | DocumentsDisapproved |
| Proposta expirou na etapa de análise final de crédito | VENCIDO | FinalProposalExpired |
| Proposta de crédito disponível para aceite do cliente | AGUARDANDO_ACEITE | FinalProposalPendingAccept |
| Aguardando análise interna das notas fiscais | ANALISE_DOCUMENTACAO | InvoicesAnalysis |
| Notas fiscais foram pendenciadas, necessário ajuste das informações | AJUSTE_DOCUMENTACAO | InvoicesDataAdjustment |
| Proposta expirou na etapa de envio de notas fiscais | VENCIDO | InvoicesExpired |
| Pendente liberação do limite do integrador para proposta fluir | N/A | InvoicesPendingLimitAvailability |
| Pendente envio das notas fiscais para análise | ENVIO_NFE | InvoicesPendingSubmit |
| Notas fiscais foram rejeitadas | DOCUMENTOS_REJEITADOS | InvoicesDisapproved |
| Aguardando análise de crédito interna | EM_ANALISE | LeadViabilityAnalysis |
| Proposta expirou na etapa de análise de viabilidade | VENCIDO | LeadViabilityExpired |
| Pendente envio das informações básicas para a solicitação do crédito | FORMULARIO_PREENCHIMENTO | LeadViabilityPendingSubmit |
| Pendente ajuste das informações básicas para a solicitação do crédito | FORMULARIO_PREENCHIMENTO | LeadViabilityDataAdjustment |
| Proposta reprovada por crédito | REPROVADO_MOTOR | LeadViabilityDisapproved |