ISO 20022-style artifacts
ProofRails maps receipt data into XML shaped around ISO 20022 payment and cash-management message families. These files help finance systems consume onchain payment records in a familiar structure.
Typical receipt artifacts
| Artifact | Use in ProofRails |
|---|---|
pain.001 |
Payment-initiation-style representation of the recorded payment. |
pain.002 |
Processing-status-style representation. |
camt.054 |
Credit/debit-notification-style record. |
The engine also contains generation paths for cancellation, investigation, reversal, interbank transfer, refund and statement-style messages. Route availability and the artifacts generated for a specific receipt depend on the deployed API and workflow.
Retrieve receipt artifacts
GET /v1/iso/messages/{receipt_id}
Each list item includes the message type, URL, optional SHA-256 and creation timestamp.
Generate additional messages
The hosted OpenAPI currently exposes:
POST /v1/iso/camt029/{receipt_id}
POST /v1/iso/camt056/{receipt_id}
POST /v1/iso/pacs007/{receipt_id}
POST /v1/iso/pacs009/{receipt_id}
POST /v1/iso/refund
These operations have workflow-specific request bodies and authorization rules. Use the live OpenAPI schema when implementing them.
Validation boundary
The artifacts are ISO 20022-style. Generating XML or using an ISO message family name does not establish conformance with a bank, clearing system, market-practice profile or certification program. Validate the target institution's schema version, usage rules, identifiers and transport requirements before sending a file outside your organization.