Listar configurações

GET 
/v1/settings

Retorna todas as configurações.

Request

Query Parameters

section string

Um filtro com base nas seções da configuração. O valor deve ser uma string ou uma lista separada por vírgula.

Examples:

single

Valor único

Example: flags

list

Lista

Example: flags,secrets

product string

Retorna a junção das configurações do tenant junto com as configurações de produtos.

company string

Retorna a junção das configurações do tenant junto com as configurações da empresa.

Responses

200

Um objeto contendo todas as configurações.

application/json

Schema

Schema

steps

object

Configurações de fluxos em modo passo a passo do empréstimos.

property name*

SettingsSteps

Configurações do modo passo a passo

title string

Título identificador do passo.

type string

Tipo identificador do passo.

Possible values: [signature, disburse, document_verification, pass, valid_employment, custom_request, create_documents, attachments_to_request, unico]

methodData

object

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.

anyOf

signature

Configuração do responsável pela assinatura.

type string

Tipo responsável pela assinatura.

Possible values: [operator, customer]

role string

Papel assumido.

Possible values: [approver, financial, administrator, backoffice]

Example: approver

document_verification

Tipo de documento para verificação.

purpose string

Propósito

Possible values: [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]

valid_employment

Configuração para validação de employment.

createdBy string

Definição de quem deveria ter criado o employment.

Possible values: [customer, operator]

custom_request

Configuração para realizar a request customizável.

url stringrequired

Url a ser chamada.

Example: https://api.example.com

headers object

Valor do header Authorization

create_documents

Configuração para criar documentos.

documents

object[]

Documentos criados após a criação do empréstimo, exemplos: ccb, seguro, etc…

Array [

purpose string

Possible values: [ccb, signature, insurance]

engine

object

type string

Template engine usado para gerar documentos.

Possible values: [google]

options

object

template string

Template utilizado no engine para gerar o documento.

]

unico

Configuração de integração com a unico.io.

minScore number

Score mínimo aceito na validação de identidade. Esta propriedade somente será utilizada se o resultado da validação da biometria UNICO não for conclusiva. Para maiores informações, consulte o funcionamento do score.

Possible values: >= -100 and <= 100

Example: 70

attachments_to_request

Tipo de anexos para verificação.

purpose string[]

Possible values: [account_requirement, identity_document, additional_verification, selfie, identity_document_front, identity_document_back, pay_stub, proof_of_address]

needs string[]

Array de dependência (slugs) entre os passos necessarios para que esse seja executado.

slug string

Identificador único do passo.

hooks

object

Definição de hooks da esteira.

onFailure

object[]

Lista de ações que serão executadas se um passo da esteira falhar.

Array [

action string

Possible values: [void_loan, cancel_loan]

Example: ["void_loan"]

description string

Example: Ação de cancelamento de empréstimo.

]

onStart

object[]

Lista de ações que serão executadas ao iniciar um passo da esteira.

Array [

action string

Possible values: [mark_loan_as_pending]

Example: ["mark_loan_as_pending"]

description string

Example: Marcar o empréstimo como pendente.

]

disbursements

object

insurance

object

comboId stringrequired

Identificador do combo de produto.

productId stringrequired

Identificador do produto.

maxAmount doublerequired

Valor máximo de cobertura do seguro.

type string

Tipo de conta bancária.

Possible values: [base39, client_account]

account

object

anyOf

client_account

holderName stringrequired

O nome da pessoa ou empresa que possui a conta bancária.

holderDocument stringrequired

O documento da entidade que detém a conta. Pode ser CPF ou CNPJ.

bankCode stringrequired

Código COMPE da Instituição Financeira.

branch stringrequired

A agência da conta bancária.

number stringrequired

O número da conta bancária. Deve ser uma conta corrente ou conta poupança.

digit stringrequired

property name*

SettingsDisbursements

Configurações de desembolso.

type stringrequired

Possible values: [qitech, bv, custom, mock, banco_paulista]

credentials

object

anyOf

QITech

url stringrequired

URL do parceiro de bancarização.

Example: https://api-auth.sandbox.qitech.app

apiKey stringrequired

Chave de acesso à api do parceiro de bancarização.

Example: abcdef12345

privateKey stringrequired

Chave privada do parceiro de bancarização.

