Documentação da API Belvo (1.221.0)

Introdução

Alcance novos públicos e converta mais usuários conectando-se fácil e seguramente aos dados financeiros deles, entendendo seu comportamento e possibilitando pagamentos instantâneos com open finance. Através da nossa API, você pode acessar:

Informações Disponíveis e Métodos de Pagamento

A Belvo é uma API de open banking para a América Latina que permite que empresas acessem informações bancárias e fiscais de maneira segura e ágil.

Através da nossa API, você pode acessar:

  • Informações Bancárias no Brasil
  • Informações de Emprego no Brasil
  • Informações de Emprego no México
  • Informações Fiscais no México
  • Informações Fiscais no Chile

Você também pode usar nossa API para realizar pagamentos em:

  • Brasil
  • México

Dicionários de Dados

Se você deseja a documentação de resposta em formato Excel ou CSV, por favor, faça o download a partir do nosso Repositório Público no GitHub: Belvo Open Finance Data Dictionaries.

Nossos arquivos EXCEL e CSV estão adicionalmente localizados em Espanhol e Português (Brasil).

Ambientes

Atualmente, oferecemos dois ambientes: sandbox e produção.

Sandbox

Disponível para:

  • 🟢 Agregação e Enriquecimento
  • ⚪️ Iniciação de Pagamento

Use nosso ambiente Sandbox para construir sua integração. Oferecemos dados fictícios que imitam casos de uso do mundo real, o que significa que você pode testar todos os endpoints, usar o widget e implementar webhooks - exatamente como faria com dados reais!

Tudo o que você precisa para começar com o ambiente Sandbox é obter suas chaves de API. Recomendamos fortemente que você comece a criar sua integração neste ambiente.

Produção

Disponível para:

  • 🟢 Agregação e Enriquecimento
  • 🟢 Iniciação de Pagamento

Depois de testar sua integração no ambiente Sandbox e estar pronto para entrar em operação, você precisará solicitar acesso ao nosso ambiente de Produção. Após solicitar o acesso, nossa equipe de Vendas entrará em contato para agendar uma reunião apenas para garantir que suas necessidades sejam atendidas, e então você precisará passar por um processo de certificação com um de nossos engenheiros para garantir que sua integração esteja funcionando de forma otimizada. Para se preparar para a reunião de certificação, basta seguir nossa lista de verificação de Integração.

Uma vez que sua integração esteja certificada, tudo o que você precisará fazer é:

  • Solicitar chaves de API de Produção (e alterar suas chaves de API do Sandbox no código para estas novas).
  • Alterar a URL base para a qual você faz solicitações de sandbox.belvo.com para api.belvo.com.
  • Se você estiver usando webhooks, certifique-se de definir uma URL de Produção para seus webhooks.

Códigos de Resposta

Usamos o seguinte código de status HTTP na resposta, dependendo do sucesso ou falha:

Código de StatusDescrição
200Sucesso - O conteúdo está disponível no corpo da resposta.
201Sucesso - O conteúdo foi criado com sucesso na Belvo.
204Sucesso - Nenhum conteúdo para retornar.
400Erro de Solicitação Inválida - A solicitação retornou um erro, detalhe no conteúdo.
401Não Autorizado - As credenciais da Belvo fornecidas não são válidas.
404Não Encontrado - O recurso que você tentou acessar não pode ser encontrado.
405Método Não Permitido - O método HTTP que você está usando não é aceito para este recurso.
408Tempo de Solicitação Esgotado - A solicitação expirou e foi encerrada pelo servidor.
428Token MFA Necessário - O token MFA foi exigido pela instituição para conectar.
500Erro Interno do Servidor - O detalhe do erro está disponível no corpo da resposta.

Tratamento de Erros

Os erros da API Belvo são retornados em formato JSON. Por exemplo, um erro pode ser assim:

[
    {
      "request_id": "a6e1c493d7a29d91aed4338e6fcf077d",
      "message": "Este campo é obrigatório.",
      "code": "required",
      "field": "link"
    }
]

Normalmente, uma resposta de erro terá os seguintes parâmetros:

  • request_id: um ID único para a solicitação, você deve compartilhá-lo com a equipe de suporte da Belvo para investigações.
  • message: descrição legível do erro.
  • code: um código único para o erro. Verifique a tabela abaixo para ver como lidar com cada código de erro.
  • field (opcional): O campo específico no corpo da solicitação que tem um problema.

Identificador de Solicitação

Quando você precisar de ajuda com um erro específico, inclua o identificador de solicitação (request_id) em sua mensagem para a equipe de suporte da Belvo. Isso acelerará as investigações e fará com que você volte a funcionar rapidamente.

Códigos de Erro e Solução de Problemas

Para uma lista completa de erros e como solucioná-los, consulte nosso artigo dedicado Tratamento de Erros.

Política de Repetição

Erros 50x

Implemente uma repetição automática exponencial de até cinco tentativas. Recomendamos usar um intervalo base de três segundos com um fator de dois. Por exemplo, a primeira repetição deve ser após três segundos, a segunda repetição após seis segundos (2 * 3), a terceira repetição após 12 segundos (2 * 6), a quarta repetição após 24 segundos (2 * 12) e a quinta repetição após 48 segundos (2 * 24).

Erros 40x

Você não deve tentar novamente fazer solicitações se receber uma resposta 40x, pois isso é um erro do cliente.

A única exceção é o erro "Muitas Sessões", pois isso significa que seu usuário final está acessando a conta de outro navegador ao mesmo tempo. Nesse caso, implemente a mesma política de repetição que para erros 50x.

Campos Obsoletos

Em nosso esquema, você pode ver que um campo foi marcado como deprecated. Isso significa que este campo não é mais mantido pela equipe da Belvo. Você ainda pode receber dados para este campo dependendo da instituição, no entanto, você não deve confiar neste campo.

OpenAPI: campos obrigatórios e anuláveis

Em nossa especificação de API, você verá que alguns parâmetros de resposta terão uma anotação required. De acordo com a especificação OpenAPI, quando um parâmetro de resposta é marcado como required, isso significa que a chave de resposta deve ser retornada. No entanto, o valor desse parâmetro de resposta pode ser null.

📘 Informação

Em resumo, qualquer parâmetro de resposta marcado como obrigatório será retornado pela nossa API, mas o valor pode ser definido como nulo.

Baixar o arquivo de descrição OpenAPI
Idiomas
Servidores
Mock server

https://developers.belvo.com/_mock/pt-br/apis/belvoopenapispec/

Ambiente de Testes

https://sandbox.belvo.com/

Institutions

Uma instituição é uma entidade da qual a Belvo pode acessar informações. Pode ser uma:

  • instituição bancária, como o Nubank Brasil.
  • instituição fiscal, como o Servicio de Administración Tributaria (SAT) no México.
  • instituição de emprego, como o Instituto Mexicano del Seguro Social (IMSS) no México ou o Instituto Nacional do Seguro Social (INSS) no Brasil.
Operações

Widget Access Token

Operações

Consents

Um consentimento é uma permissão dada pelo usuário final para acessar seus dados financeiros na Rede de Open Finance no Brasil.

Operações

Owners

Um proprietário representa a pessoa que tem acesso a um Link e é o proprietário de todas as contas dentro do Link.

Você pode usar este endpoint para obter informações úteis sobre seu cliente, como:

  • seu nome completo
  • informações de contato principais
  • informações sobre o documento de identidade que usaram ao abrir a conta
Operações

Accounts

Uma conta é a representação de uma conta bancária dentro de uma instituição financeira. Um usuário pode ter uma ou mais contas em uma instituição.

Por exemplo, um usuário (ou link) pode ter uma conta corrente, vários cartões de crédito e uma conta de empréstimo.

Consultar as informações da conta de um usuário é útil, pois você pode obter informações sobre:

  • quais tipos de contas o usuário possui.
  • o saldo de cada conta (poupança, corrente, cartão de crédito, empréstimo, etc.).
  • informações detalhadas sobre os gastos com cartão de crédito.
  • a situação atual de quaisquer empréstimos que possam ter.
Operações

Objeto Account (OFDA Brasil)

Detalhes sobre a conta.

idstring(uuid)obrigatório

Identificador único da Belvo para o item atual.

