Dynamic payments

This functionality is currently available for the following providers:

B4B
Clear Junction
Currencycloud
Railsr
ClearBank
Unlimit

To use the Dynamic payments functionality, ensure that it is enabled in the system configuration. If you have any questions, please contact your client manager for further details.

The Dynamic payments feature allows users to initiate payments across different countries with forms that adapt dynamically based on the recipient’s country and payment type. This page provides a comprehensive overview of the fields required in the dynamic payment form for various payment methods, such as SEPA, FPS, CHAPS, and SWIFT. These fields vary according to the payment method and the recipient’s country, ensuring compliance with international standards and regulations. For more information on creating Dynamic payments in Web Interface, see the International and Dynamic International section.

Below are tables organized by payment method, detailing the fields used in the dynamic payment forms.

SEPA payments

Field name	Description	Type	Required	Max Length	Group	Validation pattern
`recipientName`	Recipient name	Text	Yes	35	recipient	[a-zA-Z0-9\\/\\-?:().,+ ]+$
`recipientIban`	IBAN	Text	Yes	40	recipient	^[A-Z0-9]+
`recipientSwift`	SWIFT/BIC	Text	Yes	11	recipient_bank	^[A-Z]{6}[2-9A-Z]{1}[0-9A-NP-Z]{1}((([0-9A-WY-Z]{1})([0-9A-Z]{2}))\|([X]{3})\|)+
`beneficiaryAddress`	Beneficiary address	Text	No	70	recipient	[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryCity`	Beneficiary city	Text	No	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryState`	Beneficiary state	Text	No	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryPostalCode`	Beneficiary postal code	Text	No	16	recipient	^\\d{4}$",//Denmark postal code
`beneficiaryCountryCode`	Beneficiary country	Select	No	N/A	recipient	N/A
`bankName`	Recipient's bank name	Text	No	140	recipient_bank	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`details`	Payment description	Text	Yes	140	None	^[a-zA-Z0-9\\/\\-?:().,+ ]+$

Local (FPS) payments

Field name	Description	Type	Required	Max Length	Group	Validation pattern
`amount`	Amount	Number	Yes	N/A	None	^\\d+(\\.\\d+)?$
`recipientName`	Recipient name	Text	Yes	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`recipientAccount`	Account number	Text	Yes	40	recipient	N/A
`recipientSortCode`	Sort code	Text	Yes	15	recipient	^\\d{6}$
`beneficiaryAddress`	Beneficiary address	Text	No	70	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryCity`	Beneficiary city	Text	No	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryPostalCode`	Beneficiary postal code	Text	No	16	recipient	^(([G][I][R] 0[A]{2})\|((([A-Z][0-9]{1,2})\|(([A-Z][A-HJ-Y][0-9]{1,2})\|(([A-Z][0-9][A-Z])\|([A-Z][A-HJ-Y][0-9]?[A-Z])))) [0-9][A-Z]{2}))$
`beneficiaryCountryCode`	Beneficiary country	Select	No	N/A	recipient	N/A
`bankName`	Recipient's bank name	Text	No	140	recipient_bank	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`details`	Payment description	Text	Yes	18	None	^[a-zA-Z0-9\\/\\-?:().,+ ]+$

Local (CHAPS) payments

Field name	Description	Type	Required	Max Length	Group	Validation pattern
`recipientName`	Recipient name	Text	Yes	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`recipientAccount`	Account number	Text	Yes	40	recipient	N/A
`recipientBankCode`	SWIFT/BIC	Text	Yes	11	recipient	^[A-Z]{6}[2-9A-Z]{1}[0-9A-NP-Z]{1}((([0-9A-WY-Z]{1})([0-9A-Z]{2}))\|([X]{3})\|)+
`recipientSortCode`	Sort code	Text	Yes	15	recipient	^\\d{6}$
`beneficiaryAddress`	Beneficiary address	Text	No	70	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryCity`	Beneficiary city	Text	No	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryPostalCode`	Beneficiary postal code	Text	No	16	recipient	^(([G][I][R] 0[A]{2})\|((([A-Z][0-9]{1,2})\|(([A-Z][A-HJ-Y][0-9]{1,2})\|(([A-Z][0-9][A-Z])\|([A-Z][A-HJ-Y][0-9]?[A-Z])))) [0-9][A-Z]{2}))$
`beneficiaryCountryCode`	Beneficiary country	Select	No	N/A	recipient	N/A
`bankName`	Recipient's bank name	Text	No	140	recipient_bank	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`details`	Payment description	Text	Yes	18	None	^[a-zA-Z0-9\\/\\-?:().,+ ]+$

SWIFT payments

Field name	Description	Type	Required	Max Length	Group	Validation pattern
`recipientName`	Recipient name	Text	Yes	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`recipientIban`	IBAN	Text	Yes	40	recipient	^[A-Z0-9]+
`recipientSwift`	SWIFT/BIC	Text	Yes	11	recipient_bank	^[A-Z]{6}[2-9A-Z]{1}[0-9A-NP-Z]{1}((([0-9A-WY-Z]{1})([0-9A-Z]{2}))\|([X]{3})\|)+
`beneficiaryAddress`	Beneficiary address	Text	Yes	70	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryCity`	Beneficiary city	Text	Yes	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryState`	Beneficiary state	Text	Yes	35	recipient	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`beneficiaryPostalCode`	Beneficiary postal code	Text	Yes	16	recipient	^\\d{5}$
`beneficiaryCountryCode`	Beneficiary country	Select	Yes	N/A	recipient	N/A
`bankName`	Recipient's bank name	Text	Yes	140	recipient_bank	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`bankAddress`	Recipient's bank address	Text	Yes	100	recipient_bank	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`bankCountryCode`	Recipient's bank country	Select	Yes	N/A	recipient_bank	N/A
`correspondentName`	Correspondent bank name	Text	No	128	correspondent_bank	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`correspondentAccount`	Correspondent account	Text	No	128	correspondent_bank	^[a-zA-Z0-9\\/\\-?:().,+ ]+$
`correspondentSwift`	Correspondent SWIFT/BIC	Text	No	N/A	correspondent_bank	N/A
`details`	Payment description	Text	Yes	140	None	^[a-zA-Z0-9\\/\\-?:().,+ ]+$