Example: -----BEGIN RSA PRIVATE KEY-----\nMIIBOgIBAAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9oQXSxo5c1iL+YC+dr4jm\nkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQJAMtWs6j3ytIbJ4CofHAy5\nD+aiZ+QqGMi8DqHl8spBNYYPlwNhpze2Ge9YnCx2Vkz46vLpP5KDAmQR8Vogea8E\nAQIhAOZCyFD4PgUNg02UiV9eBsFG61qlOHBZBMmWnAKKe7uBAiEAwNMBhsc6Wsl8\nyW7qYMtLljpBUdy0C5vEu0JKdvZYVnkCIAJ/gPrX5pxZbC5ASUk+lOYt5cnC9xzI\n6nNhbendJMCBAiBZasAfdw3ZgewLIRMxFbUUkikuRBF9/JsLV19esTgfyQIhANv2\n+R0S0bzykeZ5QZF+getN1TfdEviOxFnTu+my50DL\n-----END RSA PRIVATE KEY-----

publicKey stringrequired

Chave pública do parceiro de bancarização.

Example: -----BEGIN PUBLIC KEY-----\nMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9\noQXSxo5c1iL+YC+dr4jmkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQ==\n-----END PUBLIC KEY-----

ccbPrefix stringrequired

Prefixo da CCB.

passphrase string

Frase secreta.

BV

clientId stringrequired

Client ID.

clientSecret stringrequired

Client Secret.

fetchRebates boolean

incluir TC nas propostas da BV.

Custom

url stringrequired

URL do fundo.

Example: https://api.example.com

headers object

Valor do header Authorization

Banco Paulista

promoter string

Promotora

Example: 9999

storeChain string

Rede de Lojas

Example: 9999

store string

Loja

Example: 9999

product string

Produto

Example: 9999

plan string

Plano

Example: 9999

user string

Nome de usuário

Example: New User

supportedPaymentMethods string[]

Possible values: [invoice, boleto, paymentMethod.pix, paymentMethod.bankAccount]

disbursementDay string

Possible values: [sameDay, nextWorkDay]

flags

object

Configurações de flags.

showCancelButtonBeforeDisbursement boolean

Mostrar o botão de cancelar antes do desembolso.

Example: true

automaticChargeback boolean

Reembolsar automaticamente valores pagos a mais pelos clientes

Example: true

notifications

object

Configurações de serviços provedores de notificações.

email

object

Configurações do provedor de notificações via e-mail.

provider string

Provedor utilizado para envio de email.

Possible values: [default, test_only, smtp]

config

object

Objeto para definir a configuração para utilização do provedor de email.

email string

E-mail utilizado para o envio.

host string

Nome do host ou endereço IP ao qual se conectar.

port number

Porta de conexão SMTP.

username string

Nome de usuário do servidor SMTP.

password string

Senha de usuário do servidor SMTP.

sms

object

Configurações do provedor de notificações via SMS.

provider string

Provedor utilizado para envio de SMS.

Possible values: [test_only, infobip]

config

object

Objeto para definir a configuração para utilização do provedor de SMS.

token string

Token para conexão com a infobip.

basePath uri

Url base do provedor.

whatsapp

object

Configurações do provedor de notificações via WhatsApp.

provider string

Provedor utilizado para envio de mensagens via WhatsApp.

Possible values: [test_only, default, twilio]

config

object

Objeto para definir a configuração para utilização do provedor de mensagens via WhatsApp.

account string

Conta da twilio.

token string

Token para conexão com a twilio.

sender string

Número de telefone base para envio da mensagem.

validations

object

Configurações de validadores.

pix

object

Configuração do provedor de PIX.

type string

Tipo das credenciais do provedor de PIX.

Possible values: [qitech, custom, mock]

credentials

object

Definição de credênciais do provedor de serviço PIX.

anyOf

QITech

Credênciais de QITech.

url stringrequired

URL do parceiro de bancarização.

Example: https://api-auth.sandbox.qitech.app

apiKey stringrequired

Chave de acesso à api do parceiro de bancarização.

Example: abcdef12345

privateKey stringrequired

Chave privada do parceiro de bancarização.

Example: -----BEGIN RSA PRIVATE KEY-----\nMIIBOgIBAAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9oQXSxo5c1iL+YC+dr4jm\nkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQJAMtWs6j3ytIbJ4CofHAy5\nD+aiZ+QqGMi8DqHl8spBNYYPlwNhpze2Ge9YnCx2Vkz46vLpP5KDAmQR8Vogea8E\nAQIhAOZCyFD4PgUNg02UiV9eBsFG61qlOHBZBMmWnAKKe7uBAiEAwNMBhsc6Wsl8\nyW7qYMtLljpBUdy0C5vEu0JKdvZYVnkCIAJ/gPrX5pxZbC5ASUk+lOYt5cnC9xzI\n6nNhbendJMCBAiBZasAfdw3ZgewLIRMxFbUUkikuRBF9/JsLV19esTgfyQIhANv2\n+R0S0bzykeZ5QZF+getN1TfdEviOxFnTu+my50DL\n-----END RSA PRIVATE KEY-----

