From d10d2d8c50e297e6baf31c298a6033dfdc82ffe8 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 18 Jul 2023 15:28:43 -0300 Subject: [PATCH 1/2] =?UTF-8?q?fix(Accounts):=20ORB-3009=20-=20Criar=20nov?= =?UTF-8?q?a=20vers=C3=A3o=20da=20API=20-=20v2.1.0-rc.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../{credit-cards => accounts}/2.1.0-rc.1.yml | 1433 ++++++----------- swagger-apis/accounts/index.html | 5 +- swagger-apis/credit-cards/index.html | 5 +- 3 files changed, 499 insertions(+), 944 deletions(-) rename swagger-apis/{credit-cards => accounts}/2.1.0-rc.1.yml (52%) diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/accounts/2.1.0-rc.1.yml similarity index 52% rename from swagger-apis/credit-cards/2.1.0-rc.1.yml rename to swagger-apis/accounts/2.1.0-rc.1.yml index 889608037..5670133a2 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/accounts/2.1.0-rc.1.yml @@ -1,58 +1,45 @@ openapi: 3.0.0 info: - title: API Credit-cards-accounts - Open Finance Brasil + title: API Accounts - Open Finance Brasil description: | - API de contas de pagamento pós-pagas do Open Finance Brasil – Fase 2. - API que retorna informações de contas de pagamento pós-paga mantidas nas instituições transmissoras por seus clientes, incluindo dados como denominação, produto, bandeira, limites de crédito, informações sobre transações de pagamento efetuadas e faturas. - + API de contas de depósito à vista, contas de poupança e contas pré-pagas do Open Finance Brasil – Fase 2. + API que retorna informações de contas de depósito à vista, contas de poupança e contas de pagamento pré-pagas mantidas nas instituições transmissoras por seus clientes, + incluindo dados de identificação da conta, saldos, limites e transações.\ Não possui segregação entre pessoa natural e pessoa jurídica.\ Requer consentimento do cliente para todos os `endpoints`. # Orientações A `Role` do diretório de participantes relacionada à presente API é a `DADOS`.\ Para todos os `endpoints` desta API é previsto o envio de um `token` através do header `Authorization`.\ - Este token deverá estar relacionado ao consentimento (`consentId`) mantido na instituição transmissora dos dados, o qual permitirá a pesquisa e retorno, na API em questão, dos + Este token deverá estar relacionado ao consentimento (`consentId`) mantido na instituição transmissora dos dados, o qual permitirá a pesquisa e retorno, na API em questão, dos dados relacionados ao `consentId` específico relacionado.\ Os dados serão devolvidos na consulta desde que o `consentId` relacionado corresponda a um consentimento válido e com o status `AUTHORISED`.\ É também necessário que o recurso em questão (conta, contrato, etc) esteja disponível na instituição transmissora (ou seja, sem boqueios de qualquer natureza e com todas as autorizações/consentimentos já autorizados).\ Além disso as `permissions` necessárias deverão ter sido solicitadas quando da criação do consentimento relacionado (`consentId`).\ - Relacionamos a seguir as `permissions` necessárias para a consulta de dados em cada `endpoint` da presente API.\ - ### `/accounts/{creditCardAccountId}/bills` - - description: - - Só deve ser informada uma fatura já fechada. - - Qualquer pagamento deve ser contado para a última fatura fechada. - ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` - - description: - - A lista a retornar se refere a transações após base 2/clearing/conciliado - ### `/accounts/{creditCardAccountId}/transactions` - - description: - - A lista a retornar se refere a transações após base 2/clearing/conciliado + Relacionamos a seguir as `permissions` necessárias para a consulta de dados em cada `endpoint` da presente API. - ## Permissions necessárias para a API Credit-cards-accounts + ## Permissions necessárias para a API Accounts Para cada um dos paths desta API, além dos escopos (`scopes`) indicados existem `permissions` que deverão ser observadas: ### `/accounts` - permissions: - - GET: **CREDIT_CARDS_ACCOUNTS_READ** - ### `/accounts/{creditCardAccountId}` - - permissions: - - GET: **CREDIT_CARDS_ACCOUNTS_READ** - ### `/accounts/{creditCardAccountId}/bills` + - GET: **ACCOUNTS_READ** + ### `/accounts/{accountId}` - permissions: - - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_READ** - ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - GET: **ACCOUNTS_READ** + ### `/accounts/{accountId}/balances` - permissions: - - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_TRANSACTIONS_READ** - ### `/accounts/{creditCardAccountId}/limits` + - GET: **ACCOUNTS_BALANCES_READ** + ### `/accounts/{accountId}/transactions` - permissions: - - GET: **CREDIT_CARDS_ACCOUNTS_LIMITS_READ** - ### `/accounts/{creditCardAccountId}/transactions` + - GET: **ACCOUNTS_TRANSACTIONS_READ** + ### `/accounts/{accountId}/transactions-current` - permissions: - - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** - ### `/accounts/{creditCardAccountId}/transactions-current` + - GET: **ACCOUNTS_TRANSACTIONS_READ** + ### `/accounts/{accountId}/overdraft-limits` - permissions: - - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + - GET: **ACCOUNTS_OVERDRAFT_LIMITS_READ** version: 2.1.0-rc.1 license: name: Apache 2.0 @@ -62,21 +49,21 @@ info: email: gt-interfaces@openbankingbr.org url: 'https://openbanking-brasil.github.io/areadesenvolvedor/' servers: - - url: 'https://api.banco.com.br/open-banking/credit-cards-accounts/v2' + - url: 'https://api.banco.com.br/open-banking/accounts/v2' description: Servidor de Produção - - url: 'https://apih.banco.com.br/open-banking/credit-cards-accounts/v2' + - url: 'https://apih.banco.com.br/open-banking/accounts/v2' description: Servidor de Homologação tags: - - name: Credit Card - description: Operações para listagem das informações de Cartão de Crédito + - name: Accounts + description: Operações para listagem das informações da Conta do Cliente paths: /accounts: get: tags: - - Credit Card - summary: Conjunto de informações das Contas de pagamento pós paga - operationId: creditCardsGetAccounts - description: Método para obter a lista de contas de pagamento pós-paga mantidas pelo cliente na instituição transmissora e para as quais ele tenha fornecido consentimento + - Accounts + summary: Obtém a lista de contas consentidas pelo cliente. + operationId: accountsGetAccounts + description: 'Método para obter a lista de contas depósito à vista, poupança e pagamento pré-pagas mantidas pelo cliente na instituição transmissora e para as quais ele tenha fornecido consentimento.' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/xFapiAuthDate' @@ -85,10 +72,11 @@ paths: - $ref: '#/components/parameters/xCustomerUserAgent' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/accountType' - $ref: '#/components/parameters/pagination-key' responses: '200': - $ref: '#/components/responses/OKResponseCreditCardAccountsList' + $ref: '#/components/responses/OKResponseAccountList' '400': $ref: '#/components/responses/BadRequestWithAdditionalProperties' '401': @@ -120,24 +108,24 @@ paths: - openid OAuth2Security: - 'consent:consentId' - - credit-cards-accounts - '/accounts/{creditCardAccountId}': + - accounts + '/accounts/{accountId}': get: tags: - - Credit Card - summary: Obtém os dados de identificação da conta identificada por creditCardAccountId. - operationId: creditCardsGetAccountsCreditCardAccountId - description: Método para obter os dados de identificação da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + - Accounts + summary: Obtém os dados de identificação da conta identificada por accountId. + description: 'Método para obter os dados de identificação da conta de depósito à vista, poupança ou pagamento pré-paga identificada por accountId mantida pelo cliente na instituição transmissora.' + operationId: accountsGetAccountsAccountId parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/xFapiAuthDate' - $ref: '#/components/parameters/xFapiCustomerIpAddress' - $ref: '#/components/parameters/xFapiInteractionId' - $ref: '#/components/parameters/xCustomerUserAgent' - - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/accountId' responses: '200': - $ref: '#/components/responses/OKResponseCreditCardAccountsIdentification' + $ref: '#/components/responses/OKResponseAccountIdentification' '400': $ref: '#/components/responses/BadRequestWithAdditionalProperties' '401': @@ -169,32 +157,24 @@ paths: - openid OAuth2Security: - 'consent:consentId' - - credit-cards-accounts - '/accounts/{creditCardAccountId}/bills': + - accounts + '/accounts/{accountId}/balances': get: tags: - - Credit Card - summary: Obtém a lista de faturas da conta identificada por creditCardAccountId. - description: | - Método para obter a lista de faturas da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora.\ - Só deve ser informada uma fatura já fechada.\ - Qualquer pagamento deve ser contado para a última fatura fechada. - operationId: creditCardsGetAccountsCreditCardAccountIdBills + - Accounts + summary: Obtém os saldos da conta identificada por accountId. + operationId: accountsGetAccountsAccountIdBalances + description: 'Método para obter os saldos da conta de depósito à vista, poupança ou pagamento pré-paga identificada por accountId mantida pelo cliente na instituição transmissora.' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/xFapiAuthDate' - $ref: '#/components/parameters/xFapiCustomerIpAddress' - $ref: '#/components/parameters/xFapiInteractionId' - $ref: '#/components/parameters/xCustomerUserAgent' - - $ref: '#/components/parameters/creditCardAccountId' - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - - $ref: '#/components/parameters/pagination-key' - - $ref: '#/components/parameters/fromDueDate' - - $ref: '#/components/parameters/toDueDate' + - $ref: '#/components/parameters/accountId' responses: '200': - $ref: '#/components/responses/OKResponseCreditCardAccountsBills' + $ref: '#/components/responses/OKResponseAccountBalances' '400': $ref: '#/components/responses/BadRequestWithAdditionalProperties' '401': @@ -226,142 +206,85 @@ paths: - openid OAuth2Security: - 'consent:consentId' - - credit-cards-accounts - '/accounts/{creditCardAccountId}/bills/{billId}/transactions': + - accounts + '/accounts/{accountId}/transactions': get: tags: - - Credit Card - summary: Obtém a lista de transações da conta identificada por creditCardAccountId e billId. - operationId: creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions - description: | - Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId e billId mantida pelo cliente na instituição transmissora. - A lista a retornar se refere a transações após base 2/clearing/conciliado + - Accounts + summary: Obtém a lista de transações da conta identificada por accountId. + operationId: accountsGetAccountsAccountIdTransactions + description: 'Método para obter a lista de transações da conta de depósito à vista, poupança ou pagamento pré-paga identificada por accountId mantida pelo cliente na instituição transmissora.' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/xFapiAuthDate' - $ref: '#/components/parameters/xFapiCustomerIpAddress' - $ref: '#/components/parameters/xFapiInteractionId' - $ref: '#/components/parameters/xCustomerUserAgent' - - $ref: '#/components/parameters/creditCardAccountId' - - $ref: '#/components/parameters/billId' + - $ref: '#/components/parameters/accountId' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/pageSize' - - $ref: '#/components/parameters/pagination-key' - - $ref: '#/components/parameters/fromTransactionDate' - - $ref: '#/components/parameters/toTransactionDate' - - $ref: '#/components/parameters/creditCardTransactionType' - - $ref: '#/components/parameters/creditCardPayeeMCC' - responses: - '200': - $ref: '#/components/responses/OKResponseCreditCardAccountsBillsTransactions' - '400': - $ref: '#/components/responses/BadRequestWithAdditionalProperties' - '401': - $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' - '403': - $ref: '#/components/responses/ForbiddenWithAdditionalProperties' - '404': - $ref: '#/components/responses/NotFoundWithAdditionalProperties' - '405': - $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' - '406': - $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' - '422': - $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' - '423': - $ref: '#/components/responses/LockedWithAdditionalProperties' - '429': - $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' - '500': - $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' - '504': - $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' - '529': - $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' - default: - $ref: '#/components/responses/DefaultWithAdditionalProperties' - security: - - OpenId: - - openid - OAuth2Security: - - 'consent:consentId' - - credit-cards-accounts - '/accounts/{creditCardAccountId}/limits': - get: - tags: - - Credit Card - summary: Obtém os limites da conta identificada por creditCardAccountId. - operationId: creditCardsGetAccountsCreditCardAccountIdLimits - description: Método para obter os limites da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. - parameters: - - $ref: '#/components/parameters/Authorization' - - $ref: '#/components/parameters/xFapiAuthDate' - - $ref: '#/components/parameters/xFapiCustomerIpAddress' - - $ref: '#/components/parameters/xFapiInteractionId' - - $ref: '#/components/parameters/xCustomerUserAgent' - - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/fromBookingDate' + - $ref: '#/components/parameters/toBookingDate' + - $ref: '#/components/parameters/creditDebitIndicator' - $ref: '#/components/parameters/pagination-key' responses: '200': - $ref: '#/components/responses/OKResponseCreditCardAccountsLimits' + $ref: '#/components/responses/OKResponseAccountTransactions' '400': - $ref: '#/components/responses/BadRequestWithAdditionalProperties' + $ref: '#/components/responses/BadRequest' '401': - $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + $ref: '#/components/responses/Unauthorized' '403': - $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + $ref: '#/components/responses/Forbidden' '404': - $ref: '#/components/responses/NotFoundWithAdditionalProperties' + $ref: '#/components/responses/NotFound' '405': - $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + $ref: '#/components/responses/MethodNotAllowed' '406': - $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + $ref: '#/components/responses/NotAcceptable' '422': - $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + $ref: '#/components/responses/UnprocessableEntity' '423': - $ref: '#/components/responses/LockedWithAdditionalProperties' + $ref: '#/components/responses/Locked' '429': - $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + $ref: '#/components/responses/TooManyRequests' '500': - $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + $ref: '#/components/responses/InternalServerError' '504': - $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + $ref: '#/components/responses/GatewayTimeout' '529': - $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + $ref: '#/components/responses/SiteIsOverloaded' default: - $ref: '#/components/responses/DefaultWithAdditionalProperties' + $ref: '#/components/responses/Default' security: - OpenId: - openid OAuth2Security: - 'consent:consentId' - - credit-cards-accounts - '/accounts/{creditCardAccountId}/transactions': + - accounts + '/accounts/{accountId}/transactions-current': get: tags: - - Credit Card - summary: Obtém a lista de transações da conta identificada por creditCardAccountId. - operationId: creditCardsGetAccountsCreditCardAccountIdTransactions - description: |- - Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. - A lista a retornar se refere a transações após base 2/clearing/conciliado + - Accounts + summary: Obtém a lista de transações recentes (últimos 7 dias) da conta identificada por accountId. + operationId: accountsGetAccountsAccountIdTransactionsCurrent + description: 'Método para obter a lista de transações recentes (últimos 7 dias) da conta de depósito à vista, poupança ou pagamento pré-paga identificada por accountId mantida pelo cliente na instituição transmissora.' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/xFapiAuthDate' - $ref: '#/components/parameters/xFapiCustomerIpAddress' - $ref: '#/components/parameters/xFapiInteractionId' - $ref: '#/components/parameters/xCustomerUserAgent' - - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/accountId' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/fromBookingDateMaxLimited' + - $ref: '#/components/parameters/toBookingDateMaxLimited' + - $ref: '#/components/parameters/creditDebitIndicator' - $ref: '#/components/parameters/pagination-key' - - $ref: '#/components/parameters/fromTransactionDate' - - $ref: '#/components/parameters/toTransactionDate' - - $ref: '#/components/parameters/creditCardTransactionType' - - $ref: '#/components/parameters/creditCardPayeeMCC' responses: '200': - $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + $ref: '#/components/responses/OKResponseAccountTransactions' '400': $ref: '#/components/responses/BadRequest' '401': @@ -393,69 +316,61 @@ paths: - openid OAuth2Security: - 'consent:consentId' - - credit-cards-accounts - '/accounts/{creditCardAccountId}/transactions-current': + - accounts + '/accounts/{accountId}/overdraft-limits': get: tags: - - Credit Card - summary: Obtém a lista de transações recentes (últimos 7 dias) da conta identificada por creditCardAccountId. - operationId: creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent - description: Método para obter a lista de transações recentes (últimos 7 dias) da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + - Accounts + summary: Obtém os limites da conta identificada por accountId. + operationId: accountsGetAccountsAccountIdOverdraftLimits + description: 'Método para obter os limites da conta de depósito à vista, poupança ou pagamento pré-paga identificada por accountId mantida pelo cliente na instituição transmissora.' parameters: - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/xFapiAuthDate' - $ref: '#/components/parameters/xFapiCustomerIpAddress' - $ref: '#/components/parameters/xFapiInteractionId' - $ref: '#/components/parameters/xCustomerUserAgent' - - $ref: '#/components/parameters/creditCardAccountId' - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - - $ref: '#/components/parameters/pagination-key' - - $ref: '#/components/parameters/fromTransactionDateMaxLimited' - - $ref: '#/components/parameters/toTransactionDateMaxLimited' - - $ref: '#/components/parameters/creditCardTransactionType' - - $ref: '#/components/parameters/creditCardPayeeMCC' + - $ref: '#/components/parameters/accountId' responses: '200': - $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + $ref: '#/components/responses/OKResponseAccountOverdraftLimits' '400': - $ref: '#/components/responses/BadRequest' + $ref: '#/components/responses/BadRequestWithAdditionalProperties' '401': - $ref: '#/components/responses/Unauthorized' + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' '403': - $ref: '#/components/responses/Forbidden' + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' '404': - $ref: '#/components/responses/NotFound' + $ref: '#/components/responses/NotFoundWithAdditionalProperties' '405': - $ref: '#/components/responses/MethodNotAllowed' + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' '406': - $ref: '#/components/responses/NotAcceptable' + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' '422': - $ref: '#/components/responses/UnprocessableEntity' + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' '423': - $ref: '#/components/responses/Locked' + $ref: '#/components/responses/LockedWithAdditionalProperties' '429': - $ref: '#/components/responses/TooManyRequests' + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' '500': - $ref: '#/components/responses/InternalServerError' + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' '504': - $ref: '#/components/responses/GatewayTimeout' + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' '529': - $ref: '#/components/responses/SiteIsOverloaded' + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' default: - $ref: '#/components/responses/Default' + $ref: '#/components/responses/DefaultWithAdditionalProperties' security: - OpenId: - openid OAuth2Security: - 'consent:consentId' - - credit-cards-accounts + - accounts components: schemas: - CreditCardAccountsTransactionAmount: + AccountBalancesDataAutomaticallyInvestedAmount: type: object - description: | - Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. + description: Saldo disponível com aplicação automática - corresponde a soma do saldo disponível acrescido do valor obtido a partir da aplicação automática. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. required: - amount - currency @@ -474,10 +389,9 @@ components: maxLength: 3 description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' example: BRL - CreditCardAccountsTransactionBrazilianAmount: + AccountOverdraftLimitsDataOverdraftContractedLimit: type: object - description: | - Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). + description: Valor do limite contratado do cheque especial. required: - amount - currency @@ -496,141 +410,34 @@ components: maxLength: 3 description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' example: BRL - CreditCardsAccountsIdentificationData: - type: object - description: Conjunto de informações referentes à identificação da conta de pagamento pós-paga. - required: - - name - - productType - - creditCardNetwork - - paymentMethod - properties: - name: - type: string - pattern: '[\w\W\s]*' - description: | - Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'. - maxLength: 50 - example: Cartão Universitário - productType: - $ref: '#/components/schemas/EnumCreditCardAccountsProductType' - productAdditionalInfo: - type: string - pattern: '[\w\W\s]*' - description: Informações complementares se tipo de Cartão 'OUTROS' - maxLength: 50 - example: OURO_INTERNACIONAL - creditCardNetwork: - $ref: '#/components/schemas/EnumCreditCardAccountNetwork' - networkAdditionalInfo: - type: string - pattern: '[\w\W\s]*' - description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS'. - maxLength: 50 - example: AURA CARD - paymentMethod: - type: array - description: | - Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários. - items: - $ref: '#/components/schemas/CreditCardsAccountPaymentMethod' - minItems: 1 - CreditCardAccountsBillsData: + AccountOverdraftLimitsDataOverdraftUsedLimit: type: object - description: Conjunto das informações referentes a lista de faturas associadas à conta de pagamento pós-paga + description: Valor utilizado total do limite do cheque especial e o adiantamento a depositante. required: - - billId - - dueDate - - billTotalAmount - - billMinimumAmount - - isInstalment - - payments - properties: - billId: - description: Informação que identifica a fatura - type: string - maxLength: 100 - minLength: 1 - pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' - example: 3459087XXZTR - dueDate: - description: 'Data de vencimento da Fatura, que aparece para pagamento pelo cliente' - type: string - format: date - maxLength: 10 - pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' - example: '2021-05-21' - billTotalAmount: - $ref: '#/components/schemas/CreditCardsBillTotalAmount' - billMinimumAmount: - $ref: '#/components/schemas/CreditCardAccountsBillMinimumAmount' - isInstalment: - type: boolean - description: Indica se a fatura permite parcelamento (true) ou não (false). - example: false - financeCharges: - type: array - items: - $ref: '#/components/schemas/CreditCardAccountsBillsFinanceCharge' - minItems: 1 - description: Lista dos encargos cobrados na fatura - payments: - type: array - items: - $ref: '#/components/schemas/CreditCardAccountsBillsPayment' - minItems: 0 - description: Lista que traz os valores relativos aos pagamentos da Fatura da conta de pagamento pós-paga - CreditCardAccountsBillsFinanceCharge: - type: object - required: - - type - amount - currency properties: - type: - $ref: '#/components/schemas/EnumCreditCardAccountsFinanceChargeType' - additionalInfo: - type: string - maxLength: 140 - pattern: '[\w\W\s]*' - example: Informações Adicionais - description: 'Campo livre, de preenchimento obrigatório se selecionado tipo de encargo ''OUTROS''' amount: type: string format: double + pattern: '^\d{1,15}\.\d{2,4}$' maxLength: 20 minLength: 4 - pattern: '^\d{1,15}\.\d{2,4}$' - example: '100000.0400' - description: Valor cobrado pelo encargo. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + example: '1000.0400' + description: Valor relacionado ao objeto. currency: type: string + pattern: '^[A-Z]{3}$' maxLength: 3 - pattern: '^(\w{3}){1}$' + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' example: BRL - description: | - Moeda referente ao valor cobrado pelo encargo, segundo modelo ISO-4217. p.ex. 'BRL' - Todos os saldos informados estão representados com a moeda vigente do Brasil. - CreditCardAccountsBillsPayment: + AccountOverdraftLimitsDataUnarrangedOverdraftAmount: type: object + description: Valor de operação contratada em caráter emergencial para cobertura de saldo devedor em conta de depósitos à vista e de excesso sobre o limite pactuado de cheque especial. required: - - valueType - - paymentDate - - paymentMode - amount - currency properties: - valueType: - $ref: '#/components/schemas/EnumCreditCardAccountsBillingValueType' - paymentDate: - description: Data efetiva de quando o Pagamento da fatura foi realizado - type: string - format: date - maxLength: 10 - pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' - example: '2021-05-21' - paymentMode: - $ref: '#/components/schemas/EnumCreditCardAccountsPaymentMode' amount: type: string format: double @@ -638,141 +445,16 @@ components: maxLength: 20 minLength: 4 example: '1000.0400' - description: | - Valor pagamento segundo o valueType. - Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. - O campo não pode assumir valor negativo por se tratar de um pagamento. + description: Valor relacionado ao objeto. currency: type: string - pattern: '^(\w{3}){1}$' + pattern: '^[A-Z]{3}$' maxLength: 3 - description: | - Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' example: BRL - CreditCardAccountsData: + AccountBalancesDataBlockedAmount: type: object - description: Conjunto de informações das Contas de pagamento pós paga - required: - - brandName - - companyCnpj - - name - - productType - - creditCardNetwork - - creditCardAccountId - properties: - creditCardAccountId: - type: string - description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade dentro da instituição transmissora.' - maxLength: 100 - minLength: 1 - pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' - example: XXZTR3459087 - brandName: - type: string - description: 'Nome da Marca reportada pelo participante no Open Finance. Recomenda-se utilizar, sempre que possível, o mesmo nome de marca atribuído no campo do diretório Customer Friendly Server Name (Authorisation Server).' - pattern: '[\w\W\s]*' - maxLength: 80 - example: Organização A - companyCnpj: - type: string - description: 'Número completo do CNPJ da instituição responsável pelo Cadastro - o CNPJ corresponde ao número de inscrição no Cadastro de Pessoa Jurídica. Deve-se ter apenas os números do CNPJ, sem máscara' - pattern: '^\d{14}$' - maxLength: 14 - example: '21128159000166' - name: - type: string - description: 'Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: ''conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos' - pattern: '[\w\W\s]*' - maxLength: 50 - example: Cartão Universitário - productType: - $ref: '#/components/schemas/EnumCreditCardAccountsProductType' - productAdditionalInfo: - type: string - description: Informações complementares se tipo de Cartão 'OUTROS' - pattern: '[\w\W\s]*' - maxLength: 50 - creditCardNetwork: - $ref: '#/components/schemas/EnumCreditCardAccountNetwork' - networkAdditionalInfo: - type: string - description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS' - pattern: '[\w\W\s]*' - maxLength: 50 - example: AURA CARD - CreditCardAccountsLimitsData: - type: object - description: Conjunto de informações referentes aos limites da conta de pagamento pós-paga. - required: - - creditLineLimitType - - consolidationType - - identificationNumber - - isLimitFlexible - - usedAmountCurrency - - usedAmount - properties: - creditLineLimitType: - $ref: '#/components/schemas/EnumCreditCardAccountsLineLimitType' - consolidationType: - $ref: '#/components/schemas/EnumCreditCardAccountsConsolidationType' - identificationNumber: - type: string - description: | - Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. - maxLength: 100 - minLength: 1 - pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' - example: '4453' - lineName: - type: string - enum: - - CREDITO_A_VISTA - - CREDITO_PARCELADO - - SAQUE_CREDITO_BRASIL - - SAQUE_CREDITO_EXTERIOR - - EMPRESTIMO_CARTAO_CONSIGNADO - - OUTROS - example: CREDITO_A_VISTA - lineNameAdditionalInfo: - type: string - maxLength: 50 - pattern: '[\w\W\s]*' - example: Informações adicionais e complementares. - description: Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName. - isLimitFlexible: - type: boolean - description: 'Indica se a operação de crédito é: com limite flexível (true) ou com limite (false).' - example: true - limitAmount: - $ref: '#/components/schemas/CreditCardsLimitAmount' - usedAmount: - $ref: '#/components/schemas/CreditCardsUsedAmount' - availableAmount: - $ref: '#/components/schemas/CreditCardsAvailableAmount' - CreditCardsAccountPaymentMethod: - type: object - description: Conjunto de informações relativas aos Meios de Pagamento da Conta de pagamento pós-paga - required: - - identificationNumber - - isMultipleCreditCard - properties: - identificationNumber: - type: string - description: | - Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Finance. - maxLength: 100 - minLength: 1 - pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' - example: '4453' - isMultipleCreditCard: - type: boolean - description: | - Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito. - example: true - CreditCardsLimitAmount: - type: object - description: | - Valor total do limite informado. + description: 'Saldo bloqueado, não disponível para utilização imediata, por motivo de bloqueio apresentado para o cliente nos canais eletrônicos. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.' required: - amount - currency @@ -784,23 +466,16 @@ components: maxLength: 20 minLength: 4 example: '1000.0400' - description: | - Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. - - [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + description: Valor relacionado ao objeto. currency: type: string pattern: '^[A-Z]{3}$' maxLength: 3 - description: | - Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' - Todos os limite informados estão representados com a moeda vigente do Brasil. - - [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' example: BRL - CreditCardsUsedAmount: + AccountBalancesDataAvailableAmount: type: object - description: Valor utilizado do limite informado + description: 'Saldo disponível para utilização imediata. No caso de conta de depósito a vista, sem considerar cheque especial e investimentos atrelados a conta. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.' required: - amount - currency @@ -812,362 +487,279 @@ components: maxLength: 21 minLength: 4 example: '1000.0400' - description: Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + description: Valor relacionado ao objeto. currency: type: string pattern: '^[A-Z]{3}$' maxLength: 3 - description: | - Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' - Todos os saldos informados estão representados com a moeda vigente do Brasil. + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' example: BRL - CreditCardsAvailableAmount: + AccountBalancesData: type: object description: | - Valor disponível do limite informado + Conjunto de informações das Contas de: depósito à vista, poupança e de pagamento pré-paga + required: + - availableAmount + - blockedAmount + - automaticallyInvestedAmount properties: - amount: + availableAmount: + $ref: '#/components/schemas/AccountBalancesDataAvailableAmount' + blockedAmount: + $ref: '#/components/schemas/AccountBalancesDataBlockedAmount' + automaticallyInvestedAmount: + $ref: '#/components/schemas/AccountBalancesDataAutomaticallyInvestedAmount' + AccountData: + type: object + required: + - brandName + - companyCnpj + - type + - compeCode + - number + - checkDigit + - accountId + properties: + brandName: type: string - format: double - pattern: '^-?\d{1,15}\.\d{2,4}$' - maxLength: 21 - minLength: 4 - example: '1000.0400' - description: | - Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. - - [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. - currency: + description: 'Nome da Marca reportada pelo participante no Open Finance. Recomenda-se utilizar, sempre que possível, o mesmo nome de marca atribuído no campo do diretório Customer Friendly Server Name (Authorisation Server).' + maxLength: 80 + pattern: '[\w\W\s]*' + example: Organização A + companyCnpj: type: string - pattern: '^[A-Z]{3}$' + maxLength: 14 + pattern: '^\d{14}$' + description: 'Número completo do CNPJ da instituição responsável pelo Cadastro - o CNPJ corresponde ao número de inscrição no Cadastro de Pessoa Jurídica. Deve-se ter apenas os números do CNPJ, sem máscara' + example: '21128159000166' + type: + $ref: '#/components/schemas/EnumAccountType' + compeCode: + type: string + description: 'Código identificador atribuído pelo Banco Central do Brasil às instituições participantes do STR (Sistema de Transferência de reservas).O Compe (Sistema de Compensação de Cheques e Outros Papéis) é um sistema que identifica e processa as compensações bancárias. Ele é representado por um código de três dígitos que serve como identificador de bancos, sendo assim, cada instituição bancária possui um número exclusivo' + pattern: '^\d{3}$' maxLength: 3 + example: '001' + branchCode: + type: string description: | - Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' - Todos os saldos informados estão representados com a moeda vigente do Brasil. + Código da Agência detentora da conta. (Agência é a dependência destinada ao atendimento aos clientes, ao público em geral e aos associados de cooperativas de crédito, no exercício de atividades da instituição, não podendo ser móvel ou transitória) - [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. - example: BRL - CreditCardsBillTotalAmount: - type: object - required: - - amount - - currency - description: | - Valor total da faturas. - O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor. - properties: - amount: + [Restrição] Obrigatoriamente deve ser preenchido quando o campo "type" for diferente de CONTA_PAGAMENTO_PRE_PAGA. + pattern: '^\d{4}$' + maxLength: 4 + example: '6272' + number: type: string - format: double - pattern: '^-?\d{1,15}\.\d{2,4}$' - maxLength: 21 - minLength: 4 - example: '1000.0400' - description: Valor total da faturas. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. - currency: + description: Número da conta + pattern: '^\d{8,20}$' + maxLength: 20 + example: '94088392' + checkDigit: type: string - pattern: '^[A-Z]{3}$' - maxLength: 3 - description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' - example: BRL - CreditCardAccountsBillMinimumAmount: + description: Dígito da conta + pattern: '[\w\W\s]*' + maxLength: 1 + example: '4' + accountId: + type: string + description: 'Identifica de forma única a conta do cliente, mantendo as regras de imutabilidade dentro da instituição transmissora.' + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + maxLength: 100 + minLength: 1 + example: '92792126019929279212650822221989319252576' + AccountIdentificationData: type: object + description: | + Conjunto dos atributos que caracterizam as Contas de: depósito à vista, poupança e de pagamento pré-paga required: - - amount + - compeCode + - number + - checkDigit + - type + - subtype - currency - description: | - Valor do pagamento minimo da fatura properties: - amount: + compeCode: + type: string + maxLength: 3 + pattern: '^\d{3}$' + description: 'Código identificador atribuído pelo Banco Central do Brasil às instituições participantes do STR (Sistema de Transferência de reservas). O número-código substituiu o antigo código COMPE. Todos os participantes do STR, exceto as Infraestruturas do Mercado Financeiro (IMF) e a Secretaria do Tesouro Nacional, possuem um número-código independentemente de participarem da Centralizadora da Compensação de Cheques (Compe). O campo tem a anotação “n/a” (“não se aplica”) para os participantes do STR aos quais não é atribuído um número-código' + example: '001' + branchCode: + type: string + maxLength: 4 + pattern: '^\d{4}$' + description: | + Código da Agência detentora da conta. (Agência é a dependência destinada ao atendimento aos clientes, ao público em geral e aos associados de cooperativas de crédito, no exercício de atividades da instituição, não podendo ser móvel ou transitória) + + [Restrição] Obrigatoriamente deve ser preenchido quando o campo "type" for diferente de conta pré-paga. + example: '6272' + number: type: string - format: double - pattern: '^\d{1,15}\.\d{2,4}$' maxLength: 20 - minLength: 4 - example: '1000.0400' - description: Valor do pagamento minimo da fatura + pattern: '^\d{8,20}$' + description: | + Número da conta + example: '24550245' + checkDigit: + type: string + maxLength: 1 + pattern: '[\w\W\s]*' + description: | + Dígito da conta + example: '4' + type: + $ref: '#/components/schemas/EnumAccountType' + subtype: + $ref: '#/components/schemas/EnumAccountSubType' currency: type: string - pattern: '^[A-Z]{3}$' + pattern: '^(\w{3}){1}$' maxLength: 3 - description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + description: | + Moeda referente ao valor da transação, segundo modelo ISO-4217. p.ex. 'BRL' + Todos os saldos informados estão representados com a moeda vigente do Brasil example: BRL - CreditCardAccountsTransaction: + AccountOverdraftLimitsData: + type: object + description: | + Conjunto de informações da Conta de: depósito à vista + properties: + overdraftContractedLimit: + $ref: '#/components/schemas/AccountOverdraftLimitsDataOverdraftContractedLimit' + overdraftUsedLimit: + $ref: '#/components/schemas/AccountOverdraftLimitsDataOverdraftUsedLimit' + unarrangedOverdraftAmount: + $ref: '#/components/schemas/AccountOverdraftLimitsDataUnarrangedOverdraftAmount' + AccountTransactionsData: type: object - description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga required: - - identificationNumber - - transactionName + - completedAuthorisedPaymentType - creditDebitType - - transactionType - - chargeIdentificator - - brazilianAmount - - amount + - transactionName + - type + - transactionAmount - transactionDate - - billPostDate - properties: - transactionId: - type: string - maxLength: 100 - minLength: 1 - pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' - example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl - description: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. - identificationNumber: - type: string - maxLength: 100 - minLength: 1 - pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' - example: '4453' - description: | - Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. - transactionName: - type: string - maxLength: 100 - pattern: '[\w\W\s]*' - example: PGTO - description: Campo de livre preenchimento. Literal usada na instituição financeira para identificar a transação - billId: + properties: + transactionId: type: string + description: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. maxLength: 100 minLength: 1 pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' - example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM - description: Informação que identifica a fatura onde consta a transação informada. + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + completedAuthorisedPaymentType: + $ref: '#/components/schemas/EnumCompletedAuthorisedPaymentIndicator' creditDebitType: $ref: '#/components/schemas/EnumCreditDebitIndicator' - transactionType: - $ref: '#/components/schemas/EnumCreditCardTransactionType' - transactionalAdditionalInfo: + transactionName: type: string - maxLength: 140 - pattern: '^\S[\s\S]*$' - description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' - paymentType: - $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' - feeType: - $ref: '#/components/schemas/EnumCreditCardAccountFee' - feeTypeAdditionalInfo: + maxLength: 60 + pattern: '[\w\W\s]*' + description: Campo livre que corresponde ao identificador da transação na instituição financeira + example: TRANSFCWAR5TXHCX5I9IDBHML8082N8NEO30M6LNNG7ANAYIJYRM00ZBZPU8 + type: + $ref: '#/components/schemas/EnumTransactionTypes' + transactionAmount: + $ref: '#/components/schemas/AccountTransactionsDataAmount' + transactionDate: type: string - pattern: '^\S[\s\S]*$' - maxLength: 140 - description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' - otherCreditsType: - $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' - otherCreditsAdditionalInfo: + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + description: | + Se indicador de transação: + TRANSACAO_EFETIVADA - corresponde a data de lançamento da transação + LANCAMENTO_FUTURO - corresponde a data prevista de efetivação da transação + example: '2021-01-07' + partieCnpjCpf: type: string - maxLength: 50 - pattern: '^\S[\s\S]*$' + maxLength: 14 + pattern: '^\d{11}$|^\d{14}$' description: | - Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. - - [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". - chargeIdentificator: + Identificação da pessoa envolvida na transação: pagador ou recebedor (Preencher com o CPF ou CNPJ, sem formatação) + example: '43908445778' + partiePersonType: + $ref: '#/components/schemas/EnumPartiePersonType' + partieCompeCode: + type: string + maxLength: 3 + pattern: '^\d{3}$' + description: 'Código identificador atribuído pelo Banco Central do Brasil às instituições participantes do STR (Sistema de Transferência de reservas) referente à pessoa envolvida na transação. O número-código substituiu o antigo código COMPE. Todos os participantes do STR, exceto as Infraestruturas do Mercado Financeiro (IMF) e a Secretaria do Tesouro Nacional, possuem um número-código independentemente de participarem da Centralizadora da Compensação de Cheques (Compe). O campo tem a anotação “n/a” (“não se aplica”) para os participantes do STR aos quais não é atribuído um número-código' + example: '001' + partieBranchCode: + type: string + maxLength: 4 + pattern: '^\d{4}$' + description: 'Código da Agência detentora da conta da pessoa envolvida na transação. (Agência é a dependência destinada ao atendimento aos clientes, ao público em geral e aos associados de cooperativas de crédito, no exercício de atividades da instituição, não podendo ser móvel ou transitória)' + example: '6272' + partieNumber: type: string - maxLength: 50 + maxLength: 20 + pattern: '^\d{8,20}$' + description: Número da conta da pessoa envolvida na transação + example: '67890854360' + partieCheckDigit: + type: string + maxLength: 1 pattern: '[\w\W\s]*' - example: PARCELA_1 - description: Identificador da parcela que está sendo informada. Campo de livre preenchimento - chargeNumber: - type: number - format: integer - maximum: 999 - example: 12 - description: | - Quantidade de parcelas. - [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. - brazilianAmount: - $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + description: Dígito da conta da pessoa envolvida na transação + example: '4' + AccountTransactionsDataAmount: + type: object + description: Valor da transação. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + required: + - amount + - currency + properties: amount: - $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' - transactionDate: type: string - format: date + format: double + pattern: '^\d{1,15}\.\d{2,4}$' maxLength: 20 - pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' - example: '2021-05-21' - description: Data original da transação - billPostDate: + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: type: string - format: date - maxLength: 20 - pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' - example: '2021-05-21' - description: Data em que a transação foi inserida na fatura - payeeMCC: - type: number - format: integer - maximum: 2147483647 - example: 5137 - description: | - O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). - EnumCreditCardAccountFee: - type: string - description: | - Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. - - [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. - enum: - - ANUIDADE - - SAQUE_CARTAO_BRASIL - - SAQUE_CARTAO_EXTERIOR - - AVALIACAO_EMERGENCIAL_CREDITO - - EMISSAO_SEGUNDA_VIA - - TARIFA_PAGAMENTO_CONTAS - - SMS - - OUTRA - example: ANUIDADE - EnumCreditCardAccountsBillingValueType: - type: string - description: | - Traz os tipos dos valores relativos aos pagamentos da fatura da conta de pagamento pós-paga: (Vide Enum) - - Valor de pagamento da fatura com parcelamento - - Valor pagamento da fatura realizado - - Outro Valor pago na fatura - - VALOR_PAGAMENTO_FATURA_PARCELADO: Quando o pagamento corresponde ao fato gerador para abertura do plano de parcelamento da fatura - - VALOR_PAGAMENTO_FATURA_REALIZADO: Quando o pagamento corresponde ao valor total da fatura - - OUTRO_VALOR_PAGO_FATURA: Demais casos - enum: - - VALOR_PAGAMENTO_FATURA_PARCELADO - - VALOR_PAGAMENTO_FATURA_REALIZADO - - OUTRO_VALOR_PAGO_FATURA - EnumCreditCardAccountsConsolidationType: + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + EnumAccountSubType: type: string - description: | - Indicador que permite informar se o valor do limite é consolidado ou individual. - - CONSOLIDADO: utilizado quando o limite da conta cartão é compartilhado entre todos os métodos de pagamento (paymentMethod) atrelados a conta. - - INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado. enum: - - CONSOLIDADO - INDIVIDUAL - example: CONSOLIDADO - EnumCreditCardAccountsFinanceChargeType: - type: string - description: | - Traz a denominação dos Encargos que - incidem na fatura da conta de pagamento pós-paga. (Vide Enum) - - Juros remuneratórios por atraso no pagamento da fatura - - Multa por atraso no pagamento da fatura - - Juros de mora por atraso no pagamento da fatura - - IOF - - Sem Encargo - - Outros - enum: - - JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA - - MULTA_ATRASO_PAGAMENTO_FATURA - - JUROS_MORA_ATRASO_PAGAMENTO_FATURA - - IOF - - OUTROS - EnumCreditCardAccountsLineLimitType: - type: string - description: | - Indicador do tipo de limite - - LIMITE_CREDITO_TOTAL: Limite de crédito total aplicado a conta cartão. - - LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição). - enum: - - LIMITE_CREDITO_TOTAL - - LIMITE_CREDITO_MODALIDADE_OPERACAO - example: LIMITE_CREDITO_TOTAL - EnumCreditCardAccountNetwork: - type: string + - CONJUNTA_SIMPLES + - CONJUNTA_SOLIDARIA description: | - Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). - Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. - enum: - - VISA - - MASTERCARD - - AMERICAN_EXPRESS - - DINERS_CLUB - - HIPERCARD - - BANDEIRA_PROPRIA - - CHEQUE_ELETRONICO - - ELO - - OUTRAS - example: VISA - EnumCreditCardAccountsOtherCreditType: + Subtipo de conta (vide Enum): + Conta individual - possui um único titular + Conta conjunta simples - onde as movimentações financeiras só podem serem realizadas mediante autorização de TODOS os correntistas da conta. + Conta conjunta solidária - é a modalidade cujos titulares podem realizar movimentações de forma isolada, isto é, sem que seja necessária a autorização dos demais titulares + example: INDIVIDUAL + EnumAccountType: type: string - description: | - Traz outros tipos de crédito contratados no cartão. - - [Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. enum: - - CREDITO_ROTATIVO - - PARCELAMENTO_FATURA - - EMPRESTIMO - - OUTROS - example: CREDITO_ROTATIVO - EnumCreditCardAccountsPaymentMode: - type: string + - CONTA_DEPOSITO_A_VISTA + - CONTA_POUPANCA + - CONTA_PAGAMENTO_PRE_PAGA description: | - Traz as formas de efetivação do pagamento realizado: (Vide Enum) - - Débito em conta corrente - - Boleto bancário - - Averbação em folha - - PIX - enum: - - DEBITO_CONTA_CORRENTE - - BOLETO_BANCARIO - - AVERBACAO_FOLHA - - PIX - EnumCreditCardAccountsPaymentType: + Tipos de contas. Modalidades tradicionais previstas pela Resolução 4.753, não contemplando contas vinculadas, conta de domiciliados no exterior, contas em moedas estrangeiras e conta correspondente moeda eletrônica. Vide Enum + Conta de depósito à vista ou Conta corrente - é o tipo mais comum. Nela, o dinheiro fica à sua disposição para ser sacado a qualquer momento. Essa conta não gera rendimentos para o depositante + Conta poupança - foi criada para estimular as pessoas a pouparem. O dinheiro que ficar na conta por trinta dias passa a gerar rendimentos, com isenção de imposto de renda para quem declara. Ou seja, o dinheiro “cresce” (rende) enquanto ficar guardado na conta. Cada depósito terá rendimentos de mês em mês, sempre no dia do mês em que o dinheiro tiver sido depositado + Conta de pagamento pré-paga: segundo CIRCULAR Nº 3.680, BCB de 2013, é a 'destinada à execução de transações de pagamento em moeda eletrônica realizadas com base em fundos denominados em reais previamente aportados' + example: CONTA_DEPOSITO_A_VISTA + EnumCompletedAuthorisedPaymentIndicator: type: string description: | - Traz os tipos de pagamento. - - [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. - enum: - - A_VISTA - - A_PRAZO - example: A_VISTA - EnumCreditCardAccountsProductType: - type: string - description: 'Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.' - enum: - - CLASSIC_NACIONAL - - CLASSIC_INTERNACIONAL - - GOLD - - PLATINUM - - INFINITE - - ELECTRON - - STANDARD_NACIONAL - - STANDARD_INTERNACIONAL - - ELETRONIC - - BLACK - - REDESHOP - - MAESTRO_MASTERCARD_MAESTRO - - GREEN - - BLUE - - BLUEBOX - - PROFISSIONAL_LIBERAL - - CHEQUE_ELETRONICO - - CORPORATIVO - - EMPRESARIAL - - COMPRAS - - BASICO_NACIONAL - - BASICO_INTERNACIONAL - - NANQUIM - - GRAFITE - - MAIS - - OUTROS - example: OUTROS - EnumCreditCardTransactionType: - type: string - description: Traz os tipos de Transação + Indicador da transação: + - Transação efetivada + - Lançamento futuro enum: - - PAGAMENTO - - TARIFA - - OPERACOES_CREDITO_CONTRATADAS_CARTAO - - ESTORNO - - CASHBACK - - OUTROS - example: CASHBACK + - TRANSACAO_EFETIVADA + - LANCAMENTO_FUTURO + example: TRANSACAO_EFETIVADA EnumCreditDebitIndicator: type: string description: | @@ -1178,6 +770,41 @@ components: - CREDITO - DEBITO example: DEBITO + EnumPartiePersonType: + type: string + enum: + - PESSOA_NATURAL + - PESSOA_JURIDICA + example: PESSOA_NATURAL + description: | + Identificação do Tipo de Pessoa da pessoa envolvida na transação. + Pessoa Natural - Informar CPF no campo “payerCnpjCpf”. + Pessoa Jurídica - Informar CNPJ no campo “payerCnpjCpf”. + EnumTransactionTypes: + type: string + description: | + O campo deve classificar a transação em um dos tipos descritos. O transmissor deve classificar as transações disponíveis associando-a a um dos itens do Enum listado neste campo. + A opção OUTROS só deve ser utilizada para os casos em que de fato a transação compartilhada não possa ser classificada como um dos itens deste Enum. + enum: + - TED + - DOC + - PIX + - TRANSFERENCIA_MESMA_INSTITUICAO + - BOLETO + - CONVENIO_ARRECADACAO + - PACOTE_TARIFA_SERVICOS + - TARIFA_SERVICOS_AVULSOS + - FOLHA_PAGAMENTO + - DEPOSITO + - SAQUE + - CARTAO + - ENCARGOS_JUROS_CHEQUE_ESPECIAL + - RENDIMENTO_APLIC_FINANCEIRA + - PORTABILIDADE_SALARIO + - RESGATE_APLIC_FINANCEIRA + - OPERACAO_CREDITO + - OUTROS + example: PIX Links: type: object description: Referências para outros recusos da API requisitada. @@ -1219,6 +846,40 @@ components: description: URI da última página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta example: 'https://api.banco.com.br/open-banking/api/v1/resource' pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + TransactionsLinks: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' Meta: type: object description: Meta informações referente à API requisitada. @@ -1255,7 +916,7 @@ components: maxLength: 20 format: date-time example: '2021-05-21T08:30:00Z' - ResponseCreditCardAccountsList: + ResponseAccountList: type: object required: - data @@ -1264,15 +925,15 @@ components: properties: data: type: array - description: Conjunto de informações de conta de pagamento pós-paga - items: - $ref: '#/components/schemas/CreditCardAccountsData' + description: 'Lista de contas depósito à vista, poupança e pagamento pré-pagas mantidas pelo cliente na instituição transmissora e para as quais ele tenha fornecido consentimento' minItems: 0 + items: + $ref: '#/components/schemas/AccountData' links: $ref: '#/components/schemas/Links' meta: $ref: '#/components/schemas/Meta' - ResponseCreditCardAccountsBills: + ResponseAccountBalances: type: object required: - data @@ -1280,15 +941,12 @@ components: - meta properties: data: - type: array - minItems: 0 - items: - $ref: '#/components/schemas/CreditCardAccountsBillsData' + $ref: '#/components/schemas/AccountBalancesData' links: $ref: '#/components/schemas/Links' meta: $ref: '#/components/schemas/Meta' - ResponseCreditCardAccountsIdentification: + ResponseAccountIdentification: type: object required: - data @@ -1296,12 +954,12 @@ components: - meta properties: data: - $ref: '#/components/schemas/CreditCardsAccountsIdentificationData' + $ref: '#/components/schemas/AccountIdentificationData' links: $ref: '#/components/schemas/Links' meta: $ref: '#/components/schemas/Meta' - ResponseCreditCardAccountsLimits: + ResponseAccountOverdraftLimits: type: object required: - data @@ -1309,21 +967,12 @@ components: - meta properties: data: - type: array - description: | - [Restrição] A lista vazia deve ser interpretada como a ausência da informação. - - Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. - - Cenário de "cartão sem limite", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. - minItems: 0 - items: - $ref: '#/components/schemas/CreditCardAccountsLimitsData' + $ref: '#/components/schemas/AccountOverdraftLimitsData' links: $ref: '#/components/schemas/Links' meta: $ref: '#/components/schemas/Meta' - ResponseCreditCardAccountsTransactions: + ResponseAccountTransactions: type: object required: - data @@ -1332,9 +981,11 @@ components: properties: data: type: array + description: | + Lista dos lançamentos referentes às transações realizadas e de lançamentos futuros para as contas de: depósito à vista, poupança e de pagamento pré-paga minItems: 0 items: - $ref: '#/components/schemas/CreditCardAccountsTransaction' + $ref: '#/components/schemas/AccountTransactionsData' links: $ref: '#/components/schemas/TransactionsLinks' meta: @@ -1405,93 +1056,47 @@ components: maxLength: 2048 meta: $ref: '#/components/schemas/Meta' - TransactionsLinks: - type: object - description: Referências para outros recusos da API requisitada. - required: - - self - properties: - self: - type: string - format: uri - maxLength: 2000 - description: URI completo que gerou a resposta atual. - example: 'https://api.banco.com.br/open-banking/api/v1/resource' - pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' - first: - type: string - format: uri - maxLength: 2000 - description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta - example: 'https://api.banco.com.br/open-banking/api/v1/resource' - pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' - prev: - type: string - format: uri - maxLength: 2000 - description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" - example: 'https://api.banco.com.br/open-banking/api/v1/resource' - pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' - next: - type: string - format: uri - maxLength: 2000 - description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta - example: 'https://api.banco.com.br/open-banking/api/v1/resource' - pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' XFapiInteractionId: type: string pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' maxLength: 100 description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' parameters: - Authorization: - name: Authorization - in: header - description: Cabeçalho HTTP padrão. Permite que as credenciais sejam fornecidas dependendo do tipo de recurso solicitado - required: true - schema: - type: string - pattern: '[\w\W\s]*' - maxLength: 2048 - billId: - name: billId - in: path - description: Identificador da fatura. - required: true - schema: - type: string - pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' - maxLength: 100 - creditCardAccountId: - name: creditCardAccountId + accountId: + name: accountId in: path - description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade detro da instituição transmissora' + description: 'Identificador da conta de depósito à vista, de poupança ou de pagamento pré-paga.' required: true schema: type: string pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' maxLength: 100 - creditCardPayeeMCC: - name: payeeMCC - description: 'MCC é o Merchant Category Code, ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades' + accountType: + name: accountType + description: 'Tipos de contas. Modalidades tradicionais previstas pela Resolução 4.753, não contemplando contas vinculadas, conta de domiciliados no exterior, contas em moedas estrangeiras e conta correspondente moeda eletrônica. Vide Enum.' required: false in: query schema: - type: number - maximum: 9999 - example: 8299 - format: int32 - creditCardTransactionType: - name: transactionType - description: Traz os tipos de Transação + $ref: '#/components/schemas/EnumAccountType' + Authorization: + name: Authorization + in: header + description: Cabeçalho HTTP padrão. Permite que as credenciais sejam fornecidas dependendo do tipo de recurso solicitado + required: true + schema: + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + creditDebitIndicator: + name: creditDebitIndicator + description: Indicador do tipo de lançamento required: false in: query schema: - $ref: '#/components/schemas/EnumCreditCardTransactionType' - fromDueDate: - name: fromDueDate - description: Data inicial de filtragem. + $ref: '#/components/schemas/EnumCreditDebitIndicator' + fromBookingDate: + name: fromBookingDate + description: 'Data inicial de filtragem. [Restrição] Deve obrigatoriamente ser enviado caso o campo toBookingDate seja informado. Caso não seja informado, deve ser assumido o dia atual.' required: false in: query schema: @@ -1499,32 +1104,40 @@ components: maxLength: 10 format: date example: '2021-05-21' - fromTransactionDate: - name: fromTransactionDate + fromBookingDateMaxLimited: + in: query + name: fromBookingDate description: | - Data inicial de filtragem. - - [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + Data inicial de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + [Restrição] Deve obrigatoriamente ser enviado caso o campo toBookingDate seja informado. + Caso não seja informado, deve ser assumido o dia atual. required: false - in: query schema: type: string maxLength: 10 format: date example: '2021-05-21' - fromTransactionDateMaxLimited: - name: fromTransactionDate + toBookingDateMaxLimited: + in: query + name: toBookingDate description: | - Data inicial de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). - - [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + Data final de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromBookingDate seja informado. + Caso não seja informado, deve ser assumido o dia atual. required: false - in: query schema: type: string maxLength: 10 format: date example: '2021-05-21' + pagination-key: + name: pagination-key + in: query + description: 'Identificador de rechamada, utilizado para evitar a contagem de chamadas ao endpoint durante a paginação.' + schema: + type: string + maxLength: 2048 + pattern: '[\w\W\s]*' page: name: page in: query @@ -1545,43 +1158,9 @@ components: minimum: 1 format: int32 maximum: 1000 - pagination-key: - name: pagination-key - in: query - description: 'Identificador de rechamada, utilizado para evitar a contagem de chamadas ao endpoint durante a paginação.' - schema: - type: string - maxLength: 2048 - pattern: '[\w\W\s]*' - toDueDate: - name: toDueDate - description: Data final de filtragem. - required: false - in: query - schema: - type: string - maxLength: 10 - format: date - example: '2021-05-21' - toTransactionDate: - name: toTransactionDate - description: | - Data final de filtragem. - - [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. - required: false - in: query - schema: - type: string - maxLength: 10 - format: date - example: '2021-05-21' - toTransactionDateMaxLimited: - name: toTransactionDate - description: | - Data final de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). - - [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + toBookingDate: + name: toBookingDate + description: 'Data final de filtragem. [Restrição] Deve obrigatoriamente ser enviado caso o campo fromBookingDate seja informado. Caso não seja informado, deve ser assumido o dia atual.' required: false in: query schema: @@ -1641,20 +1220,10 @@ components: authorizationUrl: 'https://authserver.example/authorization' tokenUrl: 'https://authserver.example/token' scopes: - credit-cards-accounts: Escopo necessário para acesso à API Credit-cards-accounts. O controle dos endpoints específicos é feito via permissions. + accounts: Escopo necessário para acesso à API Accounts. O controle dos endpoints específicos é feito via permissions. responses: - OKResponseCreditCardAccountsList: - description: Conjunto de informações das Contas de pagamento pós paga - headers: - x-fapi-interaction-id: - schema: - $ref: '#/components/schemas/XFapiInteractionId' - content: - application/json: - schema: - $ref: '#/components/schemas/ResponseCreditCardAccountsList' - OKResponseCreditCardAccountsIdentification: - description: Dados de identificação da conta identificada por creditCardAccountId obtidos com sucesso. + OKResponseAccountList: + description: Dados de identificação das contas obtidos com sucesso. headers: x-fapi-interaction-id: schema: @@ -1662,9 +1231,9 @@ components: content: application/json: schema: - $ref: '#/components/schemas/ResponseCreditCardAccountsIdentification' - OKResponseCreditCardAccountsBills: - description: Dados referentes à lista de faturas da conta identificada por creditCardAccountId obtidos com sucesso. + $ref: '#/components/schemas/ResponseAccountList' + OKResponseAccountIdentification: + description: Dados de identificação da conta identificada por accountId obtidos com sucesso. headers: x-fapi-interaction-id: schema: @@ -1672,9 +1241,9 @@ components: content: application/json: schema: - $ref: '#/components/schemas/ResponseCreditCardAccountsBills' - OKResponseCreditCardAccountsLimits: - description: Dados dos limites da conta identificada por creditCardAccountId obtidos com sucesso. + $ref: '#/components/schemas/ResponseAccountIdentification' + OKResponseAccountBalances: + description: Dados relativos aos saldos da conta identificada por accountId obtidos com sucesso. headers: x-fapi-interaction-id: schema: @@ -1682,9 +1251,9 @@ components: content: application/json: schema: - $ref: '#/components/schemas/ResponseCreditCardAccountsLimits' - OKResponseCreditCardAccountsTransactions: - description: Dados das lista de transações da conta identificada obtidos com sucesso. + $ref: '#/components/schemas/ResponseAccountBalances' + OKResponseAccountTransactions: + description: Dados da lista de transações da conta identificada por accountId obtidos com sucesso. headers: x-fapi-interaction-id: schema: @@ -1692,9 +1261,9 @@ components: content: application/json: schema: - $ref: '#/components/schemas/ResponseCreditCardAccountsTransactions' - OKResponseCreditCardAccountsBillsTransactions: - description: Dados das lista de transações da conta identificada obtidos com sucesso. + $ref: '#/components/schemas/ResponseAccountTransactions' + OKResponseAccountOverdraftLimits: + description: Dados de limites da conta identificada por accountId obtidos com sucesso. headers: x-fapi-interaction-id: schema: @@ -1702,21 +1271,7 @@ components: content: application/json: schema: - type: object - required: - - data - - links - - meta - properties: - data: - type: array - minItems: 0 - items: - $ref: '#/components/schemas/CreditCardAccountsTransaction' - links: - $ref: '#/components/schemas/Links' - meta: - $ref: '#/components/schemas/Meta' + $ref: '#/components/schemas/ResponseAccountOverdraftLimits' BadRequest: description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' content: @@ -1729,14 +1284,14 @@ components: application/json; charset=utf-8: schema: $ref: '#/components/schemas/ResponseErrorMetaSingle' - InternalServerError: - description: Ocorreu um erro no gateway da API ou no microsserviço + GatewayTimeout: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido content: application/json; charset=utf-8: schema: $ref: '#/components/schemas/ResponseErrorMetaSingle' - GatewayTimeout: - description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + InternalServerError: + description: Ocorreu um erro no gateway da API ou no microsserviço content: application/json; charset=utf-8: schema: @@ -1771,14 +1326,14 @@ components: application/json; charset=utf-8: schema: $ref: '#/components/schemas/ResponseErrorMetaSingle' - UnprocessableEntity: - description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + Unauthorized: + description: Cabeçalho de autenticação ausente/inválido ou token inválido content: application/json; charset=utf-8: schema: $ref: '#/components/schemas/ResponseErrorMetaSingle' - Unauthorized: - description: Cabeçalho de autenticação ausente/inválido ou token inválido + UnprocessableEntity: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' content: application/json; charset=utf-8: schema: diff --git a/swagger-apis/accounts/index.html b/swagger-apis/accounts/index.html index 813f6b678..78cd2547a 100644 --- a/swagger-apis/accounts/index.html +++ b/swagger-apis/accounts/index.html @@ -54,8 +54,9 @@ {"name": "1.0.3", "url": "./1.0.3.yml"}, {"name": "2.0.0-RC1.0", "url": "./2.0.0-RC1.0.yml"}, {"name": "2.0.0", "url": "./2.0.0.yml"}, - {"name": "2.0.1", "url": "./2.0.1.yml"}], - "urls.primaryName": "2.0.1", // default spec + {"name": "2.0.1", "url": "./2.0.1.yml"}, + {"name": "2.1.0-rc.1", "url": "./2.1.0-rc.1.yml"}], + "urls.primaryName": "2.1.0-rc.1", // default spec dom_id: '#swagger-ui', deepLinking: true, supportedSubmitMethods:[], diff --git a/swagger-apis/credit-cards/index.html b/swagger-apis/credit-cards/index.html index 5a6cad397..0e2ce4a15 100644 --- a/swagger-apis/credit-cards/index.html +++ b/swagger-apis/credit-cards/index.html @@ -54,9 +54,8 @@ {"name": "1.0.4", "url": "./1.0.4.yml"}, {"name": "2.0.0-RC1.0", "url": "./2.0.0-RC1.0.yml"}, {"name": "2.0.0", "url": "./2.0.0.yml"}, - {"name": "2.0.1", "url": "./2.0.1.yml"}, - {"name": "2.1.0-rc.1", "url": "./2.1.0-rc.1.yml"}], - "urls.primaryName": "2.1.0-rc.1", // default spec + {"name": "2.0.1", "url": "./2.0.1.yml"}], + "urls.primaryName": "2.0.1", // default spec dom_id: '#swagger-ui', deepLinking: true, supportedSubmitMethods:[], From c5024b36852e64a083905c15712122e749aa7d76 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 18 Jul 2023 15:55:47 -0300 Subject: [PATCH 2/2] fix: conflito aggr-accounts --- swagger-apis/credit-cards/2.1.0-rc.1.yml | 1875 ++++++++++++++++++++++ swagger-apis/credit-cards/index.html | 5 +- 2 files changed, 1878 insertions(+), 2 deletions(-) create mode 100644 swagger-apis/credit-cards/2.1.0-rc.1.yml diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml new file mode 100644 index 000000000..dcdf6fa81 --- /dev/null +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -0,0 +1,1875 @@ +openapi: 3.0.0 +info: + title: API Credit-cards-accounts - Open Finance Brasil + description: | + API de contas de pagamento pós-pagas do Open Finance Brasil – Fase 2. + API que retorna informações de contas de pagamento pós-paga mantidas nas instituições transmissoras por seus clientes, incluindo dados como denominação, produto, bandeira, limites de crédito, informações sobre transações de pagamento efetuadas e faturas. + + Não possui segregação entre pessoa natural e pessoa jurídica.\ + Requer consentimento do cliente para todos os `endpoints`. + + # Orientações + A `Role` do diretório de participantes relacionada à presente API é a `DADOS`.\ + Para todos os `endpoints` desta API é previsto o envio de um `token` através do header `Authorization`.\ + Este token deverá estar relacionado ao consentimento (`consentId`) mantido na instituição transmissora dos dados, o qual permitirá a pesquisa e retorno, na API em questão, dos + dados relacionados ao `consentId` específico relacionado.\ + Os dados serão devolvidos na consulta desde que o `consentId` relacionado corresponda a um consentimento válido e com o status `AUTHORISED`.\ + É também necessário que o recurso em questão (conta, contrato, etc) esteja disponível na instituição transmissora (ou seja, sem boqueios de qualquer natureza e com todas as autorizações/consentimentos já autorizados).\ + Além disso as `permissions` necessárias deverão ter sido solicitadas quando da criação do consentimento relacionado (`consentId`).\ + Relacionamos a seguir as `permissions` necessárias para a consulta de dados em cada `endpoint` da presente API.\ + ### `/accounts/{creditCardAccountId}/bills` + - description: + - Só deve ser informada uma fatura já fechada. + - Qualquer pagamento deve ser contado para a última fatura fechada. + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + ### `/accounts/{creditCardAccountId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + + ## Permissions necessárias para a API Credit-cards-accounts + + Para cada um dos paths desta API, além dos escopos (`scopes`) indicados existem `permissions` que deverão ser observadas: + + ### `/accounts` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}/bills` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_READ** + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/limits` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_LIMITS_READ** + ### `/accounts/{creditCardAccountId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/transactions-current` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + version: 2.1.0-rc.1 + license: + name: Apache 2.0 + url: 'https://www.apache.org/licenses/LICENSE-2.0' + contact: + name: Governança do Open Finance Brasil – Especificações + email: gt-interfaces@openbankingbr.org + url: 'https://openbanking-brasil.github.io/areadesenvolvedor/' +servers: + - url: 'https://api.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Produção + - url: 'https://apih.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Homologação +tags: + - name: Credit Card + description: Operações para listagem das informações de Cartão de Crédito +paths: + /accounts: + get: + tags: + - Credit Card + summary: Conjunto de informações das Contas de pagamento pós paga + operationId: creditCardsGetAccounts + description: Método para obter a lista de contas de pagamento pós-paga mantidas pelo cliente na instituição transmissora e para as quais ele tenha fornecido consentimento + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsList' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}': + get: + tags: + - Credit Card + summary: Obtém os dados de identificação da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountId + description: Método para obter os dados de identificação da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsIdentification' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills': + get: + tags: + - Credit Card + summary: Obtém a lista de faturas da conta identificada por creditCardAccountId. + description: | + Método para obter a lista de faturas da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora.\ + Só deve ser informada uma fatura já fechada.\ + Qualquer pagamento deve ser contado para a última fatura fechada. + operationId: creditCardsGetAccountsCreditCardAccountIdBills + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromDueDate' + - $ref: '#/components/parameters/toDueDate' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBills' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills/{billId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId e billId. + operationId: creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions + description: | + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId e billId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/billId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBillsTransactions' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/limits': + get: + tags: + - Credit Card + summary: Obtém os limites da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdLimits + description: Método para obter os limites da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsLimits' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactions + description: |- + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions-current': + get: + tags: + - Credit Card + summary: Obtém a lista de transações recentes (últimos 7 dias) da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent + description: Método para obter a lista de transações recentes (últimos 7 dias) da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDateMaxLimited' + - $ref: '#/components/parameters/toTransactionDateMaxLimited' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts +components: + schemas: + CreditCardAccountsTransactionAmount: + type: object + description: | + Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsTransactionBrazilianAmount: + type: object + description: | + Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardsAccountsIdentificationData: + type: object + description: Conjunto de informações referentes à identificação da conta de pagamento pós-paga. + required: + - name + - productType + - creditCardNetwork + - paymentMethod + properties: + name: + type: string + pattern: '[\w\W\s]*' + description: | + Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'. + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Informações complementares se tipo de Cartão 'OUTROS' + maxLength: 50 + example: OURO_INTERNACIONAL + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS'. + maxLength: 50 + example: AURA CARD + paymentMethod: + type: array + description: | + Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários. + items: + $ref: '#/components/schemas/CreditCardsAccountPaymentMethod' + minItems: 1 + CreditCardAccountsBillsData: + type: object + description: Conjunto das informações referentes a lista de faturas associadas à conta de pagamento pós-paga + required: + - billId + - dueDate + - billTotalAmount + - billMinimumAmount + - isInstalment + - payments + properties: + billId: + description: Informação que identifica a fatura + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: 3459087XXZTR + dueDate: + description: 'Data de vencimento da Fatura, que aparece para pagamento pelo cliente' + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + billTotalAmount: + $ref: '#/components/schemas/CreditCardsBillTotalAmount' + billMinimumAmount: + $ref: '#/components/schemas/CreditCardAccountsBillMinimumAmount' + isInstalment: + type: boolean + description: Indica se a fatura permite parcelamento (true) ou não (false). + example: false + financeCharges: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsFinanceCharge' + minItems: 1 + description: Lista dos encargos cobrados na fatura + payments: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsPayment' + minItems: 0 + description: Lista que traz os valores relativos aos pagamentos da Fatura da conta de pagamento pós-paga + CreditCardAccountsBillsFinanceCharge: + type: object + required: + - type + - amount + - currency + properties: + type: + $ref: '#/components/schemas/EnumCreditCardAccountsFinanceChargeType' + additionalInfo: + type: string + maxLength: 140 + pattern: '[\w\W\s]*' + example: Informações Adicionais + description: 'Campo livre, de preenchimento obrigatório se selecionado tipo de encargo ''OUTROS''' + amount: + type: string + format: double + maxLength: 20 + minLength: 4 + pattern: '^\d{1,15}\.\d{2,4}$' + example: '100000.0400' + description: Valor cobrado pelo encargo. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + maxLength: 3 + pattern: '^(\w{3}){1}$' + example: BRL + description: | + Moeda referente ao valor cobrado pelo encargo, segundo modelo ISO-4217. p.ex. 'BRL' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + CreditCardAccountsBillsPayment: + type: object + required: + - valueType + - paymentDate + - paymentMode + - amount + - currency + properties: + valueType: + $ref: '#/components/schemas/EnumCreditCardAccountsBillingValueType' + paymentDate: + description: Data efetiva de quando o Pagamento da fatura foi realizado + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + paymentMode: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentMode' + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor pagamento segundo o valueType. + Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + O campo não pode assumir valor negativo por se tratar de um pagamento. + currency: + type: string + pattern: '^(\w{3}){1}$' + maxLength: 3 + description: | + Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil + example: BRL + CreditCardAccountsData: + type: object + description: Conjunto de informações das Contas de pagamento pós paga + required: + - brandName + - companyCnpj + - name + - productType + - creditCardNetwork + - creditCardAccountId + properties: + creditCardAccountId: + type: string + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade dentro da instituição transmissora.' + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: XXZTR3459087 + brandName: + type: string + description: 'Nome da Marca reportada pelo participante no Open Finance. Recomenda-se utilizar, sempre que possível, o mesmo nome de marca atribuído no campo do diretório Customer Friendly Server Name (Authorisation Server).' + pattern: '[\w\W\s]*' + maxLength: 80 + example: Organização A + companyCnpj: + type: string + description: 'Número completo do CNPJ da instituição responsável pelo Cadastro - o CNPJ corresponde ao número de inscrição no Cadastro de Pessoa Jurídica. Deve-se ter apenas os números do CNPJ, sem máscara' + pattern: '^\d{14}$' + maxLength: 14 + example: '21128159000166' + name: + type: string + description: 'Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: ''conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos' + pattern: '[\w\W\s]*' + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + description: Informações complementares se tipo de Cartão 'OUTROS' + pattern: '[\w\W\s]*' + maxLength: 50 + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS' + pattern: '[\w\W\s]*' + maxLength: 50 + example: AURA CARD + CreditCardAccountsLimitsData: + type: object + description: Conjunto de informações referentes aos limites da conta de pagamento pós-paga. + required: + - creditLineLimitType + - consolidationType + - identificationNumber + - isLimitFlexible + - usedAmountCurrency + - usedAmount + properties: + creditLineLimitType: + $ref: '#/components/schemas/EnumCreditCardAccountsLineLimitType' + consolidationType: + $ref: '#/components/schemas/EnumCreditCardAccountsConsolidationType' + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + lineName: + type: string + enum: + - CREDITO_A_VISTA + - CREDITO_PARCELADO + - SAQUE_CREDITO_BRASIL + - SAQUE_CREDITO_EXTERIOR + - EMPRESTIMO_CARTAO_CONSIGNADO + - OUTROS + example: CREDITO_A_VISTA + lineNameAdditionalInfo: + type: string + maxLength: 50 + pattern: '[\w\W\s]*' + example: Informações adicionais e complementares. + description: Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName. + isLimitFlexible: + type: boolean + description: 'Indica se a operação de crédito é: com limite flexível (true) ou com limite (false).' + example: true + limitAmount: + $ref: '#/components/schemas/CreditCardsLimitAmount' + usedAmount: + $ref: '#/components/schemas/CreditCardsUsedAmount' + availableAmount: + $ref: '#/components/schemas/CreditCardsAvailableAmount' + CreditCardsAccountPaymentMethod: + type: object + description: Conjunto de informações relativas aos Meios de Pagamento da Conta de pagamento pós-paga + required: + - identificationNumber + - isMultipleCreditCard + properties: + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + isMultipleCreditCard: + type: boolean + description: | + Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito. + example: true + CreditCardsLimitAmount: + type: object + description: | + Valor total do limite informado. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os limite informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + CreditCardsUsedAmount: + type: object + description: Valor utilizado do limite informado + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + example: BRL + CreditCardsAvailableAmount: + type: object + description: | + Valor disponível do limite informado + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: | + Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + CreditCardsBillTotalAmount: + type: object + required: + - amount + - currency + description: | + Valor total da faturas. + O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor. + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor total da faturas. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsBillMinimumAmount: + type: object + required: + - amount + - currency + description: | + Valor do pagamento minimo da fatura + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor do pagamento minimo da fatura + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsTransaction: + type: object + description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga + required: + - identificationNumber + - transactionName + - creditDebitType + - transactionType + - chargeIdentificator + - brazilianAmount + - amount + - transactionDate + - billPostDate + properties: + transactionId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + description: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + identificationNumber: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + transactionName: + type: string + maxLength: 200 + pattern: '[\w\W\s]*' + example: PGTO + description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). + billId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM + description: Informação que identifica a fatura onde consta a transação informada. + creditDebitType: + $ref: '#/components/schemas/EnumCreditDebitIndicator' + transactionType: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + transactionalAdditionalInfo: + type: string + maxLength: 140 + pattern: '^\S[\s\S]*$' + description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' + paymentType: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' + feeType: + $ref: '#/components/schemas/EnumCreditCardAccountFee' + feeTypeAdditionalInfo: + type: string + pattern: '^\S[\s\S]*$' + maxLength: 140 + description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' + otherCreditsType: + $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' + otherCreditsAdditionalInfo: + type: string + maxLength: 50 + pattern: '^\S[\s\S]*$' + description: | + Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". + chargeIdentificator: + type: string + maxLength: 50 + pattern: '[\w\W\s]*' + example: PARCELA_1 + description: Identificador da parcela que está sendo informada. Campo de livre preenchimento + chargeNumber: + type: number + format: integer + maximum: 999 + example: 12 + description: | + Quantidade de parcelas. + [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. + brazilianAmount: + $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + amount: + $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação + billPostDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data em que a transação foi inserida na fatura + payeeMCC: + type: number + format: integer + maximum: 2147483647 + example: 5137 + description: | + O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). + EnumCreditCardAccountFee: + type: string + description: | + Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. + enum: + - ANUIDADE + - SAQUE_CARTAO_BRASIL + - SAQUE_CARTAO_EXTERIOR + - AVALIACAO_EMERGENCIAL_CREDITO + - EMISSAO_SEGUNDA_VIA + - TARIFA_PAGAMENTO_CONTAS + - SMS + - OUTRA + example: ANUIDADE + EnumCreditCardAccountsBillingValueType: + type: string + description: | + Traz os tipos dos valores relativos aos pagamentos da fatura da conta de pagamento pós-paga: (Vide Enum) + - Valor de pagamento da fatura com parcelamento + - Valor pagamento da fatura realizado + - Outro Valor pago na fatura + + VALOR_PAGAMENTO_FATURA_PARCELADO: Quando o pagamento corresponde ao fato gerador para abertura do plano de parcelamento da fatura + + VALOR_PAGAMENTO_FATURA_REALIZADO: Quando o pagamento corresponde ao valor total da fatura + + OUTRO_VALOR_PAGO_FATURA: Demais casos + enum: + - VALOR_PAGAMENTO_FATURA_PARCELADO + - VALOR_PAGAMENTO_FATURA_REALIZADO + - OUTRO_VALOR_PAGO_FATURA + EnumCreditCardAccountsConsolidationType: + type: string + description: | + Indicador que permite informar se o valor do limite é consolidado ou individual. + + CONSOLIDADO: utilizado quando o limite da conta cartão é compartilhado entre todos os métodos de pagamento (paymentMethod) atrelados a conta. + + INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado. + enum: + - CONSOLIDADO + - INDIVIDUAL + example: CONSOLIDADO + EnumCreditCardAccountsFinanceChargeType: + type: string + description: | + Traz a denominação dos Encargos que + incidem na fatura da conta de pagamento pós-paga. (Vide Enum) + - Juros remuneratórios por atraso no pagamento da fatura + - Multa por atraso no pagamento da fatura + - Juros de mora por atraso no pagamento da fatura + - IOF + - Sem Encargo + - Outros + enum: + - JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA + - MULTA_ATRASO_PAGAMENTO_FATURA + - JUROS_MORA_ATRASO_PAGAMENTO_FATURA + - IOF + - OUTROS + EnumCreditCardAccountsLineLimitType: + type: string + description: | + Indicador do tipo de limite + + LIMITE_CREDITO_TOTAL: Limite de crédito total aplicado a conta cartão. + + LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição). + enum: + - LIMITE_CREDITO_TOTAL + - LIMITE_CREDITO_MODALIDADE_OPERACAO + example: LIMITE_CREDITO_TOTAL + EnumCreditCardAccountNetwork: + type: string + description: | + Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). + Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. + enum: + - VISA + - MASTERCARD + - AMERICAN_EXPRESS + - DINERS_CLUB + - HIPERCARD + - BANDEIRA_PROPRIA + - CHEQUE_ELETRONICO + - ELO + - OUTRAS + example: VISA + EnumCreditCardAccountsOtherCreditType: + type: string + description: | + Traz outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. + enum: + - CREDITO_ROTATIVO + - PARCELAMENTO_FATURA + - EMPRESTIMO + - OUTROS + example: CREDITO_ROTATIVO + EnumCreditCardAccountsPaymentMode: + type: string + description: | + Traz as formas de efetivação do pagamento realizado: (Vide Enum) + - Débito em conta corrente + - Boleto bancário + - Averbação em folha + - PIX + enum: + - DEBITO_CONTA_CORRENTE + - BOLETO_BANCARIO + - AVERBACAO_FOLHA + - PIX + EnumCreditCardAccountsPaymentType: + type: string + description: | + Traz os tipos de pagamento. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. + enum: + - A_VISTA + - A_PRAZO + example: A_VISTA + EnumCreditCardAccountsProductType: + type: string + description: 'Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.' + enum: + - CLASSIC_NACIONAL + - CLASSIC_INTERNACIONAL + - GOLD + - PLATINUM + - INFINITE + - ELECTRON + - STANDARD_NACIONAL + - STANDARD_INTERNACIONAL + - ELETRONIC + - BLACK + - REDESHOP + - MAESTRO_MASTERCARD_MAESTRO + - GREEN + - BLUE + - BLUEBOX + - PROFISSIONAL_LIBERAL + - CHEQUE_ELETRONICO + - CORPORATIVO + - EMPRESARIAL + - COMPRAS + - BASICO_NACIONAL + - BASICO_INTERNACIONAL + - NANQUIM + - GRAFITE + - MAIS + - OUTROS + example: OUTROS + EnumCreditCardTransactionType: + type: string + description: Traz os tipos de Transação + enum: + - PAGAMENTO + - TARIFA + - OPERACOES_CREDITO_CONTRATADAS_CARTAO + - ESTORNO + - CASHBACK + - OUTROS + example: CASHBACK + EnumCreditDebitIndicator: + type: string + description: | + Indicador do tipo de lançamento: + Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. + Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. + enum: + - CREDITO + - DEBITO + example: DEBITO + Links: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + last: + type: string + format: uri + maxLength: 2000 + description: URI da última página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + Meta: + type: object + description: Meta informações referente à API requisitada. + required: + - totalRecords + - totalPages + - requestDateTime + properties: + totalRecords: + type: integer + format: int32 + description: Número total de registros no resultado + example: 1 + totalPages: + type: integer + format: int32 + description: Número total de páginas no resultado + example: 1 + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + MetaOnlyRequestDateTime: + type: object + description: Meta informações referente à API requisitada. + required: + - requestDateTime + properties: + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + ResponseCreditCardAccountsList: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: Conjunto de informações de conta de pagamento pós-paga + items: + $ref: '#/components/schemas/CreditCardAccountsData' + minItems: 0 + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsBills: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsBillsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsIdentification: + type: object + required: + - data + - links + - meta + properties: + data: + $ref: '#/components/schemas/CreditCardsAccountsIdentificationData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsLimits: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: | + [Restrição] A lista vazia deve ser interpretada como a ausência da informação. + + Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. + + Cenário de "cartão sem limite", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsLimitsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsTransactions: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsTransaction' + links: + $ref: '#/components/schemas/TransactionsLinks' + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseErrorMetaSingle: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseError: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/Meta' + TransactionsLinks: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + XFapiInteractionId: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + parameters: + Authorization: + name: Authorization + in: header + description: Cabeçalho HTTP padrão. Permite que as credenciais sejam fornecidas dependendo do tipo de recurso solicitado + required: true + schema: + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + billId: + name: billId + in: path + description: Identificador da fatura. + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardAccountId: + name: creditCardAccountId + in: path + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade detro da instituição transmissora' + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardPayeeMCC: + name: payeeMCC + description: 'MCC é o Merchant Category Code, ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades' + required: false + in: query + schema: + type: number + maximum: 9999 + example: 8299 + format: int32 + creditCardTransactionType: + name: transactionType + description: Traz os tipos de Transação + required: false + in: query + schema: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + fromDueDate: + name: fromDueDate + description: Data inicial de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDate: + name: fromTransactionDate + description: | + Data inicial de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDateMaxLimited: + name: fromTransactionDate + description: | + Data inicial de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + page: + name: page + in: query + description: Número da página que está sendo requisitada (o valor da primeira página é 1). + schema: + type: integer + default: 1 + minimum: 1 + maximum: 2147483647 + format: int32 + pageSize: + name: page-size + in: query + description: Quantidade total de registros por páginas. + schema: + type: integer + default: 25 + minimum: 1 + format: int32 + maximum: 1000 + pagination-key: + name: pagination-key + in: query + description: 'Identificador de rechamada, utilizado para evitar a contagem de chamadas ao endpoint durante a paginação.' + schema: + type: string + maxLength: 2048 + pattern: '[\w\W\s]*' + toDueDate: + name: toDueDate + description: Data final de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDate: + name: toTransactionDate + description: | + Data final de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDateMaxLimited: + name: toTransactionDate + description: | + Data final de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + xCustomerUserAgent: + name: x-customer-user-agent + in: header + description: Indica o user-agent que o usuário utiliza. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiAuthDate: + name: x-fapi-auth-date + in: header + description: 'Data em que o usuário logou pela última vez com o receptor. Representada de acordo com a [RFC7231](https://tools.ietf.org/html/rfc7231).Exemplo: Sun, 10 Sep 2017 19:43:31 UTC' + required: false + schema: + type: string + pattern: '^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$' + minLength: 29 + maxLength: 29 + xFapiCustomerIpAddress: + name: x-fapi-customer-ip-address + in: header + description: O endereço IP do usuário se estiver atualmente logado com o receptor. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiInteractionId: + name: x-fapi-interaction-id + in: header + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + required: false + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + minLength: 1 + maxLength: 100 + securitySchemes: + OpenId: + type: openIdConnect + openIdConnectUrl: 'https://auth.mockbank.poc.raidiam.io/.well-known/openid-configuration' + OAuth2Security: + type: oauth2 + description: Fluxo OAuth necessário para que a receptora tenha acesso aos dados na instituição transmissora. Requer o processo de redirecionamento e autenticação do usuário a que se referem os dados. + flows: + authorizationCode: + authorizationUrl: 'https://authserver.example/authorization' + tokenUrl: 'https://authserver.example/token' + scopes: + credit-cards-accounts: Escopo necessário para acesso à API Credit-cards-accounts. O controle dos endpoints específicos é feito via permissions. + responses: + OKResponseCreditCardAccountsList: + description: Conjunto de informações das Contas de pagamento pós paga + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsList' + OKResponseCreditCardAccountsIdentification: + description: Dados de identificação da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsIdentification' + OKResponseCreditCardAccountsBills: + description: Dados referentes à lista de faturas da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsBills' + OKResponseCreditCardAccountsLimits: + description: Dados dos limites da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsLimits' + OKResponseCreditCardAccountsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsTransactions' + OKResponseCreditCardAccountsBillsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsTransaction' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + BadRequest: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Forbidden: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + InternalServerError: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + GatewayTimeout: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Locked: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + MethodNotAllowed: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotAcceptable: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotFound: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + TooManyRequests: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + UnprocessableEntity: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Unauthorized: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + SiteIsOverloaded: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Default: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + BadRequestWithAdditionalProperties: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + ForbiddenWithAdditionalProperties: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + GatewayTimeoutWithAdditionalProperties: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + InternalServerErrorWithAdditionalProperties: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + LockedWithAdditionalProperties: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + MethodNotAllowedWithAdditionalProperties: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotAcceptableWithAdditionalProperties: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotFoundWithAdditionalProperties: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + TooManyRequestsWithAdditionalProperties: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnauthorizedWithAdditionalProperties: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnprocessableEntityWithAdditionalProperties: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + DefaultWithAdditionalProperties: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + SiteIsOverloadedWithAdditionalProperties: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' diff --git a/swagger-apis/credit-cards/index.html b/swagger-apis/credit-cards/index.html index 0e2ce4a15..5a6cad397 100644 --- a/swagger-apis/credit-cards/index.html +++ b/swagger-apis/credit-cards/index.html @@ -54,8 +54,9 @@ {"name": "1.0.4", "url": "./1.0.4.yml"}, {"name": "2.0.0-RC1.0", "url": "./2.0.0-RC1.0.yml"}, {"name": "2.0.0", "url": "./2.0.0.yml"}, - {"name": "2.0.1", "url": "./2.0.1.yml"}], - "urls.primaryName": "2.0.1", // default spec + {"name": "2.0.1", "url": "./2.0.1.yml"}, + {"name": "2.1.0-rc.1", "url": "./2.1.0-rc.1.yml"}], + "urls.primaryName": "2.1.0-rc.1", // default spec dom_id: '#swagger-ui', deepLinking: true, supportedSubmitMethods:[],