Empréstimos
- Empréstimos
- GETObter empréstimo
- GETListar empréstimos
- GETPesquisar empréstimos
- GETListar parcelas
- GETListar passos da esteira de empréstimos
- POSTAtualizar empréstimo
- POSTCriar empréstimo
- POSTCancelar empréstimo
- POSTAnular empréstimo
- POSTMarcar empréstimo como expirado
- POSTAlterar o estado de um empréstimo para aberto
- POSTDesembolsar empréstimo
- POSTCriar transação
- POSTCriar parcela
- POSTMarcar empréstimo como pendente
- POSTAnexar arquivo ao empréstimo
- POSTAssinar empréstimo
- DELExcluir empréstimo
- DELDesanexar arquivo do empréstimo
- GET
- Políticas de crédito
- Esteira
- Produtos
- Ofertas
- Parcelas
Empresas
- Empresas
- Grupos de empresas
- Operadores
- Permissões
- Métodos de pagamento
Clientes
- Clientes
- Funcionários
Fundos
- Fundos
Eventos
- Eventos
- Assinaturas
- Webhooks externos
- Notificações
Cobrança
- Itens da fatura
- Intenções de pagamento
- Faturas
Arquivos
- Links de arquivos
- Arquivos
Configurações
- Temas
- Chaves da API
- Configurações
Entidades
- Entidade de dados
- Documentos
Automações
- Workflows
Modelos
- Modelos
Criar transação
Criar uma transação.
curl --request POST \
--url https://api.base39.io/v1/loans/{loan}/transactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"amount": 123,
"description": "<string>",
"metadata": {}
}'
{
"id": "loan_5f92f01728e009f403d8502e",
"status": "open",
"externalId": "4eeb7525-40c6-45fe-8236-2b731d740fad",
"employment": "<string>",
"customer": "<string>",
"company": "<string>",
"contractNumber": "AB123456789",
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "payment_method"
}
],
"offer": {
"id": "offr_5f92f01728e009f403d8502e",
"disbursementAmount": 123,
"installmentAmount": 123,
"totalAmount": 123,
"interestAmount": 123,
"iofAmount": 123,
"iofAdditionalAmount": 123,
"monthlyCET": 0.02,
"yearlyCET": 0.12,
"monthlyFee": 0.02,
"yearlyFee": 0.12,
"insurance": {
"amount": 123,
"fee": 0.02,
"type": "required",
"number": "<string>",
"insurer": "<string>"
},
"interestType": "<string>",
"creditOperationType": "<string>",
"expectedDisbursementDate": "2023-12-25",
"interestGracePeriod": 123,
"principalGracePeriod": 123,
"numberOfInstallments": 123,
"firstDueDate": "2023-12-25",
"fund": "fund_637b85aaa8e91c82fd053aac",
"product": "prod_637cf14e316408250c0bd067",
"description": "<string>",
"rebates": [
{
"feeType": "tac",
"amountType": "absolute",
"amount": 200,
"description": "<string>"
}
],
"fine": {
"fineRate": 0.02,
"interestBase": "workdays",
"monthlyRate": 0.02
},
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "<string>"
}
],
"creditPolicy": "crpl_637b85aaa8e91c82fd053aac",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
},
"transactions": [
{
"amount": 123,
"description": "<string>",
"createdAt": "2023-12-25"
}
],
"attachments": [
{
"file": "file_6307b6c39f5d3d917009b631",
"linkedAt": "2023-11-07T05:31:56Z"
}
],
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
},
"history": [
{
"description": "<string>",
"status": "open",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
}
],
"signatures": [
{
"signer": "<string>",
"context": {
"id": "sign_5f92f01728e009f403d8502e",
"signedAt": "2023-12-25",
"metadata": {},
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
}
}
}
],
"amountRemaining": 1500,
"amountForPayment": 1487.9,
"isRefinancing": false,
"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.
Headers
Chave única de idempotência para evitar duplicação de requisições.
Path Parameters
ID do empréstimo
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.
Body
Response
Retorna o objeto Loan
se a transação foi criada com sucesso.
Este objeto representa um empréstimo.
curl --request POST \
--url https://api.base39.io/v1/loans/{loan}/transactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"amount": 123,
"description": "<string>",
"metadata": {}
}'
{
"id": "loan_5f92f01728e009f403d8502e",
"status": "open",
"externalId": "4eeb7525-40c6-45fe-8236-2b731d740fad",
"employment": "<string>",
"customer": "<string>",
"company": "<string>",
"contractNumber": "AB123456789",
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "payment_method"
}
],
"offer": {
"id": "offr_5f92f01728e009f403d8502e",
"disbursementAmount": 123,
"installmentAmount": 123,
"totalAmount": 123,
"interestAmount": 123,
"iofAmount": 123,
"iofAdditionalAmount": 123,
"monthlyCET": 0.02,
"yearlyCET": 0.12,
"monthlyFee": 0.02,
"yearlyFee": 0.12,
"insurance": {
"amount": 123,
"fee": 0.02,
"type": "required",
"number": "<string>",
"insurer": "<string>"
},
"interestType": "<string>",
"creditOperationType": "<string>",
"expectedDisbursementDate": "2023-12-25",
"interestGracePeriod": 123,
"principalGracePeriod": 123,
"numberOfInstallments": 123,
"firstDueDate": "2023-12-25",
"fund": "fund_637b85aaa8e91c82fd053aac",
"product": "prod_637cf14e316408250c0bd067",
"description": "<string>",
"rebates": [
{
"feeType": "tac",
"amountType": "absolute",
"amount": 200,
"description": "<string>"
}
],
"fine": {
"fineRate": 0.02,
"interestBase": "workdays",
"monthlyRate": 0.02
},
"cashout": [
{
"amount": 123,
"paymentMethod": "<string>",
"type": "<string>"
}
],
"creditPolicy": "crpl_637b85aaa8e91c82fd053aac",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
},
"transactions": [
{
"amount": 123,
"description": "<string>",
"createdAt": "2023-12-25"
}
],
"attachments": [
{
"file": "file_6307b6c39f5d3d917009b631",
"linkedAt": "2023-11-07T05:31:56Z"
}
],
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
},
"history": [
{
"description": "<string>",
"status": "open",
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z"
}
],
"signatures": [
{
"signer": "<string>",
"context": {
"id": "sign_5f92f01728e009f403d8502e",
"signedAt": "2023-12-25",
"metadata": {},
"context": {
"ip": "<string>",
"headers": {},
"fingerprint": "<string>",
"geolocation": [
"<string>"
]
}
}
}
],
"amountRemaining": 1500,
"amountForPayment": 1487.9,
"isRefinancing": false,
"metadata": {},
"createdAt": "2023-08-25T22:38:41.134Z",
"updatedAt": "2023-08-25T22:38:41.134Z",
"deleted": false
}