# Pain.001

The pain.001 message defined by [ISO 20022](https://www.iso20022.org/iso-20022-message-definitions) is used to submit disbursement instructions (**PA**yments **IN**itiation) to banks. Specifically, pain.001 is a Customer Credit Transfer Initiation file FinDock uses for native handling of [SEPA Credit Transfer](/docs/payment-processors/configuring-and-using-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


## 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 | - |