Exemplo: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
linkstring or null(uuid)obrigatório

O link.id ao qual os dados pertencem.

Exemplo: "30cb4806-6e00-48a4-91c9-ca55968576c8"
institutionobjectobrigatório

Detalhes sobre a instituição.

namestring

O nome da instituição, conforme designado pela Belvo.

Exemplo: "erebor_mx_retail"
typestring

O tipo de instituição. Retornamos um dos seguintes valores:

  • bank
  • fiscal
  • employment
Enum"bank""fiscal""employment"
collected_atstring(date-time)obrigatório

O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.

Exemplo: "2022-02-09T08:45:50.406032Z"
created_atstring(date-time)obrigatório

O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo.

Exemplo: "2022-02-09T08:45:50.406032Z"
last_accessed_atstring or null(date-time)obrigatório

O timestamp ISO-8601 do acesso mais recente e bem-sucedido da Belvo à instituição para o link fornecido.

Exemplo: "2021-03-09T10:28:40.000Z"
categorystring or nullobrigatório

O tipo de conta.
Retornamos um dos seguintes valores do enum:

  • ADVANCE_DEPOSIT_ACCOUNT
  • CHECKING_ACCOUNT
  • CREDIT_CARD
  • FINANCING_ACCOUNT
  • INVESTMENT_ACCOUNT
  • INVOICE_FINANCING_ACCOUNT
  • LOAN_ACCOUNT
  • PENSION_FUND_ACCOUNT
  • SAVINGS_ACCOUNT
  • UNCATEGORIZED
Enum"ADVANCE_DEPOSIT_ACCOUNT""CHECKING_ACCOUNT""CREDIT_CARD""FINANCING_ACCOUNT""INVESTMENT_ACCOUNT""INVOICE_FINANCING_ACCOUNT""LOAN_ACCOUNT""PENSION_FUND_ACCOUNT""SAVINGS_ACCOUNT""UNCATEGORIZED"
Exemplo: "CHECKING_ACCOUNT"
balance_typestring or nullobrigatório

Indica se esta conta é um ASSET ou um LIABILITY. Você pode considerar o saldo de um ASSET como positivo, enquanto o saldo de um LIABILITY como negativo.

Exemplo: "ASSET"
overdraftobject or null
typestringobrigatório

O tipo de conta, conforme designado pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "STANDARD_NACIONAL"
subtypestringobrigatório

O subtipo de conta, conforme designado pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "FINANCIAMENTO_HABITACIONAL_SFH"
namestring or nullobrigatório

O nome da conta, conforme fornecido pela instituição.

Exemplo: "Cuenta Perfiles- M.N. - MXN-666"
numberstring or nullobrigatório

O número da conta, conforme designado pela instituição.

Exemplo: "4057068115181"
agencystring or null<= 4 characters^\d{1,4}$obrigatório

O código da agência onde o produto foi aberto.

Exemplo: "6272"
check_digitstring or null<= 2 characters[\w\W\s]*obrigatório

O dígito verificador do número do produto, se aplicável.

Exemplo: "7"
balanceobjectobrigatório

Detalhes sobre os saldos atual e disponível para a conta.

currentnumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O saldo atual é calculado de maneira diferente de acordo com o tipo de conta.

  • 💰 Contas correntes e poupança:

O saldo da conta do usuário no timestamp collected_at.

  • 💳 Cartões de crédito:

O valor que o usuário gastou no período de faturamento atual do cartão (consulte credit_data.cutting_date para informações sobre quando o período de faturamento atual termina).

  • 🏡 Contas de empréstimo:

O valor restante a pagar no empréstimo do usuário.

Exemplo: 5874.13
availablenumber or null(float)^\d{1,15}\.\d{2,4}$

O saldo que o titular da conta pode usar.

  • 💰 Contas correntes e poupança:

O saldo disponível pode ser diferente do saldo current devido a transações pendentes.

  • 💳 Cartões de crédito:

O valor de crédito que o usuário ainda tem disponível para o período atual. O valor é calculado como credit_data.credit_limit menos balance.current.

  • 🏡 Contas de empréstimo:

O valor presente necessário para quitar o empréstimo, conforme fornecido pela instituição.

Nota: Se a instituição não fornecer esse valor, retornamos null.

Exemplo: 5621.12
blockednumber(float)^\d{1,15}\.\d{2,4}$

O valor que está atualmente bloqueado devido a transações pendentes.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: 60.32
automatically_investednumber(float)^\d{1,15}\.\d{2,4}$

O valor que é automaticamente investido (conforme acordado com a instituição).

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: 131.5
currencystring<= 3 characters^[A-Z]{3}$obrigatório

O código de moeda de três letras (ISO-4217).

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: "BRL"
public_identification_namestring or nullobrigatório

O nome público para o tipo de identificação. Para contas de poupança e corrente brasileiras 🇧🇷, este campo será AGENCY/ACCOUNT.

Exemplo: "AGENCY/ACCOUNT"
public_identification_valuestring or nullobrigatório

O valor para o public_identification_name.

Para contas de poupança e corrente 🇧🇷 OFDA brasileiras, este campo será o número da agência e da conta bancária, separados por uma barra. Por exemplo: 0444/45722-0.

Para contas de cartão de crédito 🇧🇷 OFDA brasileiras, retornaremos uma string de números de cartão de crédito concatenados associados à conta. Por exemplo: "8763,9076,5522"

Exemplo: "0444/45722-0"
internal_identificationstring<= 100 characters^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$obrigatório

A identificação interna da instituição para a conta.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: "92792126019929279212650822221989319252576"
credit_dataobject or nullobrigatório

Detalhes sobre os cartões de crédito associados a esta conta.

collected_atstring(date-time)obrigatório

O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.

Exemplo: "2022-02-09T08:45:50.406032Z"
credit_limitnumber or null(float)<= 20 characters^\d{1,15}\.\d{2,4}$obrigatório

O limite de crédito superior do cartão.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: 192000.9
limitsArray of objects
cutting_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...

A data de vencimento da fatura do cartão de crédito.

Exemplo: "2019-12-11"
minimum_paymentnumber or null(float)<= 20 characters^\d{1,15}\.\d{2,4}$

O valor mínimo que o proprietário da conta precisa pagar no período de crédito atual.

Exemplo: 2400.3
networkstring

A rede de crédito à qual o cartão está associado. Retornamos um dos seguintes valores:

  • VISA
  • MASTERCARD
  • AMERICAN_EXPRESS
  • DINERS_CLUB
  • HIPERCARD
  • BANDEIRA_PROPRIA
  • CHEQUE_ELETRONICO
  • ELO
  • OTHER

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"VISA""MASTERCARD""AMERICAN_EXPRESS""DINERS_CLUB""HIPERCARD""BANDEIRA_PROPRIA""CHEQUE_ELETRONICO""ELO""OTHER"
Exemplo: "MASTERCARD"
network_additional_infostring or null<= 100 characters[\w\W\s]*

Informações adicionais sobre a rede de cartão de crédito.

Exemplo: "It's an orange card."
cardsArray of objectsnon-empty

Detalhes sobre os cartões associados à conta.

next_payment_datestring or null

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
no_interest_paymentnumber or null(float)

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
interest_ratenumber or null(float)

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
monthly_paymentnumber or nullObsoleto

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
last_payment_datestring or nullObsoleto

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
loan_dataobject or nullobrigatório

As opções de empréstimo associadas a esta conta.

collected_atstring(date-time)obrigatório

O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.

Exemplo: "2022-02-09T08:45:50.406032Z"
loan_codestring[ 22 .. 67 ] characters^\d{22,67}$obrigatório

O número de contrato padronizado específico do país.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "92792126019929279212650822221989319252576"
contract_amountnumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total inicial do empréstimo quando o contrato foi assinado, calculado pela instituição. Este valor inclui o principal + juros + impostos + taxas.

Exemplo: 202000
total_effective_costnumber or null(float)^\d{1,15}\.\d{2,4}$

O custo efetivo total inicial do empréstimo.

Exemplo: 209000
loan_typestringobrigatório

O tipo do empréstimo, de acordo com a instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "HOME_EQUITY"
outstanding_balancenumber or null(float)[ 4 .. 20 ] characters^\d{1,15}\.\d{2,4}$obrigatório

