pain.008.001.08 Details
This page contains details of the direct debit initiation file:
| Tag Depth | XML Tag | Tag Name | Multiplicity | Format/Length | Usage |
|---|---|---|---|---|---|
| CstmrDrctDbtInitn | Customer Direct Debit Initiation | [1..1] | |||
| + | GrpHdr | Group Header | [1..1] | ||
| ++ | MsgId | MessageIdentification | [1..1] | Text/35 | Unique id of file, verified by TxB and provided in pain.002 |
| ++ | CreDtTm | CreationDateTime | [1..1] | ISODateTime | Date & time when message was created |
| ++ | Authstn | Authorisation | [0..1] | ||
| +++ | Cd | Code | [1..1] | Code | |
| +++ | Prtry | (Or) Proprietary | [1..1] | Text/28 | |
| ++ | NbOfTxs | NumberOfTransactions | [1..1] | Text/0-91,15 | Total number of transactions in the entire message |
| ++ | CtrlSum | Control Sum | [0..1] | DecimalNumber/ totalDigits: 18 fractionDigits: 17 | Total instructed amount within the entire message. It's validated when provided |
| ++ | InitgPty | InitiatingParty | [1..1] | ||
| +++ | Nm | Name | [0..1] | Text/140 | Legal name of initiating party. For SEPA payments, this field can only include up to 70 characters |
| +++ | Id | Identification | [0..1] | ||
| ++++ | OrgId | OrganisationIdentification | [0..1] | ||
| +++++ | Othr | Other | [0..*] | ||
| ++++++ | Id | Identification | [1..1] | Text/35 | Client ID issued by GS Bank |
| ++ | FwdgAgt | ForwardingAgent | [0..1] | ||
| +++ | FinInstnId | FinancialInstitutionIdentification | [1..1] | ||
| ++++ | BICFI | BICFI | [1..1] | SWIFT BIC/[A-Z0-9]4[A-Z]2[A-Z0-9]2([A-Z0-9]3)1 | BIC of the forwarding agent |
| + | PmtInf | Payment Information | [1..n] | Represents a batch of individual Direct Debit transactions. | |
| ++ | PmtInfId | PaymentInformationIdentification | [1..1] | Text/35 | Unique identification of the payment information block. |
| ++ | PmtMtd | PaymentMethod | [1..1] | Code/Populate DD | Mandatory to populate DD for Direct Debit |
| ++ | BtchBookg | BatchBooking | [0..1] | Indicator/(True/False) | Not used * All Domestic and Global Payment transactions are posted individually * All ACH payments are posted at a batch level |
| ++ | NbOfTxs | NumberOfTransactions | [0..1] | Text/0-91,15 | Total number of transactions within a Payment Information batch |
| ++ | CtrlSum | ControlSum | [0..1] | QuantityTotalDigits: 18 FractionDigits: 17 | Sum of instructed amount for transactions within the payment information batch |
| +++ | PmtTpInf | PaymentTypeInformation | [0..1] | ||
| ++++ | SvcLvl | ServiceLevel | [0..1] | ||
| +++++ | Cd | Code | [1..1] | Code | Use "SEPA" for SEPA Direct Debit |
| ++++ | LclInstrm | LocalInstrument | [0..1] | ||
| +++++ | Cd | Code | [1..1] | Code | Use "CORE" for SEPA Direct Debit |
| ++++ | SeqTp | SequenceType | [0..1] | Code | Allowed values, FRST - Initial collection of a recurring series. RCUR - Subsequent recurring collections. OOFF (One-off), FNAL (Final): The last collection in a series. |
| +++ | CtgyPurp | CategoryPurpose | [0..1] | Conditional based on country payment instrument. If CtgyPurp is used, one of Cd or Prtry must be used. | |
| ++++ | Cd | Code | [1..1] | Code/ExternalCategoryPurpose1Code | If Cd is populated, Prtry should not be populated. |
| ++++ | Prtry | (Or) Proprietary | [1..1] | Text/35 | If Prtry is populated, Cd should not be populated. |
| ++ | ReqdColltnDt | RequestedCollectionDate | [1..1] | Date YYYY-MM-DD | Date of collection of transaction. Must be a valid TARGET day and cannot be in the past. |
| ++ | Cdtr | Creditor | [1..1] | ||
| +++ | Nm | Name | [1..1] | Text/140 | Legal name of creditor. * For SEPA payments, this field is mandatory and can only include up to 70 characters |
| +++ | PstlAdr | PostalAddress | [0..1] | ||
| ++++ | Dept | Department | [0..1] | Text/70 | |
| ++++ | SubDept | SubDepartment | [0..1] | Text/70 | |
| ++++ | StrtNm | StreetName | [0..1] | Text/70 | |
| ++++ | BldgNb | BuildingNumber | [0..1] | Text/16 | |
| ++++ | PstCd | PostCode | [0..1] | Text/16 | |
| ++++ | TwnNm | TownName | [0..1] | Text/35 | |
| ++++ | CtrySubDvsn | CountrySubDivision | [0..1] | Text/35 | |
| ++++ | Ctry | Country | [1..1] | ISO 3166, Alpha-2 code/A-Z2,2 | For SEPA payments, this should be provided |
| ++++ | AdrLine | AddressLine | [0..1] | Text/70 | Up to 2 lines of Address are supported |
| +++ | Id | Identification | [0..1] | ||
| ++++ | OrgId | OrganisationIdentification | [0..1] | ||
| +++++ | Othr | Other | [0..1] | ||
| ++++++ | Id | Identification | [0..1] | Text/35 | |
| +++ | CtryOfRes | CountryOfResidence | [0..1] | ISO 3166, Alpha-2 code/[A-Z]2 | |
| +++ | CtctDtls | ContactDetails | [0..1] | ||
| ++++ | NmPrfx | NamePrefix | [0..1] | CodeSet | |
| ++++ | Nm | Name | [0..1] | Text/140 | |
| ++++ | PhneNb | PhoneNumber | [0..1] | Text +[0-9]3-[0-9()+-]30 | |
| ++++ | MobNb | MobileNumber | [0..1] | Text +[0-9]3-[0-9()+-]30 | |
| ++++ | FaxNb | FaxNumber | [0..1] | Text +[0-9]3-[0-9()+-]30 | |
| ++++ | EmailAdr | EmailAddress | [0..1] | Text/2048 | The @ symbol must be replaced with AT |
| ++ | CdtrAcct | CreditorAccount | [1..1] | ||
| +++ | Id | Identification | [1..1] | ||
| ++++ | IBAN | IBAN | [0..1] | International Bank Account Number (ISO 13616) | Enter IBAN of creditor account. * Mandatory for SEPA payments |
| ++++ | Othr | Other | [0..1] | ||
| +++++ | Id | Identification | [0..1] | Text/34 | |
| +++ | Ccy | Currency | [0..1] | Text/[A-Z]3 | Account currency. Use currency code as per ISO 4217 (e.g., EUR) |
| ++ | CdtrAgt | CreditorAgent | [1..1] | Financial institution servicing the creditor account. | |
| +++ | FinInstnId | FinancialInstitutionIdentification | [1..1] | ||
| ++++ | BICFI | BICFI | [0..1] | SWIFT BIC | * Mandatory for SEPA Payments |
| ++++ | ClrSysMmbId | ClearingSystemMemberIdentification | [0..1] | ||
| +++++ | ClrSysId | ClearingSystemIdentification | [0..1] | ||
| ++++++ | Cd | Code | [0..1] | Code | |
| ++++++ | Prtry | Proprietary | [0..1] | Text/35 | |
| +++++ | MmbId | MemberIdentification | [1..1] | Text/35 | |
| ++ | CdtrSchmeId | CreditorSchemeIdentification | [0..1] | Mandatory for SEPA Direct Debit | |
| +++ | Id | Identification | [1..1] | ||
| ++++ | PrvtId | PrivateIdentification | [1..1] | ||
| +++++ | Othr | Other | [1..1] | ||
| ++++++ | Id | Identification | [1..1] | Text/35 | Creditor Identifier) |
| ++++++ | SchmeNm | SchemeName | [0..1] | ||
| +++++++ | Prtry | Proprietary | [1..1] | Text/35 | e.g., SEPA |
| ++ | ChrgBr | ChargeBearer | [0..1] | Code/CRED, DEBT, SHAR, SLEV | Should be SLEV for SEPA |
| ++ | DrctDbtTxInf | DirectDebitTransactionInformation | [1..n] | There can be multiple instances of this depending upon number of collections to be processed. | |
| +++ | PmtId | PaymentIdentification | [1..1] | ||
| ++++ | InstrId | InstructionIdentification | [0..1] | Text/35 | If provided; needs to be unique to a payment information level. |
| ++++ | EndToEndId | EndToEndIdentification | [1..1] | Text/35 | This should be unique across files and should be used for reconciliation. |
| +++ | PmtTpInf | PaymentTypeInformation | [0..1] | ||
| ++++ | SvcLvl | ServiceLevel | [0..1] | ||
| +++++ | Cd | Code | [1..1] | Code | Use "SEPA" for SEPA Direct Debit |
| ++++ | LclInstrm | LocalInstrument | [0..1] | ||
| +++++ | Cd | Code | [1..1] | Code | Use "CORE" for SEPA Direct Debit |
| ++++ | SeqTp | SequenceType | [0..1] | Code | Allowed values, FRST - Initial collection of a recurring series. RCUR - Subsequent recurring collections. OOFF (One-off), FNAL (Final): The last collection in a series. |
| +++ | InstdAmt Ccy="AAA" | InstructedAmount | [1..1] | ISO 4217 for currency/minInclusive: 0 totalDigits: 18 fractionDigits: 5 | Amount to be collected. * For SEPA payments, Instructed amount is mandatory and should be EUR |
| +++ | ChrgBr | ChargeBearer | [0..1] | Code/CRED, DEBT, SHAR, SLEV | |
| +++ | DrctDbtTx | DirectDebitTransaction | [0..1] | ||
| ++++ | MndtRltdInf | MandateRelatedInformation | [0..1] | ||
| +++++ | MndtId | MandateIdentification | [1..1] | Text/35 | Unique identification of the mandate. * Mandatory for SEPA DD |
| +++++ | DtOfSgntr | DateOfSignature | [1..1] | ISODate | Date the mandate was signed. * Mandatory for SEPA DD |
| +++++ | AmdmntInd | AmendmentIndicator | [0..1] | Indicator/(True/False) | Indicates if the mandate has been amended |
| +++++ | AmdmntInfDtls | AmendmentInformationDetails | [0..1] | Required if AmdmntInd is true | |
| ++++++ | OrgnlMndtId | OriginalMandateIdentification | [0..1] | Text/35 | Mandate ID prior to the change |
| ++++++ | OrgnlCdtrSchmeId | OriginalCreditorSchemeIdentification | [0..1] | Creditor Scheme ID prior to the change | |
| +++++++ | Id | Identification | [1..1] | ||
| ++++++++ | PrvtId | PrivateIdentification | [1..1] | ||
| +++++++++ | Othr | Other | [1..1] | ||
| ++++++++++ | Id | Identification | [1..1] | Text/35 | Provide the original creditor scheme ID here |
| ++++++++++ | SchmeNm | SchemeName | [0..1] | ||
| +++++++++++ | Prtry | Proprietary | [1..1] | Text/35 | |
| ++++++ | OrgnlDbtrAcct | OriginalDebtorAccount | [0..1] | ||
| +++++++ | Id | Identification | [1..1] | ||
| ++++++++ | Othr | Other | [1..1] | ||
| +++++++++ | Id | Identification | [1..1] | Text/34 | |
| ++++ | CdtrSchmeId | CreditorSchemeIdentification | [0..1] | ||
| +++++ | Id | Identification | [1..1] | ||
| ++++++ | PrvtId | PrivateIdentification | [1..1] | ||
| +++++++ | Othr | Other | [1..1] | ||
| ++++++++ | Id | Identification | [1..1] | Text/35 | Provide the creditor scheme ID here |
| ++++++++ | SchmeNm | SchemeName | [0..1] | ||
| +++++++++ | Prtry | Proprietary | [1..1] | Text/35 | e.g. "SEPA" |
| +++ | DbtrAgt | DebtorAgent | [1..1] | Financial institution servicing the debtor account. | |
| ++++ | FinInstnId | FinancialInstitutionIdentification | [1..1] | ||
| +++++ | BICFI | BICFI | [0..1] | SWIFT BIC | * Mandatory for SEPA Payments |
| +++++ | Othr | Other | [0..1] | ||
| ++++++ | Id | Identification | [1..1] | Text/35 | |
| +++ | Dbtr | Debtor | [1..1] | ||
| ++++ | Nm | Name | [1..1] | Text/140 | Legal name of debtor. * For SEPA payments, this field is mandatory and can only include up to 70 characters |
| ++++ | PstlAdr | PostalAddress | [0..1] | ||
| +++++ | Dept | Department | [0..1] | Text/70 | |
| +++++ | SubDept | SubDepartment | [0..1] | Text/70 | |
| +++++ | StrtNm | StreetName | [0..1] | Text/70 | |
| +++++ | BldgNb | BuildingNumber | [0..1] | Text/16 | |
| +++++ | PstCd | PostCode | [0..1] | Text/16 | |
| +++++ | TwnNm | TownName | [0..1] | Text/35 | |
| +++++ | CtrySubDvsn | CountrySubDivision | [0..1] | Text/35 | |
| +++++ | Ctry | Country | [1..1] | ISO 3166, Alpha-2 code/A-Z2,2 | For SEPA payments, this should be provided |
| +++++ | AdrLine | AddressLine | [0..1] | Text/70 | Up to 2 lines of Address are supported |
| ++++ | Id | Identification | [0..1] | ||
| +++++ | OrgId | OrganisationIdentification | [0..1] | ||
| ++++++ | BICOrBEI | BICOrBEI | [0..1] | BICorBEI/[A-Z]6[A-Z2-9]A-NP-Z0-91 | |
| ++++++ | Othr | Other | [0..1] | ||
| +++++++ | Id | Identification | [0..1] | Text/35 | |
| +++++ | PrvtId | PrivateIdentification | [0..1] | ||
| ++++++ | DtAndPlcOfBirth | DateAndPlaceOfBirth | [0..1] | ||
| +++++++ | BirthDt | BirthDate | [0..1] | ISODate | |
| +++++++ | PrvcOfBirth | ProvinceOfBirth | [0..1] | Text/35 | |
| +++++++ | CityOfBirth | CityOfBirth | [0..1] | Text/35 | |
| +++++++ | CtryOfBirth | CountryOfBirth | [0..1] | ISO 3166, Alpha-2 code/[A-Z]2 | |
| ++++++ | Othr | Other | [0..1] | ||
| +++++++ | Id | Identification | [0..1] | Text/35 | |
| ++++ | CtryOfRes | CountryOfResidence | [0..1] | ISO 3166, Alpha-2 code/[A-Z]2 | |
| ++++ | CtctDtls | ContactDetails | [0..1] | ||
| +++++ | Nm | Name | [0..1] | Text/140 | |
| +++++ | PhneNb | PhoneNumber | [0..1] | PhoneNumber +[0-9]3-[0-9()+-]30 | |
| +++++ | MobNb | MobileNumber | [0..1] | PhoneNumber +[0-9]3-[0-9()+-]30 | |
| +++++ | EmailAdr | EmailAddress | [0..1] | Text/2048 | |
| +++ | DbtrAcct | DebtorAccount | [1..1] | ||
| ++++ | Id | Identification | [1..1] | ||
| +++++ | IBAN | IBAN | [0..1] | International Bank Account Number (ISO 13616) | Enter IBAN of debtor account. * Mandatory for SEPA payments |
| +++++ | Othr | Other | [0..1] | ||
| ++++++ | Id | Identification | [0..1] | Text/34 | |
| ++++ | Tp | Type | [0..1] | ||
| +++++ | Cd | Code | [0..1] | Code/CashAccountType4Code | |
| +++++ | Prtry | Proprietary | [0..1] | Text/35 | |
| ++++ | Ccy | Currency | [0..1] | ISO Currency/[A-Z]3 | |
| +++ | UltmtDbtr | UltimateDebtor | [0..1] | ||
| ++++ | Nm | Name | [1..1] | Text/140 | Legal name of client. For SEPA Direct Debit, this field can only include up to 70 characters |
| ++++ | PstlAdr | PostalAddress | [0..1] | ||
| +++++ | Ctry | Country | [1..1] | ISO 3166, Alpha-2 code/[A-Z]2 | Mandatory if ultimate debtor information is provided |
| ++++ | Id | Identification | [0..1] | ||
| +++ | Purp | Purpose | [0..1] | ||
| ++++ | Cd | Code | [0..1] | Code/ExternalPurpose1Code | |
| ++++ | Prtry | (Or) Proprietary | [0..1] | Text/35 | |
| +++ | Tax | Tax | [0..1] | ||
| ++++ | Cdtr | Creditor | [0..1] | ||
| +++++ | TaxId | TaxIdentification | [0..1] | Text/35 | |
| ++++ | Dbtr | Debtor | [0..1] | ||
| +++++ | TaxId | TaxIdentification | [0..1] | Text/35 | |
| +++ | RmtInf | RemittanceInformation | [0..1] | ||
| ++++ | Ustrd | Unstructured | [0..1] | Text /140 | Free format remittance information to be used for reference for payment. |
| ++++ | Strd | Structured | [0..1] | ||
| +++++ | CdtrRefInf | CreditorReferenceInformation | [0..1] | ||
| ++++++ | Tp | Type | [0..1] | ||
| +++++++ | CdOrPrtry | CodeOrProprietary | [1..1] | ||
| ++++++++ | Cd | Code | [0..1] | Code/DocumentType3Code | Use "SCOR" for SEPA Direct Debit |
| ++++++++ | Prtry | (Or) Proprietary | [0..1] | Text/35 | |
| +++++++ | Issr | Issuer | [0..1] | Text/35 | |
| ++++++ | Ref | Reference | [0..1] | Text/35 | Mandatory for SEPA Direct Debit if CdtrRefInf block is used |
Was this page useful?
Give feedback to help us improve developer.gs.com and serve you better.