publicKey stringrequired

Chave pública do parceiro de bancarização.

Example: -----BEGIN PUBLIC KEY-----\nMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9\noQXSxo5c1iL+YC+dr4jmkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQ==\n-----END PUBLIC KEY-----

ccbPrefix stringrequired

Prefixo da CCB.

passphrase string

Frase secreta.

Custom

Credênciais customizadas do provedor PIX.

url stringrequired

URL do serviço provedor de PIX.

Example: https://api.example.com

headers object

Par de chave-valor usado como cabeçalho do serviço de validação.

Example: Authorization: Bearer value

Mock

Credênciais de mock(objeto que imita comportamento) do provedor PIX.

url string

URL do serviço provedor de PIX.

Example: https://api.base39.io/v1/mocks

headers object

Par de chave-valor usado como cabeçalho do serviço de validação.

Example: Authorization: Bearer value

loans

object

Configurações de empréstimos

concurrency

object[]

Configurações referentes às limitações na criação de loans simultâneos.

Array [

quantityAllowed number

Número de empréstimos permitidos.

status string[]

Status a ser considerado na limitação da criação dos empréstimos.

Possible values: [open, disbursed, disbursing, repaid, void, canceled, expired, pending, draft]

]

conditions

object[]

Termos e Condições do empréstimo.

Array [

title string

Texto identificador da condição de empréstimos.

content string

Conteúdo da condição.

]

refin

object

Configurações referentes à refinanciamento de empréstimos.

minDays number

Número mínimo de dias necessário para que uma proposta possa ser refinanciada, contado a partir da criação da proposta.

expireInDays number

Número de dias para expiração de um empréstimo, contando a partir da data de criação.

invoices

object

Configurações de faturas

payOff

object

Configurações de quitação.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

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).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

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.

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

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.

Possible values: [absolute]

Example: absolute

amount number

Dia exato ou a quantidade de dias.

Possible values: >= 1 and <= 28

Example: 1

updateInvoiceItemOnInsert boolean

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.

Example: true

customerRecurring

object

Configuração de recorrência de fatura.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

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).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

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.

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Tipo de dias usado no fechamento da fatura. Absoluto representa uma composição de um determinado dia somado ao valor definido em amount. O resultado dessa operação será considerado a data para fechamento da fatura. Exemplo: dia 5 + amount (3) 08/mês/ano.

Possible values: [absolute]

Example: absolute

amount number

Quantidade de dias para fechamento da fatura.

Possible values: >= 1 and <= 28

Example: 10

create

object

Definição de regras para geração de fatura.

autoCreate boolean

Define se a fatura deve ser criada automaticamente.

Example: true

updateInvoiceItemOnInsert boolean

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.

Example: false

companyRecurring

object

Configuração de recorrência de fatura.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

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).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

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.

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Tipo de dias usado no fechamento da fatura. Representa o dia do mês (1 até 28) para fechamento da fatura.

Possible values: [static]

Example: static

amount number

Dia do mês para fechamento da fatura.

Possible values: >= 1 and <= 28

Example: 10

create

object

Definição de regras para geração de fatura.

cutoffDay number

Define o dia limite para a edição de uma fatura, antes que ela seja fechada.

Example: 25

autoCreate boolean

Define se a fatura deve ser criada automaticamente.

Example: true

updateInvoiceItemOnInsert boolean

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.

Example: false

autoMoneyRelocation boolean

Se verdadeiro, o sistema irá fazer o remanejo automático de dinheiro entre as parcelas que possuem valor pago excedente.

locales

object

Estes são textos personalizáveis da aplicação, que aceitam campos chave-valor. É importante notar que nesta página de documentação, você pode criar até três níveis de objetos aninhados. No entanto, ao realizar chamadas fora desta página de documentação, o suporte é estendido para além de três níveis.

property name*

object

recaptcha

object

Configurações do recaptcha. Estas configurações não são utilizadas em rotinas de Core, cabendo ao Core apenas responsabilidade de persistência e disponilidade de dados.

siteKey string

Segredo para utilizar o recaptcha

employments

object

Configurações de vínculos empregatícios

expireInDays integer

Quantidade de dias para expirar o vínculo empregatício.

Example: 30

domains

object

Configurações de domínios customizados

company string