O valor restante a pagar no total, incluindo juros.

Exemplo: 182000
interest_ratesArray of objectsobrigatório

Detalhamento dos juros aplicados ao empréstimo. Com o OF Brasil, recomendamos fortemente o uso das informações em interest_rate_data para obter informações detalhadas.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

namestring or nullobrigatório

O nome do tipo de taxa de juros aplicada ao empréstimo.

Nota: Para OFDA Brasil, recomendamos que você use o parâmetro interest_date_data.tax_type.

Exemplo: "NOMINAL"
typestringobrigatório

O período em que o juro é aplicado ao empréstimo.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"MONTHLY""YEARLY"
Exemplo: "MONTHLY"
valuenumber or null(float)obrigatório

A taxa de juros (em porcentagem ou valor monetário).

Nota: Para OFDA Brasil, recomendamos que você use os parâmetros interest_date_data.pre_fixed_rate e interest_date_data.post_fixed_rate.

Exemplo: 7.85
interest_rate_dataobject or nullobrigatório

Informações detalhadas sobre a taxa de juros.

tax_typestringobrigatório

O tipo de imposto sobre a taxa de juros. Retornamos um dos seguintes valores:

  • NOMINAL
  • EFFECTIVE

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"NOMINAL""EFFECTIVE"
Exemplo: "NOMINAL"
rate_typestringobrigatório

O tipo de taxa de juros. Retornamos um dos seguintes valores:

  • SIMPLE
  • COMPOUND

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"SIMPLE""COMPOUND"
Exemplo: "SIMPLE"
typestring

O período em que o juro é aplicado ao empréstimo.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"MONTHLY""YEARLY"
Exemplo: "MONTHLY"
calculation_basestring^[0-9]{2}\/[0-9]{3}$obrigatório

O cálculo base para a taxa de juros.

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "30/360"
reference_index_typestringobrigatório

A taxa de índice de referência. Retornamos um dos seguintes valores:

  • WITHOUT_INDEX_TYPE
  • PRE_FIXED
  • POST_FIXED
  • FLOATING
  • INDEXED_PRICE
  • RURAL_CREDIT
  • OTHER_INDEX

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"WITHOUT_INDEX_TYPE""PRE_FIXED""POST_FIXED""FLOATING""INDEXED_PRICE""RURAL_CREDIT""OTHER_INDEX"
Exemplo: "FLOATING"
reference_index_subtypestring or nullobrigatório

O subtipo da taxa de índice de referência.

Exemplo: "TR_TBF"
reference_index_infostring or null<= 140 characters^[\w\W\s]{0,140}$obrigatório

Informações adicionais sobre a taxa de índice de referência.

Exemplo: "Additional information"
pre_fixed_ratenumber(float)^[01]\.\d{6}$obrigatório

A taxa de juros com percentual prefixado.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: 0.062
post_fixed_ratenumber(float)^[01]\.\d{6}$obrigatório

A taxa de juros com percentual pós-fixado.

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: 0.062
additional_infostring or null<= 1200 characters[\w\W\s]*obrigatório

Informações adicionais sobre a taxa de juros.

Exemplo: "Additional information"
feesArray of objects or null or nullobrigatório

Detalhamento das taxas aplicadas ao empréstimo.

typestring or nullobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Enum"OPERATION_FEE""INSURANCE_FEE""OTHERS"null
Exemplo: null
valuenumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total da taxa. Mesma moeda do empréstimo.

Exemplo: 5.6
namestring<= 140 characters^[\w\W\s]{0,140}$obrigatório

O nome da taxa.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Exemplo: "Renovação de cadastro"
codestring<= 140 characters^[\w\W\s]{0,140}$obrigatório

O código de tarifa.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Exemplo: "CADASTRO"
fee_charge_typestringobrigatório

Indica o tipo de cobrança. Retornamos um dos seguintes valores:

  • SINGLE
  • PER_INSTALLMENT

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Enum"SINGLE""PER_INSTALLMENT"
Exemplo: "SINGLE"
fee_chargestringobrigatório

Método de cobrança, conforme acordado com a instituição. Retornamos um dos seguintes valores:

  • MINIMUM
  • MAXIMUM
  • FIXED
  • PERCENTAGE

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Enum"MINIMUM""MAXIMUM""FIXED""PERCENTAGE"
Exemplo: "FIXED"
ratenumber or null(float)^[01]\.\d{6}$obrigatório

A taxa percentual da tarifa. Necessária quando fee_charge está definido como PERCENTAGE.

Exemplo: 0.062
contracted_chargesArray of objects or null or null

Parece que você não forneceu nenhum texto para tradução. Por favor, envie o texto que deseja que eu traduza do inglês para o português (Brasil).

collateralsArray of objects or null or nullobrigatório

Detalhes sobre quaisquer garantias de empréstimo que o indivíduo ou empresa forneceu.

typestringobrigatório

O tipo de garantia, conforme definido pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: "OPERACOES_GARANTIDAS_PELO_GOVERNO"
subtypestringobrigatório

O subtipo da garantia, conforme definido pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: "CCR_CONVENIO_CREDITOS_RECIPROCOS"
currencystring<= 3 characters^[A-Z]{3}$obrigatório

