Pain.001
The pain.001 message defined by ISO 20022 is used to submit disbursement instructions (PAyments INitiation) to banks. Specifically, pain.001 is a Customer Credit Transfer Initiation file FinDock uses for native handling of SEPA Credit Transfer disbursements.
FinDock supports the follow pain.001 versions:
- Pain.001.001.03
- Pain.001.001.09
Pain.001 file structure
The pain.001 file in aa nested XML with three main sections:
- Group header node
- Payment information node
- One or more transaction details nodes
- Payment information node
Pain.001 field mapping
The following table outlines how Salesforce data is mapped to pain.001 elements. Please note the mappings cover the most common data points and is not an exhaustive mapping of all possible variables.
Group Header node
The Group Header (GrpHdr) node includes details covering the entire scope of the file.
| Object | Field | Pain.001 element | Further info |
|---|---|---|---|
| N/A | messageId | MsgId | Unique reference generated by FinDock |
| N/A | N/A | CreDtTm | Time file was generated, Y-m-d\TH:i:s |
| N/A | Total Number of Transactions in File | NbOfTxs | Calculated during file generation |
| N/A | Sum of Total Amount in File | CtrlSum | Calculated during file generation |
| N/A | Company Name | InitgPty / Nm | From target on payment schedule |
Payment Information node
The Payment Information (PmtInf) node includes details about the creditor and the payment disbursement (batch of credit transactions).
| Object | Field | Pain.001 element | Further info |
|---|---|---|---|
| N/A | batchId | PmtInfiId | Prefix SCT-ID-1- + file generation date |
| N/A | N/A | PmtMtd | Always TRF |
| N/A | Total Number of Transactions in File | NbOfTxs | Calculated during file generation |
| N/A | Sum of Total Amount in File | CtrlSum | Calculated during file generation |
| N/A | N/A | PmtTpInf / SvcLvl / Cd | Always SEPA |
| Payment Schedule | Collection Date | ReqdColltnDt / Dt | Format Y-m-d |
| N/A | Company Name | Dbtr / Nm | From target on payment schedule |
| N/A | IBAN | DbtrAcct / Id / IBAN | From target on payment schedule |
| N/A | N/A | DbtrAcct / Ccy | EUR added if multi-currency org |
| N/A | Bank Account Addition | DbtrAgt / FinInstnId / BICFI | From target on payment schedule |
| N/A | N/A | ChrgBr | Always SLEV |
Credit Transfer Transaction Information node
The Credit Transfer Transaction Information (CdtTrfTxInf) node includes details of individual installments to be collected.
| Object | Field | Pain.001 element | Further info |
|---|---|---|---|
| Installment | Final Payment Reference | PmtId / EndtoEndId | - |
| Installment | Amount | Amt / InstdAmt / Ccy | EUR + Amount |
| Installment | BIC | CdtrAgent / FinInstanId / BICFI | If non-EEA account |
| Installment | Account Holder Name | Cdtr / Nm | Taken from linked payment profile |
| Installment | Country | Cdtr / PstlAdr / Ctry | If non-EEA account; taken from linked payment profile |
| Installment | Street + House name or number | Cdtr / PstlAdr / AdrLine1 | If non-EEA account; taken from linked payment profile |
| Installment | Zipcode + City | Cdtr / PstlAdr / AdrLine2 | If non-EEA account; taken from linked payment profile |
| Installment | IBAN | CdtrAcct / Id / IBAN | - |
| N/A | N/A | CdtrAcct / Ccy | EUR added if multi-currency org |
| Installment | Bank Statement Description | RmtInf / Ustrd | - |