wm.fin.sepa:getAvailablePaymentChannels
This service identifies the available payment channels for a BIC code, as follows:
1. Splits the BIC into a BIC code (the first 8 characters) and a branch code (characters 9 to 11). If the branch code is empty, substitutes it with XXX.
2. Searches the data file with the BIC code, branch code, service level (for example, SEPA), and scheme instrument.
3. If no record is found for a specific branch code, then repeats the search with XXX in the branch code.
4. The search may return multiple rows if the counterpart bank is reachable through multiple payment channels.
The
PaymentChannelID field in each retrieved record provides the list of possible payment channels.
The
ValidFrom and
ValidTo date fields may restrict the validity of the entries.
If no record is found, you must investigate manually to validate that the counterpart bank is ready to accept SEPA payment instructions, and determine the payment channels through which you can reach the bank.
Note:
If no available payment channels are found, the service returns the message: “No Available Payment Channel found.”
Input Parameters
bicCode | String BIC code of the financial institution. |
serviceLevel | String The SEPA service level. |
schemaIns | String The scheme instruments within the SEPA service level for which data is collected and published. |
Output Parameters
message | String Conditional. Indicates that there is no available payment channel. |
PaymentChannelInfo | Document List The available payment channel. |
PaymentChannelID | String The ID of the available payment channel. |
ValidFrom, ValidTo | String Show the validity of the available payment channel. |
errorMessage | String Specifies the error message, if an error occurs. |
error | String Specifies whether an error occurred. Valid values: yes and no. |