O código de moeda de três letras (ISO-4217).

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: "BRL"
amountnumber(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total da fatura.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: 45391.89
balloon_paymentsArray of objects or null or nullobrigatório

Informações detalhadas sobre quaisquer pagamentos de balloon para o empréstimo, se aplicável.

due_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que o pagamento do balloon deve ser efetuado, no formato YYYY-MM-DD.

Exemplo: "2021-09-06"
currencystring or null<= 3 characters^[A-Z]{3}$obrigatório

O código de moeda de três letras (ISO-4217).

Exemplo: "BRL"
amountnumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total do pagamento final.

Exemplo: 45391.89
installments_contract_term_frequencystring or nullobrigatório

A frequência dos pagamentos parcelados contratados, conforme definido quando o contrato foi assinado pela primeira vez. Retornamos um dos seguintes:

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • NO_DEADLINE_REMAINING
  • null
Enum"DAY""WEEK""MONTH""YEAR""NO_DEADLINE_REMAINING"null
Exemplo: "MONTH"
installment_frequencystringobrigatório

A frequência com que as parcelas são pagas. Retornamos um dos seguintes valores:

  • IRREGULAR
  • WEEKLY
  • FORTNIGHTLY
  • MONTHLY
  • BIMONTHLY
  • QUARTERLY
  • BIANNUALLY
  • ANNUALLY
  • OTHER

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"IRREGULAR""WEEKLY""FORTNIGHTLY""MONTHLY""BIMONTHLY""QUARTERLY""BIANNUALLY""ANNUALLY""OTHER"
Exemplo: "MONTHLY"
installment_frequency_infostring or null<= 100 characters^[\w\W\s]{0,99}$$obrigatório

Informações adicionais sobre o installment_frequency.

Exemplo: "Both the term and requency are the same."
first_installment_due_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que a primeira parcela do empréstimo deve ser paga, no formato YYYY-MM-DD.

Exemplo: "2020-03-01"
number_of_installments_totalinteger or null(int32)<= 999999999obrigatório

O número total de parcelas necessárias para quitar o empréstimo.

Exemplo: 60
number_of_installments_outstandinginteger or null(int32)<= 999999999obrigatório

O número de parcelas restantes a pagar.

Exemplo: 48
number_of_installments_paidinteger or null(int32)<= 999999999obrigatório

O número de parcelas já pagas.

Exemplo: 32
number_of_installments_past_dueinteger or null(int32)<= 999obrigatório

O número de parcelas que estão em atraso.

Exemplo: 2
disbursement_datesArray of strings or null or nullnon-emptyobrigatório

Um array de datas em que o empréstimo foi desembolsado.

Exemplo: ["2021-09-23"]
settlement_datestring or null<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que o empréstimo foi liquidado, no formato YYYY-MM-DD.

Exemplo: "2021-09-23"
contract_start_datestring(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que o contrato de empréstimo foi assinado, no formato YYYY-MM-DD.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "2020-03-01"
contract_end_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que se espera que o empréstimo seja concluído, no formato YYYY-MM-DD.

Exemplo: "2027-10-01"
contract_remaining_frequencystring or nullobrigatório

A frequência dos pagamentos das parcelas restantes contratadas, conforme definido quando o contrato foi assinado pela primeira vez. Retornamos um dos seguintes valores:

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • NO_DEADLINE_REMAINING
  • null
Enum"DAY""WEEK""MONTH""YEAR""NO_DEADLINE_REMAINING"null
Exemplo: "MONTH"
contract_remaining_totalinteger or null(int32)<= 999999999obrigatório

O número total de parcelas restantes no empréstimo.

Exemplo: 20
amortization_schedulestringobrigatório

O cronograma de amortização do empréstimo.

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "SEM_SISTEMA_AMORTIZACAO"
amortization_schedule_infostring or null<= 200 characters[\w\W\s]*obrigatório

Informações adicionais sobre o amortization_schedule.

Exemplo: "No need for a schedule."
consignee_idstring or null<= 14 characters^\d{14}$obrigatório

O ID do consignatário do empréstimo.

Exemplo: "60500998000135"
contract_numberstring or null[ 1 .. 100 ] characters^\d{1,100}$obrigatório

O número do contrato do empréstimo, conforme fornecido pela instituição.

Exemplo: "1324926521496"
monthly_paymentnumber or null(float)obrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
principalnumber or null(float)obrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
payment_daystring or nullobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
outstanding_principalnumber or null(float)obrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
credit_limitnumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
last_period_balancenumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
interest_ratenumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
limit_daystring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
cutting_daystring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
cutting_datestring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
last_payment_datestring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
no_interest_paymentnumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
funds_datastring or nullobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
{ "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d", "link": "30cb4806-6e00-48a4-91c9-ca55968576c8", "institution": { "name": "erebor_mx_retail", "type": "bank" }, "collected_at": "2022-02-09T08:45:50.406032Z", "created_at": "2022-02-09T08:45:50.406032Z", "last_accessed_at": "2021-03-09T10:28:40.000Z", "category": "CHECKING_ACCOUNT", "balance_type": "ASSET", "overdraft": { "arranged": 5000.5, "used": 1000.5, "unarranged": 300.1 }, "type": "STANDARD_NACIONAL", "subtype": "FINANCIAMENTO_HABITACIONAL_SFH", "name": "Cuenta Perfiles- M.N. - MXN-666", "number": "4057068115181", "agency": "6272", "check_digit": "7", "balance": { "current": 5874.13, "available": 5621.12, "blocked": 60.32, "automatically_invested": 131.5 }, "currency": "BRL", "public_identification_name": "AGENCY/ACCOUNT", "public_identification_value": "0444/45722-0", "internal_identification": "92792126019929279212650822221989319252576", "credit_data": { "collected_at": "2022-02-09T08:45:50.406032Z", "credit_limit": 192000.9, "limits": [], "cutting_date": "2019-12-11", "minimum_payment": 2400.3, "network": "MASTERCARD", "network_additional_info": "It's an orange card.", "cards": [], "next_payment_date": null, "no_interest_payment": null, "interest_rate": null, "monthly_payment": null, "last_payment_date": null }, "loan_data": { "collected_at": "2022-02-09T08:45:50.406032Z", "loan_code": "92792126019929279212650822221989319252576", "contract_amount": 202000, "total_effective_cost": 209000, "loan_type": "HOME_EQUITY", "outstanding_balance": 182000, "interest_rates": [], "fees": [], "contracted_charges": [], "collaterals": [], "balloon_payments": [], "installments_contract_term_frequency": "MONTH", "installment_frequency": "MONTHLY", "installment_frequency_info": "Both the term and requency are the same.", "first_installment_due_date": "2020-03-01", "number_of_installments_total": 60, "number_of_installments_outstanding": 48, "number_of_installments_paid": 32, "number_of_installments_past_due": 2, "disbursement_dates": [], "settlement_date": "2021-09-23", "contract_start_date": "2020-03-01", "contract_end_date": "2027-10-01", "contract_remaining_frequency": "MONTH", "contract_remaining_total": 20, "amortization_schedule": "SEM_SISTEMA_AMORTIZACAO", "amortization_schedule_info": "No need for a schedule.", "consignee_id": "60500998000135", "contract_number": "1324926521496", "monthly_payment": null, "principal": null, "payment_day": null, "outstanding_principal": null, "credit_limit": null, "last_period_balance": null, "interest_rate": null, "limit_day": null, "cutting_day": null, "cutting_date": null, "last_payment_date": null, "no_interest_payment": null }, "funds_data": null }

Listar contas

Requisição

▶️ Uso

Com o método List Accounts, você pode:

  1. Listar contas relacionadas a um link.id específico (usando o parâmetro de consulta link).
  2. Obter os detalhes de um account.id específico (usando o parâmetro de consulta id).
  3. [Não Recomendado] Listar todas as contas relacionadas à sua conta Belvo (sem usar nenhum parâmetro de consulta).

🔦 Filtrando Respostas

Consulte a lista de consultas abaixo para ver uma lista de campos pelos quais você pode filtrar suas respostas. Para mais informações sobre como usar filtros, veja nosso artigo Filtrando respostas.

📖 Paginação

Este método retorna uma resposta paginada (padrão: 100 itens por página). Você pode usar o parâmetro de consulta page_size para aumentar o número de itens retornados até um máximo de 1000 itens. Você pode usar o parâmetro de consulta page para navegar pelos resultados. Para mais detalhes sobre como navegar pelas respostas paginadas da Belvo, veja nosso artigo Dicas de Paginação.

🚨 Campos Obsoletos

Este recurso pode retornar campos obsoletos. Na documentação de resposta, você pode ver que um campo foi marcado como obsoleto. Isso significa que este campo não é mais mantido pela equipe da Belvo. Você ainda pode receber dados para este campo dependendo da instituição, no entanto, não deve confiar neste campo.

Security
basicAuth
Consulta
linkstring(uuid)

O link.id pelo qual você deseja filtrar.

ℹ️ Recomendamos fortemente adicionar o filtro link.id para melhorar seu desempenho.

Exemplo: link=8848bd0c-9c7e-4f53-a732-ec896b11d4c4
page_sizeinteger(int32)[ 1 .. 1000 ]

Indica quantos resultados retornar por página. Por padrão, retornamos 100 resultados por página.

ℹ️ O número mínimo de resultados retornados por página é 1 e o máximo é 1000. Se você inserir um valor maior que 1000, nossa API usará o valor máximo por padrão (1000).

Padrão 100
Exemplo: page_size=100
pageinteger(int32)>= 1

Um número de página dentro do conjunto de resultados paginados.

Exemplo: page=1
omitstring

Omitir certos campos de serem retornados na resposta. Para mais informações, consulte nosso artigo Filtrando respostas no DevPortal.

fieldsstring

Retorne apenas os campos especificados na resposta. Para mais informações, consulte nosso artigo no DevPortal Filtrando respostas.

link__inArray of strings(uuid)

Retorne resultados apenas para esses link.ids.

Exemplo: link__in=5722d0ba-69d7-42dc-8ff5-33767b83c5d6
balance__availablenumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.available correspondendo exatamente a este valor.

Exemplo: balance__available=4000.02
balance__available__ltnumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.available menor que este valor.

Exemplo: balance__available__lt=6000.02
balance__available__ltenumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.available menor ou igual a este valor.

Exemplo: balance__available__lte=5999.02
balance__available__gtnumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.available maior que este valor.

Exemplo: balance__available__gt=2000.02
balance__available__gtenumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.available maior ou igual a este valor.

Exemplo: balance__available__gte=1999.02
balance__available__rangeArray of numbers(float)<= 2 items

Retorne contas que tenham um balance.available dentro de um intervalo de dois valores.

Exemplo: balance__available__range=4350.02
balance__currentnumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.current correspondendo exatamente a este valor.

Exemplo: balance__current=4000.02
balance__current__ltnumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.current menor que este valor.

Exemplo: balance__current__lt=6000.02
balance__current__ltenumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.available menor ou igual a este valor.

Exemplo: balance__current__lte=5999.02
balance__current__gtnumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.current maior que este valor.

Exemplo: balance__current__gt=2000.02
balance__current__gtenumber(float)^\d{1,15}\.\d{2,4}$

Retorne contas que tenham um balance.available maior ou igual a este valor.

Exemplo: balance__current__gte=1999.02
balance__current__rangeArray of numbers(float)<= 2 items

Retorne contas que tenham um balance.current dentro de um intervalo de dois valores.

Exemplo: balance__current__range=4350.02
categorystring

Retorne contas apenas para a categoria fornecida (por exemplo, CHECKING_ACCOUNT e SAVINGS_ACCOUNT).

Exemplo: category=CREDIT_ACCOUNT
category__inArray of strings

Retorne contas apenas para as categorias fornecidas (por exemplo, CHECKING_ACCOUNT e SAVINGS_ACCOUNT).

Exemplo: category__in=SAVINGS_ACCOUNT
created_atstring(date)

Retorne itens que foram atualizados pela última vez no banco de dados da Belvo nesta data (no formato YYYY-MM-DD).

Exemplo: created_at=2022-05-05
created_at__gtstring(date)

Retorne itens que foram atualizados pela última vez no banco de dados da Belvo após esta data (no formato YYYY-MM-DD).

Exemplo: created_at__gt=2022-05-05
created_at__gtestring(date)

Retorne itens que foram atualizados pela última vez no banco de dados da Belvo após ou nesta data (no formato YYYY-MM-DD).

Exemplo: created_at__gte=2022-05-04
created_at__ltstring(date)

Retorne itens que foram atualizados pela última vez no banco de dados da Belvo antes desta data (no formato YYYY-MM-DD).

Exemplo: created_at__lt=2022-04-01
created_at__ltestring(date)

Retorne itens que foram atualizados pela última vez no banco de dados da Belvo antes ou na data especificada (no formato YYYY-MM-DD).

Exemplo: created_at__lte=2022-03-30
created_at__rangeArray of strings(date)<= 2 items

Retorne contas que foram atualizadas pela última vez no banco de dados do Belvo entre duas datas (no formato YYYY-MM-DD).

Exemplo: created_at__range=2022-03-03
currencystring^[A-Z]{3}$

Retorne resultados que contenham finanças ou saldos apenas neste código de moeda de três letras.

Exemplo: currency=BRA
currency__inArray of strings

Retorne resultados que tenham fundos ou saldos em um destes códigos de moeda de três letras.

Exemplo: currency__in=BRA
idstring(uuid)

Retorne informações apenas para este recurso id.

Exemplo: id=24ccab1d-3a86-4136-a6eb-e04bf52b356f
id__inArray of strings(uuid)

Retorne informações para esses ids de recurso.

Exemplo: id__in=6b3dea0f-be29-49d1-aabe-1a6d588642e6
institutionstring[ 1 .. 40 ] characters^[a-z_]{1,40}$

Retorne resultados apenas para esta instituição (use o nome designado pela Belvo, como planet_mx_employment).

Exemplo: institution=planet_mx_retail
institution__inArray of strings

Retorne resultados apenas para estas instituições (use os nomes designados pela Belvo, como ofmockbank_br_retail e planet_mx_employment).

Exemplo: institution__in=planet_mx_retail
namestring

Retorne contas com exatamente este nome interno (especificado pela instituição).

Exemplo: name=Cuenta Perfiles- M.N. - MXN-666
name__icontainsstring>= 3 characters

Retornar contas que correspondam parcialmente a este nome interno (especificado pela instituição).

Exemplo: name__icontains=Perfiles
numberstring

Retorne informações apenas para este número de conta (conforme especificado pela instituição).

Exemplo: number=4057068115181
number__inArray of strings

Retornar informações para esses números de conta (conforme especificado pela instituição).

Exemplo: number__in=4057068115181
public_identification_namestring

Retorne informações apenas para este tipo de ID de conta. Por exemplo, contas CLABE.

Exemplo: public_identification_name=CLABE
public_identification_valuestring

Retorne informações apenas para este ID de conta. Por exemplo, o número da conta para uma conta CLABE.

Exemplo: public_identification_value=150194683119900273
typestring

Retorne informações apenas para contas que correspondam a este tipo de conta, conforme designado pela instituição.

Exemplo: type=Cuentas de efectivo
curl -i -X GET \
  -u <username>:<password> \
  'https://developers.belvo.com/_mock/pt-br/apis/belvoopenapispec/api/accounts/?balance__available=4000.02&balance__available__gt=2000.02&balance__available__gte=1999.02&balance__available__lt=6000.02&balance__available__lte=5999.02&balance__available__range=4350.02&balance__current=4000.02&balance__current__gt=2000.02&balance__current__gte=1999.02&balance__current__lt=6000.02&balance__current__lte=5999.02&balance__current__range=4350.02&category=CREDIT_ACCOUNT&category__in=SAVINGS_ACCOUNT&created_at=2022-05-05&created_at__gt=2022-05-05&created_at__gte=2022-05-04&created_at__lt=2022-04-01&created_at__lte=2022-03-30&created_at__range=2022-03-03&currency=BRA&currency__in=BRA&fields=string&id=24ccab1d-3a86-4136-a6eb-e04bf52b356f&id__in=6b3dea0f-be29-49d1-aabe-1a6d588642e6&institution=planet_mx_retail&institution__in=planet_mx_retail&link=8848bd0c-9c7e-4f53-a732-ec896b11d4c4&link__in=5722d0ba-69d7-42dc-8ff5-33767b83c5d6&name=Cuenta%20Perfiles-%20M.N.%20-%20MXN-666&name__icontains=Perfiles&number=4057068115181&number__in=4057068115181&omit=string&page=1&page_size=100&public_identification_name=CLABE&public_identification_value=150194683119900273&type=Cuentas%20de%20efectivo'

Respostas

Ok

Corpoapplication/json
countinteger(int32)

O número total de resultados na sua conta Belvo.

Exemplo: 130
nextstring or null(uri)

A URL para a próxima página de resultados. Cada página consiste em até 100 itens. Se não houver resultados suficientes para uma página adicional, o valor será null.

Em nosso exemplo de documentação, usamos {endpoint} como um valor de espaço reservado. Em produção, esse valor será substituído pelo endpoint real que você está usando atualmente (por exemplo, accounts ou owners).

Exemplo: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2"
previousstring or null(uri)

A URL para a página anterior de resultados. Se não houver uma página anterior, o valor será null.

Exemplo: null
resultsArray of objects or null

Um array de objetos de conta.

Resposta
application/json
{ "count": 130, "next": "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2", "previous": null, "results": [ {} ] }

Recuperar contas para um link

Requisição

Recupere contas de um link existente.

Este recurso pode retornar campos obsoletos. Por favor, verifique a documentação da resposta para mais informações.

Security
basicAuth
Consulta
omitstring

Omitir certos campos de serem retornados na resposta. Para mais informações, consulte nosso artigo Filtrando respostas no DevPortal.

fieldsstring

Retorne apenas os campos especificados na resposta. Para mais informações, consulte nosso artigo no DevPortal Filtrando respostas.

Corpoapplication/jsonobrigatório
linkstring(uuid)obrigatório

O link.id para o qual você deseja recuperar informações.

Exemplo: "c81a1dea-6dd6-4999-8b9f-541ee8197058"
tokenstring

O token MFA gerado pela instituição, que é necessário para continuar uma sessão.

Exemplo: "1234ab"
save_databoolean

Indica se os dados devem ou não ser persistidos no Belvo. Por padrão, isso é definido como true e retornamos uma resposta 201 Created.

Quando definido como false, os dados não serão persistidos e retornamos uma resposta 200 OK.

Padrão true
Exemplo: true
curl -i -X POST \
  -u <username>:<password> \
  'https://developers.belvo.com/_mock/pt-br/apis/belvoopenapispec/api/accounts/?fields=string&omit=string' \
  -H 'Content-Type: application/json' \
  -d '{
    "link": "c81a1dea-6dd6-4999-8b9f-541ee8197058",
    "token": "1234ab",
    "save_data": true
  }'

Respostas

Ok (quando save_data=false)

Corpoapplication/jsonArray [
idstring(uuid)obrigatório

Identificador único da Belvo para o item atual.

Exemplo: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
linkstring or null(uuid)obrigatório

O link.id ao qual os dados pertencem.

Exemplo: "30cb4806-6e00-48a4-91c9-ca55968576c8"
institutionobjectobrigatório

Detalhes sobre a instituição.

namestring

O nome da instituição, conforme designado pela Belvo.

Exemplo: "erebor_mx_retail"
typestring

O tipo de instituição. Retornamos um dos seguintes valores:

  • bank
  • fiscal
  • employment
Enum"bank""fiscal""employment"
collected_atstring(date-time)obrigatório

O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.

Exemplo: "2022-02-09T08:45:50.406032Z"
created_atstring(date-time)obrigatório

O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo.

Exemplo: "2022-02-09T08:45:50.406032Z"
last_accessed_atstring or null(date-time)obrigatório

O timestamp ISO-8601 do acesso mais recente e bem-sucedido da Belvo à instituição para o link fornecido.

Exemplo: "2021-03-09T10:28:40.000Z"
categorystring or nullobrigatório

O tipo de conta.
Retornamos um dos seguintes valores do enum:

  • ADVANCE_DEPOSIT_ACCOUNT
  • CHECKING_ACCOUNT
  • CREDIT_CARD
  • FINANCING_ACCOUNT
  • INVESTMENT_ACCOUNT
  • INVOICE_FINANCING_ACCOUNT
  • LOAN_ACCOUNT
  • PENSION_FUND_ACCOUNT
  • SAVINGS_ACCOUNT
  • UNCATEGORIZED
Enum"ADVANCE_DEPOSIT_ACCOUNT""CHECKING_ACCOUNT""CREDIT_CARD""FINANCING_ACCOUNT""INVESTMENT_ACCOUNT""INVOICE_FINANCING_ACCOUNT""LOAN_ACCOUNT""PENSION_FUND_ACCOUNT""SAVINGS_ACCOUNT""UNCATEGORIZED"
Exemplo: "CHECKING_ACCOUNT"
balance_typestring or nullobrigatório

Indica se esta conta é um ASSET ou um LIABILITY. Você pode considerar o saldo de um ASSET como positivo, enquanto o saldo de um LIABILITY como negativo.

Exemplo: "ASSET"
overdraftobject or null
typestringobrigatório

O tipo de conta, conforme designado pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "STANDARD_NACIONAL"
subtypestringobrigatório

O subtipo de conta, conforme designado pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "FINANCIAMENTO_HABITACIONAL_SFH"
namestring or nullobrigatório

O nome da conta, conforme fornecido pela instituição.

Exemplo: "Cuenta Perfiles- M.N. - MXN-666"
numberstring or nullobrigatório

O número da conta, conforme designado pela instituição.

Exemplo: "4057068115181"
agencystring or null<= 4 characters^\d{1,4}$obrigatório

O código da agência onde o produto foi aberto.

Exemplo: "6272"
check_digitstring or null<= 2 characters[\w\W\s]*obrigatório

O dígito verificador do número do produto, se aplicável.

Exemplo: "7"
balanceobjectobrigatório

Detalhes sobre os saldos atual e disponível para a conta.

currentnumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O saldo atual é calculado de maneira diferente de acordo com o tipo de conta.

  • 💰 Contas correntes e poupança:

O saldo da conta do usuário no timestamp collected_at.

  • 💳 Cartões de crédito:

O valor que o usuário gastou no período de faturamento atual do cartão (consulte credit_data.cutting_date para informações sobre quando o período de faturamento atual termina).

  • 🏡 Contas de empréstimo:

O valor restante a pagar no empréstimo do usuário.

Exemplo: 5874.13
availablenumber or null(float)^\d{1,15}\.\d{2,4}$

O saldo que o titular da conta pode usar.

  • 💰 Contas correntes e poupança:

O saldo disponível pode ser diferente do saldo current devido a transações pendentes.

  • 💳 Cartões de crédito:

O valor de crédito que o usuário ainda tem disponível para o período atual. O valor é calculado como credit_data.credit_limit menos balance.current.

  • 🏡 Contas de empréstimo:

O valor presente necessário para quitar o empréstimo, conforme fornecido pela instituição.

Nota: Se a instituição não fornecer esse valor, retornamos null.

Exemplo: 5621.12
blockednumber(float)^\d{1,15}\.\d{2,4}$

O valor que está atualmente bloqueado devido a transações pendentes.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: 60.32
automatically_investednumber(float)^\d{1,15}\.\d{2,4}$

O valor que é automaticamente investido (conforme acordado com a instituição).

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: 131.5
currencystring<= 3 characters^[A-Z]{3}$obrigatório

O código de moeda de três letras (ISO-4217).

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: "BRL"
public_identification_namestring or nullobrigatório

O nome público para o tipo de identificação. Para contas de poupança e corrente brasileiras 🇧🇷, este campo será AGENCY/ACCOUNT.

Exemplo: "AGENCY/ACCOUNT"
public_identification_valuestring or nullobrigatório

O valor para o public_identification_name.

Para contas de poupança e corrente 🇧🇷 OFDA brasileiras, este campo será o número da agência e da conta bancária, separados por uma barra. Por exemplo: 0444/45722-0.

Para contas de cartão de crédito 🇧🇷 OFDA brasileiras, retornaremos uma string de números de cartão de crédito concatenados associados à conta. Por exemplo: "8763,9076,5522"

Exemplo: "0444/45722-0"
internal_identificationstring<= 100 characters^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$obrigatório

A identificação interna da instituição para a conta.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.

Exemplo: "92792126019929279212650822221989319252576"
credit_dataobject or nullobrigatório

Detalhes sobre os cartões de crédito associados a esta conta.

collected_atstring(date-time)obrigatório

O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.

Exemplo: "2022-02-09T08:45:50.406032Z"
credit_limitnumber or null(float)<= 20 characters^\d{1,15}\.\d{2,4}$obrigatório

O limite de crédito superior do cartão.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: 192000.9
limitsArray of objects
cutting_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...

A data de vencimento da fatura do cartão de crédito.

Exemplo: "2019-12-11"
minimum_paymentnumber or null(float)<= 20 characters^\d{1,15}\.\d{2,4}$

O valor mínimo que o proprietário da conta precisa pagar no período de crédito atual.

Exemplo: 2400.3
networkstring

A rede de crédito à qual o cartão está associado. Retornamos um dos seguintes valores:

  • VISA
  • MASTERCARD
  • AMERICAN_EXPRESS
  • DINERS_CLUB
  • HIPERCARD
  • BANDEIRA_PROPRIA
  • CHEQUE_ELETRONICO
  • ELO
  • OTHER

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"VISA""MASTERCARD""AMERICAN_EXPRESS""DINERS_CLUB""HIPERCARD""BANDEIRA_PROPRIA""CHEQUE_ELETRONICO""ELO""OTHER"
Exemplo: "MASTERCARD"
network_additional_infostring or null<= 100 characters[\w\W\s]*

Informações adicionais sobre a rede de cartão de crédito.

Exemplo: "It's an orange card."
cardsArray of objectsnon-empty

Detalhes sobre os cartões associados à conta.

next_payment_datestring or null

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
no_interest_paymentnumber or null(float)

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
interest_ratenumber or null(float)

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
monthly_paymentnumber or nullObsoleto

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
last_payment_datestring or nullObsoleto

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
loan_dataobject or nullobrigatório

As opções de empréstimo associadas a esta conta.

collected_atstring(date-time)obrigatório

O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.

Exemplo: "2022-02-09T08:45:50.406032Z"
loan_codestring[ 22 .. 67 ] characters^\d{22,67}$obrigatório

O número de contrato padronizado específico do país.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "92792126019929279212650822221989319252576"
contract_amountnumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total inicial do empréstimo quando o contrato foi assinado, calculado pela instituição. Este valor inclui o principal + juros + impostos + taxas.

Exemplo: 202000
total_effective_costnumber or null(float)^\d{1,15}\.\d{2,4}$

O custo efetivo total inicial do empréstimo.

Exemplo: 209000
loan_typestringobrigatório

O tipo do empréstimo, de acordo com a instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "HOME_EQUITY"
outstanding_balancenumber or null(float)[ 4 .. 20 ] characters^\d{1,15}\.\d{2,4}$obrigatório

O valor restante a pagar no total, incluindo juros.

Exemplo: 182000
interest_ratesArray of objectsobrigatório

Detalhamento dos juros aplicados ao empréstimo. Com o OF Brasil, recomendamos fortemente o uso das informações em interest_rate_data para obter informações detalhadas.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

namestring or nullobrigatório

O nome do tipo de taxa de juros aplicada ao empréstimo.

Nota: Para OFDA Brasil, recomendamos que você use o parâmetro interest_date_data.tax_type.

Exemplo: "NOMINAL"
typestringobrigatório

O período em que o juro é aplicado ao empréstimo.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"MONTHLY""YEARLY"
Exemplo: "MONTHLY"
valuenumber or null(float)obrigatório

A taxa de juros (em porcentagem ou valor monetário).

Nota: Para OFDA Brasil, recomendamos que você use os parâmetros interest_date_data.pre_fixed_rate e interest_date_data.post_fixed_rate.

Exemplo: 7.85
interest_rate_dataobject or nullobrigatório

Informações detalhadas sobre a taxa de juros.

tax_typestringobrigatório

O tipo de imposto sobre a taxa de juros. Retornamos um dos seguintes valores:

  • NOMINAL
  • EFFECTIVE

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"NOMINAL""EFFECTIVE"
Exemplo: "NOMINAL"
rate_typestringobrigatório

O tipo de taxa de juros. Retornamos um dos seguintes valores:

  • SIMPLE
  • COMPOUND

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"SIMPLE""COMPOUND"
Exemplo: "SIMPLE"
typestring

O período em que o juro é aplicado ao empréstimo.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"MONTHLY""YEARLY"
Exemplo: "MONTHLY"
calculation_basestring^[0-9]{2}\/[0-9]{3}$obrigatório

O cálculo base para a taxa de juros.

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "30/360"
reference_index_typestringobrigatório

A taxa de índice de referência. Retornamos um dos seguintes valores:

  • WITHOUT_INDEX_TYPE
  • PRE_FIXED
  • POST_FIXED
  • FLOATING
  • INDEXED_PRICE
  • RURAL_CREDIT
  • OTHER_INDEX

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"WITHOUT_INDEX_TYPE""PRE_FIXED""POST_FIXED""FLOATING""INDEXED_PRICE""RURAL_CREDIT""OTHER_INDEX"
Exemplo: "FLOATING"
reference_index_subtypestring or nullobrigatório

O subtipo da taxa de índice de referência.

Exemplo: "TR_TBF"
reference_index_infostring or null<= 140 characters^[\w\W\s]{0,140}$obrigatório

Informações adicionais sobre a taxa de índice de referência.

Exemplo: "Additional information"
pre_fixed_ratenumber(float)^[01]\.\d{6}$obrigatório

A taxa de juros com percentual prefixado.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: 0.062
post_fixed_ratenumber(float)^[01]\.\d{6}$obrigatório

A taxa de juros com percentual pós-fixado.

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: 0.062
additional_infostring or null<= 1200 characters[\w\W\s]*obrigatório

Informações adicionais sobre a taxa de juros.

Exemplo: "Additional information"
feesArray of objects or null or nullobrigatório

Detalhamento das taxas aplicadas ao empréstimo.

typestring or nullobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Enum"OPERATION_FEE""INSURANCE_FEE""OTHERS"null
Exemplo: null
valuenumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total da taxa. Mesma moeda do empréstimo.

Exemplo: 5.6
namestring<= 140 characters^[\w\W\s]{0,140}$obrigatório

O nome da taxa.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Exemplo: "Renovação de cadastro"
codestring<= 140 characters^[\w\W\s]{0,140}$obrigatório

O código de tarifa.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Exemplo: "CADASTRO"
fee_charge_typestringobrigatório

Indica o tipo de cobrança. Retornamos um dos seguintes valores:

  • SINGLE
  • PER_INSTALLMENT

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Enum"SINGLE""PER_INSTALLMENT"
Exemplo: "SINGLE"
fee_chargestringobrigatório

Método de cobrança, conforme acordado com a instituição. Retornamos um dos seguintes valores:

  • MINIMUM
  • MAXIMUM
  • FIXED
  • PERCENTAGE

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.

Enum"MINIMUM""MAXIMUM""FIXED""PERCENTAGE"
Exemplo: "FIXED"
ratenumber or null(float)^[01]\.\d{6}$obrigatório

A taxa percentual da tarifa. Necessária quando fee_charge está definido como PERCENTAGE.

Exemplo: 0.062
contracted_chargesArray of objects or null or null

Parece que você não forneceu nenhum texto para tradução. Por favor, envie o texto que deseja que eu traduza do inglês para o português (Brasil).

collateralsArray of objects or null or nullobrigatório

Detalhes sobre quaisquer garantias de empréstimo que o indivíduo ou empresa forneceu.

typestringobrigatório

O tipo de garantia, conforme definido pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: "OPERACOES_GARANTIDAS_PELO_GOVERNO"
subtypestringobrigatório

O subtipo da garantia, conforme definido pela instituição.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: "CCR_CONVENIO_CREDITOS_RECIPROCOS"
currencystring<= 3 characters^[A-Z]{3}$obrigatório

O código de moeda de três letras (ISO-4217).

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: "BRL"
amountnumber(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total da fatura.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.

Exemplo: 45391.89
balloon_paymentsArray of objects or null or nullobrigatório

Informações detalhadas sobre quaisquer pagamentos de balloon para o empréstimo, se aplicável.

due_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que o pagamento do balloon deve ser efetuado, no formato YYYY-MM-DD.

Exemplo: "2021-09-06"
currencystring or null<= 3 characters^[A-Z]{3}$obrigatório

O código de moeda de três letras (ISO-4217).

Exemplo: "BRL"
amountnumber or null(float)^\d{1,15}\.\d{2,4}$obrigatório

O valor total do pagamento final.

Exemplo: 45391.89
installments_contract_term_frequencystring or nullobrigatório

A frequência dos pagamentos parcelados contratados, conforme definido quando o contrato foi assinado pela primeira vez. Retornamos um dos seguintes:

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • NO_DEADLINE_REMAINING
  • null
Enum"DAY""WEEK""MONTH""YEAR""NO_DEADLINE_REMAINING"null
Exemplo: "MONTH"
installment_frequencystringobrigatório

A frequência com que as parcelas são pagas. Retornamos um dos seguintes valores:

  • IRREGULAR
  • WEEKLY
  • FORTNIGHTLY
  • MONTHLY
  • BIMONTHLY
  • QUARTERLY
  • BIANNUALLY
  • ANNUALLY
  • OTHER

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Enum"IRREGULAR""WEEKLY""FORTNIGHTLY""MONTHLY""BIMONTHLY""QUARTERLY""BIANNUALLY""ANNUALLY""OTHER"
Exemplo: "MONTHLY"
installment_frequency_infostring or null<= 100 characters^[\w\W\s]{0,99}$$obrigatório

Informações adicionais sobre o installment_frequency.

Exemplo: "Both the term and requency are the same."
first_installment_due_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que a primeira parcela do empréstimo deve ser paga, no formato YYYY-MM-DD.

Exemplo: "2020-03-01"
number_of_installments_totalinteger or null(int32)<= 999999999obrigatório

O número total de parcelas necessárias para quitar o empréstimo.

Exemplo: 60
number_of_installments_outstandinginteger or null(int32)<= 999999999obrigatório

O número de parcelas restantes a pagar.

Exemplo: 48
number_of_installments_paidinteger or null(int32)<= 999999999obrigatório

O número de parcelas já pagas.

Exemplo: 32
number_of_installments_past_dueinteger or null(int32)<= 999obrigatório

O número de parcelas que estão em atraso.

Exemplo: 2
disbursement_datesArray of strings or null or nullnon-emptyobrigatório

Um array de datas em que o empréstimo foi desembolsado.

Exemplo: ["2021-09-23"]
settlement_datestring or null<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que o empréstimo foi liquidado, no formato YYYY-MM-DD.

Exemplo: "2021-09-23"
contract_start_datestring(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que o contrato de empréstimo foi assinado, no formato YYYY-MM-DD.

Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "2020-03-01"
contract_end_datestring or null(date)<= 10 characters^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?...obrigatório

A data em que se espera que o empréstimo seja concluído, no formato YYYY-MM-DD.

Exemplo: "2027-10-01"
contract_remaining_frequencystring or nullobrigatório

A frequência dos pagamentos das parcelas restantes contratadas, conforme definido quando o contrato foi assinado pela primeira vez. Retornamos um dos seguintes valores:

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • NO_DEADLINE_REMAINING
  • null
Enum"DAY""WEEK""MONTH""YEAR""NO_DEADLINE_REMAINING"null
Exemplo: "MONTH"
contract_remaining_totalinteger or null(int32)<= 999999999obrigatório

O número total de parcelas restantes no empréstimo.

Exemplo: 20
amortization_schedulestringobrigatório

O cronograma de amortização do empréstimo.

Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

Exemplo: "SEM_SISTEMA_AMORTIZACAO"
amortization_schedule_infostring or null<= 200 characters[\w\W\s]*obrigatório

Informações adicionais sobre o amortization_schedule.

Exemplo: "No need for a schedule."
consignee_idstring or null<= 14 characters^\d{14}$obrigatório

O ID do consignatário do empréstimo.

Exemplo: "60500998000135"
contract_numberstring or null[ 1 .. 100 ] characters^\d{1,100}$obrigatório

O número do contrato do empréstimo, conforme fornecido pela instituição.

Exemplo: "1324926521496"
monthly_paymentnumber or null(float)obrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
principalnumber or null(float)obrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
payment_daystring or nullobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
outstanding_principalnumber or null(float)obrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
credit_limitnumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
last_period_balancenumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
interest_ratenumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
limit_daystring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
cutting_daystring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
cutting_datestring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
last_payment_datestring or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
no_interest_paymentnumber or nullObsoletoobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
funds_datastring or nullobrigatório

Nota: Este campo não se aplica ao OF Brasil e retornará null.

Exemplo: null
]
Resposta
application/json

Exemplo de uma conta corrente (OFDA Brasil).

[ { "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d", "link": "30cb4806-6e00-48a4-91c9-ca55968576c8", "institution": {}, "collected_at": "2019-09-27T13:01:41.941Z", "created_at": "2022-02-09T08:45:50.406032Z", "last_accessed_at": "2021-03-09T10:28:40.000Z", "category": "CHECKING_ACCOUNT", "balance_type": "ASSET", "overdraft": {}, "type": "CONTA_DEPOSITO_A_VISTA", "subtype": "INDIVIDUAL", "name": null, "number": "11188222", "agency": "6272", "check_digit": "4", "balance": {}, "currency": "BRL", "public_identification_name": "AGENCY/NUMBER", "public_identification_value": "6272/11188222", "internal_identification": "92792126019929279212650822221989319252576", "credit_data": null, "loan_data": null, "funds_data": null } ]

Balances

Um saldo é a quantidade de dinheiro disponível em uma determinada conta bancária (corrente ou poupança) em um determinado momento.

Operações

Transactions

Uma transação contém as informações detalhadas de cada movimento dentro de uma conta. Por exemplo, uma compra em uma loja ou em um restaurante.

Operações

Bills

Uma bill refere-se à fatura do cartão de crédito que um usuário recebe para uma determinada conta.

Operações

Investments Brazil

Operações

Investment Transactions Brazil

Operações

Employments Brazil

Nosso recurso de empregos para o Brasil permite que você obtenha uma visão abrangente do histórico de emprego atual e das informações salariais do seu usuário.

Para cada usuário, nós retornamos:

  • histórico de trabalho (incluindo ocupações e dados do empregador)
  • informações salariais históricas e atuais (por empregador)

No momento, o recurso de empregos está disponível para:

  • 🇧🇷 Brasil (INSS)
Operações

Employment Records Mexico

Nosso recurso de registros de emprego para o México permite que você obtenha uma visão abrangente das contribuições atuais para a seguridade social e do histórico de emprego do seu usuário.

Com o recurso de registros de emprego da Belvo para o México, você pode acessar informações sobre as contribuições atuais para a seguridade social e o histórico de emprego do seu usuário. Para cada usuário, retornamos:

  • dados pessoais
  • histórico de trabalho
  • salário base diário histórico e atual
  • e mais!

No momento, o recurso de registros de emprego está disponível para:

  • 🇲🇽 México (IMSS)
  • 🇲🇽 México (ISSSTE)
Operações

Invoices

Operações

Tax compliance status

Operações

Tax returns

Operações

Tax retentions

Operações

Tax status

Operações

Financial Statements

Operações

Invoices Chile

Operações

Tax Status Chile

Operações

Debt Reports Chile

Operações

Incomes

Use o endpoint Incomes para obter insights sobre as fontes de renda de uma conta nos últimos 365 dias. O endpoint é particularmente útil quando você deseja verificar a renda de uma pessoa.

📘 Info

O recurso incomes está disponível apenas para contas Corrente e Poupança associadas a links bancários.

Operações

Recurring Expenses

A API de Despesas Recorrentes da Belvo permite que você identifique os pagamentos regulares de um usuário para serviços de assinatura, como Netflix ou assinaturas de academia, bem como pagamentos de serviços públicos, como contas de eletricidade ou telefone. Nós retornamos informações de até 365 dias.

📘 Informação

O recurso de despesas recorrentes está disponível apenas para contas Corrente, Poupança e de Cartão de Crédito associadas a links bancários.

Operações

Risk Insights

Operações

Employment Metrics

Operações

Payment Institutions (Brazil)

Uma instituição de pagamento é uma entidade da qual a Belvo pode acessar informações. Você pode ver uma lista completa de instituições disponíveis para pagamentos fazendo uma solicitação de List para este endpoint.

Operações

Customers (Brazil)

Um customer é o pagador que vai transferir fundos para sua conta bancária. Você precisa criar um customer para receber pagamentos de entrada na conta bancária da sua organização.

Operações

Bank Accounts (Brazil)

Para receber pagamentos de entrada na conta bancária da sua organização, você deve registrar as contas bancárias (individuais e empresariais) usando a Payments API da Belvo.

  • Contas bancárias individuais devem ser criadas para cada pagador (seu cliente).
  • Contas bancárias empresariais precisam ser criadas para o beneficiário do pagamento (sua organização).
Operações

Payment Intents (Brazil)

Um payment intent é um ponto único de acesso para criar pagamentos usando qualquer método de pagamento oferecido pela Belvo.

Um payment intent captura todas as informações de pagamento (como o valor a ser cobrado, a descrição do pagamento, o provedor, etc.) e guia seus clientes através do fluxo de pagamento.

Nota: Para instituições que exigem o username_type no array form_fields, você deve enviar esse valor na sua solicitação PATCH.

Operações

Payment Authorizations (Brazil)

Uma Autorização de Pagamento é o consentimento que seu usuário dá para que você debite dinheiro de suas contas. Você precisa realizar uma Autorização de Pagamento por ‘contrato’ (por exemplo, se sua empresa fornece tanto eletricidade quanto água, mas elas são cobradas separadamente, então você criará duas Autorizações de Pagamento separadas).

Assim que o usuário confirmar a autorização, você precisará escutar um webhook PAYMENT_AUTHORIZATION com o status definido como AUTHORIZED. Assim que você receber esse webhook, o processo de autorização estará completo, e você poderá cobrar seu usuário.

O que é uma cobrança?

Uma cobrança representa o pagamento individual (débito) que seu cliente fará.

Cabeçalho de Versão

O recurso de Autorização de Pagamento requer que você envie o cabeçalho X-Belvo-API-Resource-Version configurado para Payments-BR.V2.

Operações

Biometric Pix Widget Access Token (Brazil)

Use as solicitações de Token do Biometric Pix Widget para criar um token de acesso para Pagamentos Biométricos.

Operações

Enrollments (Brazil)

Operações

Payment Transactions (Brazil)

Cada vez que você recebe um pagamento de entrada de um cliente, uma transação é criada no banco de dados da Belvo.

Você pode usar o recurso de Transações de Pagamento para obter informações úteis sobre uma transação, bem como a cobrança específica associada a ela.

Operações