Ir para o conteúdo principal

Artigo

ISO 20022 e JSON, equilibrando padronização e flexibilidade em APIs

Publicado: setembro de 2024

Uma grade 3D de cubos laranja brilhantes.

A crescente adoção da ISO 20022 e o aumento da demanda por APIs levaram a muitas inovações na Indústria Financeira. No entanto, os padrões de dados ricos da ISO 20022 podem entrar em conflito com a simplicidade e o minimalismo que o JSON, o formato de dados de facto usado em APIs, incentiva. Esse problema tem o potencial de impedir que a indústria realize os benefícios que a ISO 20022 pode fornecer.

Neste artigo, exploramos os problemas que os desenvolvedores e a indústria enfrentam ao tentar conciliar a flexibilidade e simplicidade do JSON com a riqueza de dados do ISO 20022. Também analisaremos os esforços contínuos para tentar resolver essa importante questão.

O que é a norma ISO 20022?

O ISO 20022 é um padrão global para a troca de dados entre instituições financeiras e cobre os domínios de pagamentos, câmbio, cartões, financiamento comercial e títulos. O padrão é rico, estruturado e flexível, tornando-o um grande salto em relação aos padrões globais anteriores, ISO 15022 (formato MT da SWIFT) e ISO 8583 (usado para pagamentos com cartão e pagamentos de conta para conta).

Tem havido um esforço coordenado em toda a indústria para impulsionar a adoção da norma ISO 20022, pois os benefícios são mais óbvios quando todos a estão utilizando. O ritmo desta mudança acelerou à medida que mais iniciativas fizeram a transição – com muitas Câmaras de Compensação Automatizadas (ACH) em todo o mundo utilizando agora o novo formato para pagamentos de alto e baixo valor, bem como o sistema de Pagamentos Transfronteiriços da SWIFT. A sua utilização ainda não é omnipresente, com alguns sistemas a suportar formatos legados, especialmente para pagamentos em lote; contudo, para sistemas locais de pagamentos em tempo real, a utilização da ISO 20022 é generalizada.

O escopo da ISO 20022 se concentra na troca de informações, mas o principal benefício vem do uso, pelas instituições, do Dicionário de dadosabre em uma nova guia para dar suporte a seus modelos de dados internos, adotando, em essência, uma linguagem comum. Isso significa, por exemplo, que os atributos que compõem uma Parte (Nome, Endereço, Data e Local de Nascimento etc.) são consistentes quando a Parte é um Devedor em uma transação internacional ou um Titular de Conta em uma Solicitação de Portabilidade de Conta.

A ISO 20022, como padrão, é agnóstica em relação ao formato, mas esquemas de mensagens específicos são publicados oficialmente apenas como XSDs (Definições de Esquema XML) e estão disponíveis no catálogo de mensagensabre em uma nova guia, isso levou o XML a ser o formato mais amplamente utilizado para trocar mensagens ISO 20022.

APIs, JSON e ISO 20022

À medida que o uso da ISO 20022 aumenta, também aumenta a demanda por novos casos de uso e novas formas de troca de dados, sendo um exemplo proeminente as APIs que são usadas por instituições financeiras para inúmeras aplicações, como permitir o acesso às informações da conta, iniciação de pagamentos, Open Banking ou integrações de sistemas internos.

Desenvolvedores de API, especialmente ao projetar APIs REST1, geralmente adotam uma abordagem minimalista, priorizando a eficiência e transmitindo apenas os dados essenciais necessários para uma solicitação e resposta específicas. As informações trocadas via API geralmente são enviadas em JSON (JavaScript Object Notation), que é como XML, mas tem algumas pequenas incompatibilidades.

Como a ISO 20022 não publica esquemas JSON e não há atualmente regras comumente seguidas sobre como representá-la neste formato2 isso pode apresentar desafios para desenvolvedores de API que esperam usar o padrão.

A norma ISO 20022 apoia casos de uso de mensagens financeiras globalmente, significando que cada mensagem incluirá muitos elementos. Embora os elementos-chave necessários para executar uma troca específica de mensagens de negócios, por exemplo uma transferência de crédito, permaneçam bastante consistentes (Nome do Devedor, Nome do Credor, Montante, Moeda, etc.), há variação na forma como estes elementos são utilizados. Por exemplo, nas câmaras de compensação locais, um Agente Devedor (Banco do Devedor) na Alemanha é definido usando um BIC (Código Identificador de Negócio) ou um Bankleitzahl (BLZ – derivado do IBAN), mas na Austrália é identificado usando um Número BSB (Bank State Branch).

