Referências
- Empréstimos
- Empresas
- Políticas de crédito
- Esteira
- Clientes
- Funcionários
- Fundos
- Eventos
- Produtos
- Ofertas
- Assinaturas
- Grupos de empresas
- Operadores
- Permissões
- Itens da fatura
- Intenções de pagamento
- Métodos de pagamento
- Parcelas
- Webhooks externos
- Links de arquivos
- Arquivos
- Faturas
- Temas
- Chaves da API
- Configurações
- Entidade de dados
- Documentos
- Workflows
- Notificações
- Modelos
Obter produto
Retorna um objeto Product
curl --request GET \
--url https://api.base39.io/v1/products/{product} \
--header 'Authorization: Bearer <token>'
{
"id": "prod_5f92f01728e009f403d8502e",
"slug": "consignado",
"status": "active",
"name": "Empréstimo consignado",
"description": "<string>",
"settings": {
"steps": {
"title": "<string>",
"type": "signature",
"methodData": {
"schema": {
"type": "operator",
"role": "approver"
}
},
"needs": [
"<string>"
],
"slug": "<string>",
"hooks": {
"onFailure": [
"void_loan"
]
},
"onStart": [
"mark_loan_as_pending"
]
},
"loans": {
"concurrency": [
{
"quantityAllowed": 123,
"status": [
"open"
]
}
],
"conditions": [
{
"title": "<string>",
"content": "<string>"
}
],
"maxAge": 65,
"minAge": 18,
"minimumWage": 2500
},
"invoices": {
"payOff": {
"fine": {
"amount": 0.02,
"daysToStart": 1
},
"interest": {
"amount": 0.01,
"daysToStart": 1
},
"allowOverduePayment": true,
"daysUntilDue": {
"type": "absolute",
"amount": 1
},
"updateInvoiceItemOnInsert": true
}
},
"products": {
"eligibility": {
"type": "static",
"options": {
"url": "<string>",
"headers": {},
"metadata": {}
}
},
"offer": {
"type": "online",
"options": {
"monthlyFee": 1.99,
"numberOfInstallments": [
12,
24
],
"daysUntilDisbursement": 7,
"monthsUntilFirstDueDate": 1,
"creditOperationType": "CCB",
"rebates": [
{
"feeType": "registration",
"amountType": "absolute",
"amount": 250,
"description": "Tarifa de cadastro"
}
],
"insurance": {
"amount": 0,
"fee": 1.73,
"type": "required",
"number": "123456",
"insurer": "Cia de Seguros"
}
}
},
"documents": {
"toCreate": [
{
"purpose": "account_requirement",
"method": "google",
"methodData": {
"template": "<string>"
}
}
],
"toRequest": [
{
"purpose": "account_requirement",
"name": "crédito consignado",
"owner": "customer",
"expireInDays": 30
}
]
},
"disbursement": "custom"
}
},
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z",
"updatedAt": "2023-08-25T22:38:41.134Z",
"deleted": false
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
ID do produto
Query Parameters
Expande as referências.
Pode ser um valor único ou uma lista separada por vírgula (csv) de referências retornadas neste endpoint.
Uma lista separada por vírgulas de atributos a serem incluídos na resposta. Isso pode ser usado para solicitar campos que normalmente não são retornados em uma resposta padrão.
Esteja ciente de que especificar este parâmetro terá o efeito que nenhum dos campos padrão seja retornado na resposta, a menos que seja explicitamente especificado.
Response
Este objeto representa um produto.
Identificador exclusivo para o objeto.
"prod_5f92f01728e009f403d8502e"
Deve ser uma string sem espaços ou caracteres especiais. É utilizada para agrupar produtos do mesmo tipo.
"consignado"
Status do produto. Se inativo, não será exibido no Portal do Cliente.
active
, inactive
Nome do produto que será exibido aos usuários
"Empréstimo consignado"
Pequena descrição sobre o produto. Pode ser exibido na página inicial do Portal do Cliente.
Configurações do modo passo a passo
Título identificador do passo.
Tipo identificador do passo.
signature
, disburse
, document_verification
, pass
, valid_employment
, custom_request
, create_documents
, attachments_to_request
, unico
, unico_check
Objeto que contém dados específicos para o tipo de etapa.
Por exemplo, se a etapa for do tipo signature
, este objeto conterá os dados necessários para a assinatura do documento.
Configuração do responsável pela assinatura.
Array de dependência (slugs) entre os passos necessarios para que esse seja executado.
Slug do passo (step) dependente.
Identificador único do passo.
Definição de hooks da esteira.
Lista de ações que serão executadas se um passo da esteira falhar.
void_loan
, cancel_loan
["void_loan"]
Lista de ações que serão executadas ao iniciar um passo da esteira.
mark_loan_as_pending
["mark_loan_as_pending"]
Configurações de empréstimos
Configurações referentes às limitações na criação de loans simultâneos.
Idade máxima do cliente para solicitar um empréstimo.
65
Idade mínima do cliente para solicitar um empréstimo.
18
Piso salarial necessário para solicitar um empréstimo.
2500
Configurações de faturas
Configurações de quitação.
Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.
Valor da multa representado em base decimal. A Multa é cobrada uma única vez independente do número de dias de vencimento. O valor máximo para multa é de 2% (0.02).
0.02
Quantidade de dias após o vencimento que a multa começará a incidir.
1
Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.
Valor de juros representado em base decimal e ao mês. O valor máximo permitido é 1% (0.01). Os Juros são definidos ao mês, mas calculo para o pagamento após o vencimento converte para juros ao dia e aplica a quantidade de dias em atraso.
0.01
Quantidade de dias após o vencimento que juro começará a incidir.
1
Permite pagamento da fatura após o vencimento.
true
Definição de regras para o fechamento da fatura.
Tipo de dias. Absoluto representa uma composição de um determinado dia somado ao valor definido em amount
. O resultado dessa soma será considerado a data para fechamento da fatura. Exemplo: dia 5 + amount (3) 08/mês/ano.
absolute
"absolute"
Dia exato ou a quantidade de dias.
1
Define se no ato de criar o item de fatura será calculado automaticamente descontos/multa para a fatura em contexto. Os valores base usados nesse cálculos são originados de payOff
, customerRecurring
ou companyRecurring
.
true
Configurações de produtos
Define como a elegibildiade será calculada.
O tipo mock
deve ser usado apenas para testes.
Use dynamic
para integrar com uma API externa.
Para produtos que não exigem verificações, use o tipo static
.
static
, dynamic
, mock
"static"
Use o tipo online
quando o processamento do produto e oferta serão feitos pela plataforma. Use offline
para redirecionamento externo.
online
, offline
, mock
"online"
Taxa de juros mensal
1.99
Opções de parcelas
[12, 24]
Dias até o desembolso. Essa informação é usada para calcular a oferta.
7
Quantidade de meses de carência até o vencimento da primeira parcela.
1
Tipo da operação de crédito.
"CCB"
Lista de valores adicionais do empréstimo
Documentos criados após a criação do empréstimo, exemplos: ccb, seguro, etc… ATENÇÃO: Este campo entrará em desuso em breve, utilize os steps para definir quais documentos deverão ser criados.
account_requirement
, org_icon
, org_logo
, identity_document
, additional_verification
, selfie
, ccb
, signature
, ccb_signed
, insurance
, identity_document_front
, identity_document_back
, pay_stub
, proof_of_address
, insurance_signature
, insurance_signed
Template engine usado para gerar documentos.
google
documentos solicitados durante o fluxo de contratação, exemplos: RG, CPF, Holerite, Comprovante de endereço…
account_requirement
, org_icon
, org_logo
, identity_document
, additional_verification
, selfie
, ccb
, signature
, ccb_signed
, insurance
, identity_document_front
, identity_document_back
, pay_stub
, proof_of_address
, insurance_signature
, insurance_signed
Nome do documento.
"crédito consignado"
Identificador do responsável por solicitar/criar o documento.
customer
, operator
"customer"
Número de dias até a expiração.
x >= 1
30
Nome do método de desembolso configurado na API de Configurações
"custom"
Conjunto de pares de valores-chave que podem ser anexados a um objeto. Isso pode ser útil para armazenar informações adicionais sobre o objeto em um formato estruturado.
Data de criação do objeto
"2023-08-25T22:38:41.134Z"
Data de alteração do objeto
"2023-08-25T22:38:41.134Z"
Identifica se o objeto foi excluído. Se verdadeiro, o objeto foi excluído.
false
curl --request GET \
--url https://api.base39.io/v1/products/{product} \
--header 'Authorization: Bearer <token>'
{
"id": "prod_5f92f01728e009f403d8502e",
"slug": "consignado",
"status": "active",
"name": "Empréstimo consignado",
"description": "<string>",
"settings": {
"steps": {
"title": "<string>",
"type": "signature",
"methodData": {
"schema": {
"type": "operator",
"role": "approver"
}
},
"needs": [
"<string>"
],
"slug": "<string>",
"hooks": {
"onFailure": [
"void_loan"
]
},
"onStart": [
"mark_loan_as_pending"
]
},
"loans": {
"concurrency": [
{
"quantityAllowed": 123,
"status": [
"open"
]
}
],
"conditions": [
{
"title": "<string>",
"content": "<string>"
}
],
"maxAge": 65,
"minAge": 18,
"minimumWage": 2500
},
"invoices": {
"payOff": {
"fine": {
"amount": 0.02,
"daysToStart": 1
},
"interest": {
"amount": 0.01,
"daysToStart": 1
},
"allowOverduePayment": true,
"daysUntilDue": {
"type": "absolute",
"amount": 1
},
"updateInvoiceItemOnInsert": true
}
},
"products": {
"eligibility": {
"type": "static",
"options": {
"url": "<string>",
"headers": {},
"metadata": {}
}
},
"offer": {
"type": "online",
"options": {
"monthlyFee": 1.99,
"numberOfInstallments": [
12,
24
],
"daysUntilDisbursement": 7,
"monthsUntilFirstDueDate": 1,
"creditOperationType": "CCB",
"rebates": [
{
"feeType": "registration",
"amountType": "absolute",
"amount": 250,
"description": "Tarifa de cadastro"
}
],
"insurance": {
"amount": 0,
"fee": 1.73,
"type": "required",
"number": "123456",
"insurer": "Cia de Seguros"
}
}
},
"documents": {
"toCreate": [
{
"purpose": "account_requirement",
"method": "google",
"methodData": {
"template": "<string>"
}
}
],
"toRequest": [
{
"purpose": "account_requirement",
"name": "crédito consignado",
"owner": "customer",
"expireInDays": 30
}
]
},
"disbursement": "custom"
}
},
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z",
"updatedAt": "2023-08-25T22:38:41.134Z",
"deleted": false
}