Pain001 em português

Pain001: Iniciação de pagamentos ISO 20022 em código aberto

A suíte de código aberto que transforma seus dados de pagamento em XML ISO 20022 validado e comprovado antes de chegar ao banco.

Encontre os erros dos arquivos de pagamento antes do seu banco#

Pain001 é uma suíte Python de código aberto para iniciação de pagamentos ISO 20022. Ela converte os dados que você já tem (CSV, Excel, SQLite, JSON, Parquet ou mensagens SWIFT MT101 legadas) em XML pain.001 (transferências) e pain.008 (débitos diretos), validados contra os esquemas XSD oficiais.

Cada arquivo passa por três camadas de validação antes de ser gravado: esquema JSON por registro (com verificação mod-97 do IBAN e estrutura do BIC), regras de scheme (SEPA e CBPR+ internacional) e validação XSD final. Os totais de controle são recalculados, nunca copiados. Tudo roda localmente: nenhum dado de pagamento sai da sua infraestrutura.

Teste no navegador#

Valide um lote de exemplo diretamente no navegador (nada é enviado) e prove o resultado contra o esquema XSD oficial: testar o Pain001. Arquivos CSV de exemplo podem ser baixados como modelos para suas exportações.

O prazo dos endereços estruturados, adiado#

Com o fim da coexistência MT–MX em 22 de novembro de 2025, o próximo marco estava previsto para 14 de novembro de 2026: o CBPR+ passaria a rejeitar endereços postais totalmente não estruturados, e o relay interbancário MT101 seria substituído pelo pain.001 versão 9. Em agosto de 2026, a Swift adiou as duas mudanças e anunciará as novas datas até dezembro de 2026; as exigências continuam valendo. O Pain001 já trata endereços estruturados e híbridos e converte seu MT101 com um único comando.

Como começar#

pip install pain001
pain001 -t pain.001.001.09 -d payments.csv -o out/ --dry-run

Para aprofundar: guia de instalação, referência técnica, roteiro ISO 20022 até 2028, códigos de rejeição pain.002, central de confiança e resumo executivo. A documentação completa está em inglês. Licença dupla Apache-2.0 / MIT: uso comercial livre em qualquer escala.