Validate ISO 20022 messages
Short answer
Validate each Aani and SWIFT CBPR+ message against its ISO 20022 XSD schema during development. Then test the applicable scheme rules and the resulting payment flow.
For payment developers and testers.
Test checklist
- Select the required XSD version and XML namespace for each message and rail.
- Omit required elements from valid fixtures and confirm a useful validation result.
- Exercise invalid dates, amounts, codes and lengths where the schema constrains them.
- Validate pacs.008 in both directions. Retain identifiers, including the UETR for SWIFT CBPR+.
- Check pacs.009 bank and cover payments with their own fixtures.
- Validate pacs.002 status and pacs.004 returns, including malformed responses.
- Exercise camt.056 and camt.029 recall exchanges separately from returns.
- Test incoming messages, duplicates and out-of-order delivery.
- Save the schema version, synthetic message, expected result and actual run. Repeat after mapping changes.
With PaySim
PaySim simulator checks every message against ISO 20022 XSD schemas using each scheme’s versions. Inbound scenarios and recorded runs support repeatable development and testing in your own environment.
Scope
- XSD validity does not guarantee scheme acceptance. Business rules and bank controls are separate checks.
- Local validation does not replace official scheme testing or certification.
- Sanctions and AML screening stay in the bank’s own systems.
Common questions
Does a valid XSD message guarantee the payment will be accepted?
No. Schema validation checks message structure against the selected schema. The payment also needs to meet the applicable scheme rules and pass the bank's own controls.
Should we validate incoming messages as well as outgoing ones?
Include both directions in your test plan. PaySim simulator checks every message against ISO 20022 XSD schemas and supports inbound testing from the simulated other side.
Which schema version should we use?
Use the version required for the message and scheme you are integrating with. PaySim uses ISO 20022 in the versions each scheme uses; retain the selected version with your test evidence.
Can we validate pacs and camt without the live scheme?
Yes. PaySim simulator runs in the bank's own environment with synthetic data for Aani and SWIFT CBPR+ scenarios. Local validation does not replace the operator's own test services or official certification.
Related guides
Last reviewed: