Payment+ » Documentations » Exceptions

Exceptions per Bank

Some banks have specific list of specs. You may check below if your bank do not conform to the general specs.

If your bank do not conform to the general specs and is not listed below, please contact us on support@treasuryxpress.com.

We are working hard to make this list updated.

  1. 1. ADIB AE
  2. 2. BNP AE
  3. 3. BNP BH
  4. 4. CITI GB
  5. 5. CITI AE
  6. 6. CITI KZ
  7. 7. CITI MA
  8. 8. CITI PK
  9. 9. HSBC AE
  10. 10. HSBC BH
  11. 11. HSBC EG
  12. 12. HSBC KW
  13. 13. HSBC LB
  14. 14. HSBC OM
  15. 15. HSBC QA
  16. 16. HSBC KSA
  17. 17. SCB OM
  18. 18. SCB AE
  19. 19. SCB BH
  20. 20. SCB IQ
  21. 21. SCB JO
  22. 22. SCB KA
  23. 23. SCB PK
  24. 24. SCB QA

ADIB AE back to top

ABDIAEAD

  • ADIB AE
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text 10 NO
RegulatoryReportingInfo Text 35 NO
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text
RegulatoryReportingInfo Text
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.

BNP AE back to top

  • BNP AE
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
InstructionPriority Code 4 NO Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. Values: HIGH: High NORM: Normal
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text 10 NO
RegulatoryReportingInfo Text 35 NO
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ExchangeRate Decimal 18 NO MAXimum of 6 integers and 6 decimals.
FxReference Text 35 NO Indicates reference to the foreign exchange contract agreed between ordering party and SCB.
RateType Code 4 NO SPOT
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
InstructionPriority Code Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. Values: HIGH: High NORM: Normal
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text
RegulatoryReportingInfo Text
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ExchangeRate Decimal MAXimum of 6 integers and 6 decimals.
FxReference Text Indicates reference to the foreign exchange contract agreed between ordering party and SCB.
RateType Code SPOT

BNP BH back to top

  • BNP BH
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
InstructionPriority Code 4 NO Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. Values: HIGH: High NORM: Normal
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text 10 NO
RegulatoryReportingInfo Text 35 NO
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ExchangeRate Decimal 18 NO MAXimum of 6 integers and 6 decimals.
FxReference Text 35 NO Indicates reference to the foreign exchange contract agreed between ordering party and SCB.
RateType Code 4 NO SPOT
ChequeMaturityDate Date 10 NO Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date 10 NO For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text 35 NO Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text 35 NO Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code 4 NO BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text 35 NO Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text 35 NO Specifies the print location of the cheque
ChequeRegionalClearingZone Text 35 NO Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text 35 NO Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text 140 NO
ChequeDeliverToAddressLine Text 140 NO
ChequeDeliverToAddressType Code 4 NO ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text 70 NO
ChequeDeliverToSubDepartment Text 70 NO
ChequeDeliverToStreetName Text 70 NO
ChequeDeliverToBuildingNumber Text 16 NO
ChequeDeliverToPostCode Text 16 NO
ChequeDeliverToTownName Text 35 NO
ChequeDeliverToCountry Code 2 NO
ChequeDeliverToCountrySubDivision Text 35 NO identifies a subdivision of as country ,eg, state, region, county
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
InstructionPriority Code Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. Values: HIGH: High NORM: Normal
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text
RegulatoryReportingInfo Text
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ExchangeRate Decimal MAXimum of 6 integers and 6 decimals.
FxReference Text Indicates reference to the foreign exchange contract agreed between ordering party and SCB.
RateType Code SPOT
ChequeMaturityDate Date Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text Specifies the print location of the cheque
ChequeRegionalClearingZone Text Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text
ChequeDeliverToAddressLine Text
ChequeDeliverToAddressType Code ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text
ChequeDeliverToSubDepartment Text
ChequeDeliverToStreetName Text
ChequeDeliverToBuildingNumber Text
ChequeDeliverToPostCode Text
ChequeDeliverToTownName Text
ChequeDeliverToCountry Code
ChequeDeliverToCountrySubDivision Text identifies a subdivision of as country ,eg, state, region, county

CITI GB back to top

  • CITI GB
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.

CITI AE back to top

  • CITI AE
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorPhoneNumber Text 35 NO
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAgentBranchIdentification Text 35 NO
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
RegulatoryReportingCode Text 10 NO
RegulatoryReportingInfo Text 35 NO
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorPhoneNumber Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAgentBranchIdentification Text
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
RegulatoryReportingCode Text
RegulatoryReportingInfo Text
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.

CITI KZ back to top

  • CITI KZ
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
PIUID NO
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorEmployeeNumber Text 35 NO Beneficiary Number
CreditorIINBIN Text 35 NO issuer identification number (IIN), or bank identification number (BIN)
CreditorFirstName Text 35 NO
CreditorLastName Text 35 NO
CreditorPatronymic Text 35 NO
CreditorDateOfBirth Date 10 NO
CreditorPhoneNumber Text 35 NO
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAgentBranchIdentification Text 35 NO
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text 10 NO
RegulatoryReportingInfo Text 35 NO
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
BudgetCode Text 35 NO
DocumentDate Date 10 NO
DocumentNumber Text 35 NO Part of structured Remittance info Unique and unambiguous identification number of the referred document.
DuePayableAmount Decimal 18 NO Part of structured Remittance info Amount specified is the exact amount due and payable to the creditor.
DiscountAppliedAmount Decimal 18 NO Part of structured Remittance info Amount of money resulting from the application of an agreed discount to the amount due and payable to the creditor.
CreditNoteAmount Decimal 18 NO Part of structured Remittance info Amount specified for the referred document is the amount of a credit note.
RemittedAmount Decimal 18 NO Part of structured Remittance info Amount of money remitted for the referred document
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date 10 NO Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date 10 NO For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text 35 NO Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text 35 NO Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code 4 NO BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text 35 NO Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text 35 NO Specifies the print location of the cheque
ChequeRegionalClearingZone Text 35 NO Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text 35 NO Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text 140 NO
ChequeDeliverToAddressLine Text 140 NO
CreditorTaxCode Text 35 NO
TaxAmount Decimal 18 NO Part of structured Remittance info Quantity of cash resulting from the calculation of the tax.
TransactionType Text 35 NO Transaction Type: Salary Pension Social Free Disbursement
BasicSalary Decimal 18 NO Beneficiary Basic Salary
HousingAllowance Decimal 18 NO Housing Allowance
SocialAllowance Decimal 18 NO Social Allowance
ChildAllowance Decimal 18 NO Child Allowance
CostofLivingAllowance Decimal 18 NO Cost of Living Allowance
OvertimeAllowance Decimal 18 NO Overtime Allowance
TransportAllowance Decimal 18 NO Transport Allowance
OtherAllowance Decimal 18 NO Other Allowance
Deductions Decimal 18 NO Deduction
VoCode Text 35 NO
PublicOrPrivatePension Text 35 NO Type Of Pension: Public or Private
PensionDate Date 10 NO Pension Date
EmployeeContribution Decimal 35 NO Employee Contribution
EmployerContribution Decimal 35 NO Employer Contribution
NewBasicSalaryEffectiveDate Date 10 NO New Basic Salary Effective Date
NewChildAllowanceEffectiveDate Date 10 NO New Child Allowance Effective Date
NewCostofLivingAllowanceEffectiveDate Date 10 NO New Cost of Living Allowance Effective Date
NewHousingAllowanceEffectiveDate Date 10 NO New Housing Allowance Effective Date
NewOtherAllowancesEffectiveDate Date 10 NO New Other Allowances Effective Date
NewSocialAllowanceEffectiveDate Date 10 NO New Social Allowance Effective Date
SickLeaveHalfPayStartDate Date 10 NO Sick Leave Half Pay Start Date
SickLeaveHalfPayDays Int 10 NO Sick Leave Half Pay Days
SickLeaveHalfPayDays Int 10 NO Sick Leave Zero Pay Start Date
SickLeaveZeroPayDays Int 10 NO Sick Leave Zero Pay Days
UnpaidLeaveLongTermStartDate Date 10 NO Unpaid Leave Long Term Start Date
UnpaidLeaveLongTermDays Int 10 NO Unpaid Leave Long Term Days
UnpaidStudyLeaveStartDate Date 10 NO Unpaid Study Leave Start Date
UnpaidStudyLeaveDays Int 10 NO Unpaid Study Leave Days
UnauthorizedLeaveStartDate Date 10 NO Unauthorized Leave Start Date
UnauthorizedLeaveDays Int 10 NO Unauthorized Leave Days
UnpaidLeaveShortTermStartDate Date 10 NO Unpaid Leave Short Term Start Date
UnpaidLeaveShortTermDays Int 10 NO Unpaid Leave Short Term Days
UnpaidLeavePayment Decimal 18 NO Unpaid Leave Payment
PayrollAccount Text 35 NO Payroll Account for combining multi transactions
PayrollIINBIN Text 35 NO For Payroll Account
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
PIUID
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorEmployeeNumber Text Beneficiary Number
CreditorIINBIN Text issuer identification number (IIN), or bank identification number (BIN)
CreditorFirstName Text
CreditorLastName Text
CreditorPatronymic Text
CreditorDateOfBirth Date
CreditorPhoneNumber Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAgentBranchIdentification Text
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text
RegulatoryReportingInfo Text
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
BudgetCode Text
DocumentDate Date
DocumentNumber Text Part of structured Remittance info Unique and unambiguous identification number of the referred document.
DuePayableAmount Decimal Part of structured Remittance info Amount specified is the exact amount due and payable to the creditor.
DiscountAppliedAmount Decimal Part of structured Remittance info Amount of money resulting from the application of an agreed discount to the amount due and payable to the creditor.
CreditNoteAmount Decimal Part of structured Remittance info Amount specified for the referred document is the amount of a credit note.
RemittedAmount Decimal Part of structured Remittance info Amount of money remitted for the referred document
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text Specifies the print location of the cheque
ChequeRegionalClearingZone Text Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text
ChequeDeliverToAddressLine Text
CreditorTaxCode Text
TaxAmount Decimal Part of structured Remittance info Quantity of cash resulting from the calculation of the tax.
TransactionType Text Transaction Type: Salary Pension Social Free Disbursement
BasicSalary Decimal Beneficiary Basic Salary
HousingAllowance Decimal Housing Allowance
SocialAllowance Decimal Social Allowance
ChildAllowance Decimal Child Allowance
CostofLivingAllowance Decimal Cost of Living Allowance
OvertimeAllowance Decimal Overtime Allowance
TransportAllowance Decimal Transport Allowance
OtherAllowance Decimal Other Allowance
Deductions Decimal Deduction
VoCode Text
PublicOrPrivatePension Text Type Of Pension: Public or Private
PensionDate Date Pension Date
EmployeeContribution Decimal Employee Contribution
EmployerContribution Decimal Employer Contribution
NewBasicSalaryEffectiveDate Date New Basic Salary Effective Date
NewChildAllowanceEffectiveDate Date New Child Allowance Effective Date
NewCostofLivingAllowanceEffectiveDate Date New Cost of Living Allowance Effective Date
NewHousingAllowanceEffectiveDate Date New Housing Allowance Effective Date
NewOtherAllowancesEffectiveDate Date New Other Allowances Effective Date
NewSocialAllowanceEffectiveDate Date New Social Allowance Effective Date
SickLeaveHalfPayStartDate Date Sick Leave Half Pay Start Date
SickLeaveHalfPayDays Int Sick Leave Half Pay Days
SickLeaveHalfPayDays Int Sick Leave Zero Pay Start Date
SickLeaveZeroPayDays Int Sick Leave Zero Pay Days
UnpaidLeaveLongTermStartDate Date Unpaid Leave Long Term Start Date
UnpaidLeaveLongTermDays Int Unpaid Leave Long Term Days
UnpaidStudyLeaveStartDate Date Unpaid Study Leave Start Date
UnpaidStudyLeaveDays Int Unpaid Study Leave Days
UnauthorizedLeaveStartDate Date Unauthorized Leave Start Date
UnauthorizedLeaveDays Int Unauthorized Leave Days
UnpaidLeaveShortTermStartDate Date Unpaid Leave Short Term Start Date
UnpaidLeaveShortTermDays Int Unpaid Leave Short Term Days
UnpaidLeavePayment Decimal Unpaid Leave Payment
PayrollAccount Text Payroll Account for combining multi transactions
PayrollIINBIN Text For Payroll Account

CITI MA back to top

  • CITI MA
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorPhoneNumber Text 35 NO
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorPhoneNumber Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.

CITI PK back to top

  • CITI PK
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text 35 NO
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAgentBranchIdentification Text 35 NO
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
BudgetCode Text 35 NO
DocumentDate Date 10 NO
DocumentNumber Text 35 NO Part of structured Remittance info Unique and unambiguous identification number of the referred document.
DuePayableAmount Decimal 18 NO Part of structured Remittance info Amount specified is the exact amount due and payable to the creditor.
DiscountAppliedAmount Decimal 18 NO Part of structured Remittance info Amount of money resulting from the application of an agreed discount to the amount due and payable to the creditor.
CreditNoteAmount Decimal 18 NO Part of structured Remittance info Amount specified for the referred document is the amount of a credit note.
RemittedAmount Decimal 18 NO Part of structured Remittance info Amount of money remitted for the referred document
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date 10 NO Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date 10 NO For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text 35 NO Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text 35 NO Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code 4 NO BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text 35 NO Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text 35 NO Specifies the print location of the cheque
ChequeRegionalClearingZone Text 35 NO Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text 35 NO Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text 140 NO
ChequeDeliverToAddressLine Text 140 NO
CreditorTaxCode Text 35 NO
TaxAmount Decimal 18 NO Part of structured Remittance info Quantity of cash resulting from the calculation of the tax.
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorTownName Text
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAgentBranchIdentification Text
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
BudgetCode Text
DocumentDate Date
DocumentNumber Text Part of structured Remittance info Unique and unambiguous identification number of the referred document.
DuePayableAmount Decimal Part of structured Remittance info Amount specified is the exact amount due and payable to the creditor.
DiscountAppliedAmount Decimal Part of structured Remittance info Amount of money resulting from the application of an agreed discount to the amount due and payable to the creditor.
CreditNoteAmount Decimal Part of structured Remittance info Amount specified for the referred document is the amount of a credit note.
RemittedAmount Decimal Part of structured Remittance info Amount of money remitted for the referred document
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text Specifies the print location of the cheque
ChequeRegionalClearingZone Text Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text
ChequeDeliverToAddressLine Text
CreditorTaxCode Text
TaxAmount Decimal Part of structured Remittance info Quantity of cash resulting from the calculation of the tax.

HSBC AE back to top

  • HSBC AE
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
EmployerID Text 35 NO Ordering Customer ID
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
InstructionPriority Code 4 NO Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. Values: HIGH: High NORM: Normal
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text 10 NO
RegulatoryReportingInfo Text 35 NO
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date 10 NO Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date 10 NO For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text 35 NO Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text 35 NO Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code 4 NO BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text 35 NO Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text 35 NO Specifies the print location of the cheque
ChequeRegionalClearingZone Text 35 NO Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text 35 NO Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text 140 NO
ChequeDeliverToAddressLine Text 140 NO
ChequeDeliverToAddressType Code 4 NO ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text 70 NO
ChequeDeliverToSubDepartment Text 70 NO
ChequeDeliverToStreetName Text 70 NO
ChequeDeliverToBuildingNumber Text 16 NO
ChequeDeliverToPostCode Text 16 NO
ChequeDeliverToTownName Text 35 NO
ChequeDeliverToCountry Code 2 NO
ChequeDeliverToCountrySubDivision Text 35 NO identifies a subdivision of as country ,eg, state, region, county
TransactionType Text 35 NO Transaction Type: Salary Pension Social Free Disbursement
BasicSalary Decimal 18 NO Beneficiary Basic Salary
HousingAllowance Decimal 18 NO Housing Allowance
SocialAllowance Decimal 18 NO Social Allowance
ChildAllowance Decimal 18 NO Child Allowance
CostofLivingAllowance Decimal 18 NO Cost of Living Allowance
OvertimeAllowance Decimal 18 NO Overtime Allowance
TransportAllowance Decimal 18 NO Transport Allowance
OtherAllowance Decimal 18 NO Other Allowance
Deductions Decimal 18 NO Deduction
VoCode Text 35 NO
PublicOrPrivatePension Text 35 NO Type Of Pension: Public or Private
PensionDate Date 10 NO Pension Date
EmployeeContribution Decimal 35 NO Employee Contribution
EmployerContribution Decimal 35 NO Employer Contribution
NewBasicSalaryEffectiveDate Date 10 NO New Basic Salary Effective Date
NewChildAllowanceEffectiveDate Date 10 NO New Child Allowance Effective Date
NewCostofLivingAllowanceEffectiveDate Date 10 NO New Cost of Living Allowance Effective Date
NewHousingAllowanceEffectiveDate Date 10 NO New Housing Allowance Effective Date
NewOtherAllowancesEffectiveDate Date 10 NO New Other Allowances Effective Date
NewSocialAllowanceEffectiveDate Date 10 NO New Social Allowance Effective Date
SickLeaveHalfPayStartDate Date 10 NO Sick Leave Half Pay Start Date
SickLeaveHalfPayDays Int 10 NO Sick Leave Half Pay Days
SickLeaveHalfPayDays Int 10 NO Sick Leave Zero Pay Start Date
SickLeaveZeroPayDays Int 10 NO Sick Leave Zero Pay Days
UnpaidLeaveLongTermStartDate Date 10 NO Unpaid Leave Long Term Start Date
UnpaidLeaveLongTermDays Int 10 NO Unpaid Leave Long Term Days
UnpaidStudyLeaveStartDate Date 10 NO Unpaid Study Leave Start Date
UnpaidStudyLeaveDays Int 10 NO Unpaid Study Leave Days
UnauthorizedLeaveStartDate Date 10 NO Unauthorized Leave Start Date
UnauthorizedLeaveDays Int 10 NO Unauthorized Leave Days
UnpaidLeaveShortTermStartDate Date 10 NO Unpaid Leave Short Term Start Date
UnpaidLeaveShortTermDays Int 10 NO Unpaid Leave Short Term Days
UnpaidLeavePayment Decimal 18 NO Unpaid Leave Payment
PayrollAccount Text 35 NO Payroll Account for combining multi transactions
PayrollIINBIN Text 35 NO For Payroll Account
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
EmployerID Text Ordering Customer ID
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
InstructionPriority Code Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. Values: HIGH: High NORM: Normal
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RegulatoryReportingCode Text
RegulatoryReportingInfo Text
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text Specifies the print location of the cheque
ChequeRegionalClearingZone Text Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text
ChequeDeliverToAddressLine Text
ChequeDeliverToAddressType Code ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text
ChequeDeliverToSubDepartment Text
ChequeDeliverToStreetName Text
ChequeDeliverToBuildingNumber Text
ChequeDeliverToPostCode Text
ChequeDeliverToTownName Text
ChequeDeliverToCountry Code
ChequeDeliverToCountrySubDivision Text identifies a subdivision of as country ,eg, state, region, county
TransactionType Text Transaction Type: Salary Pension Social Free Disbursement
BasicSalary Decimal Beneficiary Basic Salary
HousingAllowance Decimal Housing Allowance
SocialAllowance Decimal Social Allowance
ChildAllowance Decimal Child Allowance
CostofLivingAllowance Decimal Cost of Living Allowance
OvertimeAllowance Decimal Overtime Allowance
TransportAllowance Decimal Transport Allowance
OtherAllowance Decimal Other Allowance
Deductions Decimal Deduction
VoCode Text
PublicOrPrivatePension Text Type Of Pension: Public or Private
PensionDate Date Pension Date
EmployeeContribution Decimal Employee Contribution
EmployerContribution Decimal Employer Contribution
NewBasicSalaryEffectiveDate Date New Basic Salary Effective Date
NewChildAllowanceEffectiveDate Date New Child Allowance Effective Date
NewCostofLivingAllowanceEffectiveDate Date New Cost of Living Allowance Effective Date
NewHousingAllowanceEffectiveDate Date New Housing Allowance Effective Date
NewOtherAllowancesEffectiveDate Date New Other Allowances Effective Date
NewSocialAllowanceEffectiveDate Date New Social Allowance Effective Date
SickLeaveHalfPayStartDate Date Sick Leave Half Pay Start Date
SickLeaveHalfPayDays Int Sick Leave Half Pay Days
SickLeaveHalfPayDays Int Sick Leave Zero Pay Start Date
SickLeaveZeroPayDays Int Sick Leave Zero Pay Days
UnpaidLeaveLongTermStartDate Date Unpaid Leave Long Term Start Date
UnpaidLeaveLongTermDays Int Unpaid Leave Long Term Days
UnpaidStudyLeaveStartDate Date Unpaid Study Leave Start Date
UnpaidStudyLeaveDays Int Unpaid Study Leave Days
UnauthorizedLeaveStartDate Date Unauthorized Leave Start Date
UnauthorizedLeaveDays Int Unauthorized Leave Days
UnpaidLeaveShortTermStartDate Date Unpaid Leave Short Term Start Date
UnpaidLeaveShortTermDays Int Unpaid Leave Short Term Days
UnpaidLeavePayment Decimal Unpaid Leave Payment
PayrollAccount Text Payroll Account for combining multi transactions
PayrollIINBIN Text For Payroll Account

HSBC BH back to top

  • HSBC BH
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date 10 NO Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date 10 NO For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text 35 NO Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text 35 NO Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code 4 NO BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text 35 NO Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text 35 NO Specifies the print location of the cheque
ChequeRegionalClearingZone Text 35 NO Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text 35 NO Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text 140 NO
ChequeDeliverToAddressLine Text 140 NO
ChequeDeliverToAddressType Code 4 NO ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text 70 NO
ChequeDeliverToSubDepartment Text 70 NO
ChequeDeliverToStreetName Text 70 NO
ChequeDeliverToBuildingNumber Text 16 NO
ChequeDeliverToPostCode Text 16 NO
ChequeDeliverToTownName Text 35 NO
ChequeDeliverToCountry Code 2 NO
ChequeDeliverToCountrySubDivision Text 35 NO identifies a subdivision of as country ,eg, state, region, county
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text Specifies the print location of the cheque
ChequeRegionalClearingZone Text Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text
ChequeDeliverToAddressLine Text
ChequeDeliverToAddressType Code ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text
ChequeDeliverToSubDepartment Text
ChequeDeliverToStreetName Text
ChequeDeliverToBuildingNumber Text
ChequeDeliverToPostCode Text
ChequeDeliverToTownName Text
ChequeDeliverToCountry Code
ChequeDeliverToCountrySubDivision Text identifies a subdivision of as country ,eg, state, region, county

HSBC EG back to top

  • HSBC EG
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date 10 NO Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date 10 NO For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text 35 NO Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text 35 NO Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code 4 NO BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text 35 NO Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text 35 NO Specifies the print location of the cheque
ChequeRegionalClearingZone Text 35 NO Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text 35 NO Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text 140 NO
ChequeDeliverToAddressLine Text 140 NO
ChequeDeliverToAddressType Code 4 NO ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text 70 NO
ChequeDeliverToSubDepartment Text 70 NO
ChequeDeliverToStreetName Text 70 NO
ChequeDeliverToBuildingNumber Text 16 NO
ChequeDeliverToPostCode Text 16 NO
ChequeDeliverToTownName Text 35 NO
ChequeDeliverToCountry Code 2 NO
ChequeDeliverToCountrySubDivision Text 35 NO identifies a subdivision of as country ,eg, state, region, county
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text Specifies the print location of the cheque
ChequeRegionalClearingZone Text Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text
ChequeDeliverToAddressLine Text
ChequeDeliverToAddressType Code ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text
ChequeDeliverToSubDepartment Text
ChequeDeliverToStreetName Text
ChequeDeliverToBuildingNumber Text
ChequeDeliverToPostCode Text
ChequeDeliverToTownName Text
ChequeDeliverToCountry Code
ChequeDeliverToCountrySubDivision Text identifies a subdivision of as country ,eg, state, region, county

HSBC KW back to top

  • HSBC KW
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MosalID Text 35 NO Ministry of Labour
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided
TransactionAmount Decimal 18 YES Positive, decimal.
TransactionCurrency Code 3 YES Must conform to ISO 4217 Currency
InstructionIdentification Text 35 YES Transaction Unique Reference
InstructionForCreditorAgent Text 140 NO information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text 140 NO information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RemittanceInformation Text 140 NO The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text 2540 NO Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date 10 NO Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date 10 NO For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text 35 NO Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text 35 NO Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code 4 NO BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text 35 NO Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text 35 NO Specifies the print location of the cheque
ChequeRegionalClearingZone Text 35 NO Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text 35 NO Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text 140 NO
ChequeDeliverToAddressLine Text 140 NO
ChequeDeliverToAddressType Code 4 NO ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text 70 NO
ChequeDeliverToSubDepartment Text 70 NO
ChequeDeliverToStreetName Text 70 NO
ChequeDeliverToBuildingNumber Text 16 NO
ChequeDeliverToPostCode Text 16 NO
ChequeDeliverToTownName Text 35 NO
ChequeDeliverToCountry Code 2 NO
ChequeDeliverToCountrySubDivision Text 35 NO identifies a subdivision of as country ,eg, state, region, county
InitiatingPartyName Text
InitiatingPartyCountry Code
InitiatingPartyAddressLine Text
InitiatingPartyIdentification * Text
DebtorName Text
DebtorCountry Code
DebtorAddressLine Text
DebtorAgentName Text
DebtorAgentBIC * Text
DebtorAgentCountry Code
DebtorAgentAddressLine Text
DebtorAccountLocalAccount * Text Debtor Local Account
DebtorAccountIBAN * Text Debtor IBAN Account
DebtorAccountCurrency * Code
MosalID Text Ministry of Labour
MessageIdentification * Text Unique Id for the payment
RequestedExecutionDate * Date Date format is YYYY-MM-DD
CategoryPurpose * Text SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer * Code CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod * Code TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel * Text BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text Beneficiary Identifier at ERP
CreditorName * Text
CreditorAddressLine Text
CreditorCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text The beneficiary Bank Name
CreditorAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text Bank Address
CreditorAgentBIC * Text BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode * Text
CreditorAgentOtherCode * Text The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN * Text
CreditorAccountLocalAccount * Text The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text In case intermediary bank is used, the bank address must be provided
TransactionAmount * Decimal Positive, decimal.
TransactionCurrency * Code Must conform to ISO 4217 Currency
InstructionIdentification * Text Transaction Unique Reference
InstructionForCreditorAgent Text information complementing the coded instruction or instruction to the creditor`s agent that is bilaterally agreed or specific to a user community. To use code words not supported by ISOXML but supported by the branch.
InstructionForDebtorAgent Text information related to the processing of the payment instruction that may need to be acted upon by the Debtoragent, depending on agreement between Debtorand the Debtoragent.
RemittanceInformation Text The invoice number or any kind of description to be sent with the payment. It is very important to enter this information from the ERP to facilitate in reconciliation afterwards
EmailAddress Text Emails to which an agent is to send the remittance information. Semicolon (;) sperated.
ChequeMaturityDate Date Date when the draft becomes payable and the Debtoraccount is debited
ChequePostDate Date For Post Dated Cheque (YYYY-MM-DD)
ChequeMemoField Text Information that needs to be printed on a cheque used by the payer to add misc info.
ChequeDeliveryMethod Text Valid values are: CRCD - CourierToCreditor CRDB - CourierToDebtor CRFA - CourierToFinalAgent MLCD - MailToCreditor MLDB - MailToDebtor MLFA - MailToFinalAgent PUCD -PickUpByCreditor PUDB - PickUpByDebtor PUFA- PickUpByFinalAgent RGCD- RegisteredMailToCreditor RGDB- RegisteredMailToDebtor RGFA- RegisteredMailToFinalAgent
ChequeType Code BCHQ/CCCH/CCHQ/DRFT/ELDR
ChequeNumber Text Unique and unambiguous identifier for a cheque as assigned by the agent.
ChequePrintLocation Text Specifies the print location of the cheque
ChequeRegionalClearingZone Text Regional Area in which the cheque can be cleared when a country has no nation wide cheque clearing organization
ChequeFormsCode Text Code agreed between initiating party and the debtors agent, that specified the cheque layout, company logo and digitized signature to be used to print the cheque
ChequeDeliverToName Text
ChequeDeliverToAddressLine Text
ChequeDeliverToAddressType Code ADDR -Address is the complete postal address. BIZZ -Address is the business address. DLVY - Address is the address to which delivery is to take place. HOME-Address is the home address. MLTO-Address is the address to which mail is sent. PBOX-Address is a postal office (PO) box.
ChequeDeliverToDepartment Text
ChequeDeliverToSubDepartment Text
ChequeDeliverToStreetName Text
ChequeDeliverToBuildingNumber Text
ChequeDeliverToPostCode Text
ChequeDeliverToTownName Text
ChequeDeliverToCountry Code
ChequeDeliverToCountrySubDivision Text identifies a subdivision of as country ,eg, state, region, county

HSBC LB back to top

  • HSBC LB
/payments/create
Create an ISO2002 payment file
Param Type Max Size Required
InitiatingPartyName Text 140 NO
InitiatingPartyCountry Code 2 NO
InitiatingPartyAddressLine Text 140 NO
InitiatingPartyIdentification Text 35 YES
DebtorName Text 140 NO
DebtorCountry Code 2 NO
DebtorAddressLine Text 140 NO
DebtorAgentName Text 140 NO
DebtorAgentBIC Text 11 YES
DebtorAgentCountry Code 2 NO
DebtorAgentAddressLine Text 140 NO
DebtorAccountLocalAccount Text 34 (YES or Debtor Local Account
DebtorAccountIBAN Text 34 YES) Debtor IBAN Account
DebtorAccountCurrency Code 3 YES
MessageIdentification Text 35 YES Unique Id for the payment
RequestedExecutionDate Date 10 YES Date format is YYYY-MM-DD
CategoryPurpose Text 11 YES SALDOM for Domestic Salaries SALINT for International Salaries SUPDOM for Domestic Supplier Payments SUPINT for International Supplier Payments TREASURYDOM for Domestic Treasury transfer TREASURYINT for International Treasury Transfer
ChargeBearer Code 4 YES CRED All transaction charges are to be borne by the creditor. DEBT All transaction charges are to be borne by the debtor. SHAR Both parties bear their own charges. SLEV Both parties bear their own charges.
PaymentMethod Code 3 YES TRF: Transfer Advice CHK: Check TRA: Credit Transfer
ServiceLevel Text 35 YES BKTR: Book Transaction NUGP: Non-urgent Priority Payment NURG: Non-urgent Payment PRPT: EBAPriorityService SDVA: SameDayValue SEPA: SingleEuroPaymentsArea URGP: Urgent Payment URNS: Urgent Payment Net Settlement
LocalInstrument Text 35 NO This element is used to specify a local instrument, local clearing option and/or further qualify the service or service level.
CreditorIdentification Text 35 NO Beneficiary Identifier at ERP
CreditorName Text 140 YES
CreditorAddressLine Text 140 NO
CreditorCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentName Text 140 NO The beneficiary Bank Name
CreditorAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
CreditorAgentAddressLine Text 140 NO Bank Address
CreditorAgentBIC Text 11 (YES or BIC for IBAN, SORTCode, Fedwire, Other,CSMI
CreditorAgentCSMICode Text 35 YES or
CreditorAgentOtherCode Text 35 YES) The beneficiary Bank Code. Incorrect bank code will result in rejection at the payment processing side.
CreditorAccountIBAN Text 34 (YES or
CreditorAccountLocalAccount Text 34 YES) The beneficiary account number (IBAN or Other)
CreditorAccountCurrency Code 3 NO Must Conform to ISO 4217 Currency http://en.wikipedia.org/wiki/ISO_4217
IntermediaryAgentName Text 140 NO In case intermediary bank is used, all intermediary bank fields must be filled
IntermediaryAgentCountry Code 2 NO Must Conform to ISO 3166 Alpha 2 http://en.wikipedia.org/wiki/ISO_3166-1
IntermediaryAgentBIC Text 11 NO In case intermediary bank is used, the BIC must be provided
IntermediaryAgentAddressLine Text 140 NO In case intermediary bank is used, the bank address must be provided