Para acomodar isso, as mensagens ISO 20022 são estruturadas de uma forma que permite fornecer uma ou outra, mas essa flexibilidade leva a mensagens maiores do que seria estritamente necessário para qualquer caso de uso específico.

Quando os desenvolvedores projetam APIs, com ênfase no minimalismo, eles geralmente incluem apenas os elementos específicos do seu caso de uso, por exemplo, se estiverem no Reino Unido, não há muita razão para incluir o número BSB, já que todos os agentes serão identificados com um Sort Code. Da mesma forma, se um Agente só puder ser identificado com um Código de Classificação, então por que incluir parte da estrutura de uma mensagem ISO 20022 quando o nome do elemento pode ser alterado? O exemplo a seguir destaca isso:

É assim que um código de classificação do Reino Unido e um número de conta apareceriam em uma instância ISO 20022 baseada em XML:

</CdtrAcct>

    <CdtrAgt> 

        <FinInstnId> 

            <ClrSysMmbId> 

                <ClrSysId> 

                    <Cd>GBDSC</Cd> 

                </ClrSysId> 

                <MmbId>080800</MmbId> 

            </ClrSysMmbId> 

        </FinInstnId> 

    </CdtrAgt> 

    <CdtrAcct> 

        <Id> 

            <Othr> 

                <Id>21325698</Id> 

            </Othr> 

        </Id> 

    </CdtrAcct> 

O código “GBDSC” define que o ID do Membro é um “Código de Classificação Doméstica do Reino Unido”, o Id/Outro/Id contém o Número da Conta.

Em comparação, veja como os mesmos dados seriam transmitidos por meio de APIs de Open Banking do Reino Unido, que foram “projetadas usando elementos e componentes de mensagem ISO 20022 quando disponíveis”3, observe o tamanho menor, mas também a mudança de nomes de elementos, códigos e estrutura:

"CreditorAccount": {
"SchemeName": "UK.OBIE.SortCodeAccountNumber",
"Identification": "08080021325698"
}

Esse problema não é específico do Open Banking do Reino Unido e está ocorrendo em todo o setor, com APIs baseadas em ISO 20022 sendo implementadas sem diretrizes claras sobre as melhores práticas ou esquemas JSON oficiais sendo publicados. O risco de fragmentação da abordagem é alto, levando à incompatibilidade entre implementações e não realizando alguns dos benefícios que a padronização pretendia alcançar. O setor identificou esse risco e a ISO 20022 tomou algumas medidas para mitigá-lo:

  • O API SEG (Standards Evaluation Group)abre em uma nova aba foi estabelecido para registrar, desenvolver e manter recursos de API.
  • O ISO/TC 68/WG4 (Comitê Técnico 68/Grupo de Trabalho 4), o grupo responsável por gerenciar/atualizar o padrão ISO 20022, tem investigado como alterar o padrão para formalizar a introdução de recursos ISO 20022 baseados em JSON, bem como introduzir um modelo para auxiliar os modeladores que buscam registrar diferentes formatos para o padrão a ser publicado (ou seja, Esquema JSON).
  • O Grupo de Suporte Técnico (TSG) da ISO 20022abre em uma nova aba está procurando atualizar e revisar seu Whitepaper de melhores práticas JSON (referenciado no rodapé) para fornecer mais orientação sobre modelagem JSON.

À medida que o setor financeiro continua a evoluir, a padronização e a interoperabilidade contínuas são cruciais. A adoção de mensagens baseadas em JSON é um facilitador chave para a inovação, mas também representa possíveis armadilhas das quais o setor precisa estar ciente. Caso contrário, ele enfrenta o risco de desfazer muito do trabalho desafiador que foi feito antes.

A Mastercard participa ativamente dessas iniciativas e continuará colaborando com o setor para promover uma estrutura que permita a adoção de novos formatos, preservando a padronização e a interoperabilidade essenciais para a inovação futura.

Book a demo

Request a personalized demo to learn how Mastercard can enhance your business through our products and services.

Mastercard