# ISO 20022 message family mappings (canonical layer)

Lightweight mapping from ISO 20022 families to `@dbis/integration-foundation` `CanonicalFinancialEvent`.
Full XML generation and XSD validation are **future work**.

| ISO family | Direction | Canonical fields populated |
|------------|-----------|---------------------------|
| pain.001 | Outbound initiation | message_id, end_to_end_id, debtor, creditor, amount, currency, purpose_code, remittance_information |
| pain.002 | Status report | message_id, status, reason_code, end_to_end_id |
| pacs.008 | FI-to-FI credit transfer | message_id, end_to_end_id, uetr, debtor/creditor agents & accounts, amount, currency, settlement_date |
| pacs.009 | FI-to-FI cover payment | message_id, end_to_end_id, uetr, debtor_agent, creditor_agent, amount, currency |
| pacs.002 | Payment status | message_id, status, reason_code, end_to_end_id, uetr |
| pacs.004 | Payment return | message_id, end_to_end_id, reason_code, amount, currency |
| camt.052 | Intraday report | message_id, settlement_date, account balances (raw_reference) |
| camt.053 | Statement | message_id, settlement_date, raw_reference |
| camt.054 | Debit/credit notification | message_id, end_to_end_id, amount, currency, remittance_information |

**Unsupported in v0.1:** Full party address decomposition, charge bearer, structured remittance arrays, official schema validation.