URL do Portal Empresa.

customer string

URL do Portal Cliente.

backoffice string

URL do Backoffice.

queues

object[]

Configurações de fila

Array [

name string

Nome da fila

Example: Fila de propostas

query string

Uma string de busca que permite criar filtros personalizados. Filtros permitidos customer, company, id, status, attachment, external_id e created_at. Para os campos que são string ou um conjunto de string separadas por vírgula o único comparador válido é :. Para campos do tipo data ou números são permitidos os comparadores =, >, <, >= e <=. É possível utilizar o operador AND para concatenar mais de uma query e o operador OR. Veja mais em Pesquisa

Example: status:open OR status:pending AND customer.id:`${customer.id}` AND created_at<`${date}` AND company.document:`${company.document}`

]

installments

object

Configurações de parcelas.

dueDate

object

Configuração de data de vencimento.

type string

Tipo de data de vencimento. absolute representa o dia exato do mês, static representa o dia + amount.

Possible values: [absolute, static]

amount integer

Quantidade de dias para vencimento.

Example: 10

graceDate

object

Configuração de data de carência.

type string

Tipo de data de carência.

Possible values: [days, months]

amount integer

Quantidade para carência.

Example: 10

skipInstallments integer

Quantidade de parcelas que serão desconsideradas até a cobrança.

Example: 1

Example (from schema)

{
  "steps": {},
  "disbursements": {
    "insurance": {
      "comboId": "string",
      "productId": "string",
      "maxAmount": 0,
      "type": "base39"
    }
  },
  "flags": {
    "showCancelButtonBeforeDisbursement": true,
    "automaticChargeback": true
  },
  "notifications": {
    "email": {
      "provider": "default",
      "config": {
        "email": "string",
        "host": "string",
        "port": 0,
        "username": "string",
        "password": "string"
      }
    },
    "sms": {
      "provider": "test_only",
      "config": {
        "token": "string",
        "basePath": "string"
      }
    },
    "whatsapp": {
      "provider": "test_only",
      "config": {
        "account": "string",
        "token": "string",
        "sender": "string"
      }
    }
  },
  "validations": {
    "pix": {
      "type": "qitech"
    }
  },
  "loans": {
    "concurrency": [
      {
        "quantityAllowed": 0,
        "status": [
          "open"
        ]
      }
    ],
    "conditions": [
      {
        "title": "string",
        "content": "string"
      }
    ],
    "refin": {
      "minDays": 0
    },
    "expireInDays": 0
  },
  "invoices": {
    "payOff": {
      "fine": {
        "amount": 0.02,
        "daysToStart": 1
      },
      "interest": {
        "amount": 0.01,
        "daysToStart": 1
      },
      "allowOverduePayment": true,
      "daysUntilDue": {
        "type": "absolute",
        "amount": 1
      },
      "updateInvoiceItemOnInsert": true
    },
    "customerRecurring": {
      "fine": {
        "amount": 0.02,
        "daysToStart": 1
      },
      "interest": {
        "amount": 0.01,
        "daysToStart": 1
      },
      "allowOverduePayment": true,
      "daysUntilDue": {
        "type": "absolute",
        "amount": 10
      },
      "create": {
        "autoCreate": true
      },
      "updateInvoiceItemOnInsert": false
    },
    "companyRecurring": {
      "fine": {
        "amount": 0.02,
        "daysToStart": 1
      },
      "interest": {
        "amount": 0.01,
        "daysToStart": 1
      },
      "allowOverduePayment": true,
      "daysUntilDue": {
        "type": "static",
        "amount": 10
      },
      "create": {
        "cutoffDay": 25,
        "autoCreate": true
      },
      "updateInvoiceItemOnInsert": false
    },
    "autoMoneyRelocation": true
  },
  "locales": {
    "Brazil": {
      "states": {
        "MG": {
          "name": "Minas Gerais",
          "slug": "MG"
        }
      }
    }
  },
  "recaptcha": {
    "siteKey": "string"
  },
  "employments": {
    "expireInDays": 30
  },
  "domains": {
    "company": "string",
    "customer": "string",
    "backoffice": "string"
  },
  "queues": [
    {
      "name": "Fila de propostas",
      "query": "status:open OR status:pending AND customer.id:`${customer.id}` AND created_at<`${date}` AND company.document:`${company.document}`"
    }
  ],
  "installments": {
    "dueDate": {
      "type": "absolute",
      "amount": 10
    },
    "graceDate": {
      "type": "days",
      "amount": 10
    },
    "skipInstallments": 1
  }
}

Loading...