What does it do
Using this call you will be able to check the following information
Senders and Receivers Name
The sender and receivers name meets the FATF requirements set out in the regulations and by your bank.
The minimum length of name is configurable in the self service hub.
The solution will also fail names that are not complete (have 2 names). Therefore if one section of the name is for example Mr then it will fail. These titles are not part of the name as recognised by FATF and are not considered during validation. The titles that are not allowed can be configured in the self service hub by an administrator.
Senders and Receivers Address
The address contains only characters that are ISO and SWIFT message compatible.
This call will replace any non-SWIFT/ISO compliant characters with compliant characters.
Method
POST command, in “application/json” format
The endpoint is
https://validate.bankersalmanac.com/validate-api/rest/convert/1.7
Request
The request parameters are
Field Name | Field Description | Sample Data | Size |
Dbtr_Nme | Debtor Name | Mr Barry Reves | 140 |
Dbtr_Addr | Debtor Address 1 | 1 Road Street | 35 |
Dbtr_Cty | Debtor City | London | 35 |
Dbtr_Ste | Debtor State | London | 35 |
Dbtr_Zip | Debtor Zip | EC1r 4RA | 16 |
Cdtr_Nme | Creditor Name | Mrs Sherry Smith | 140 |
Cdtr_Addr | Creditor Address 1 | 2 Road Street | 35 |
Cdtr_Cty | Creditor City | Paris | 35 |
Cdtr_Ste | Creditor State | Paris | 35 |
Cdtr_Zip | Creditor Zip | 23588 | 16 |
PmtInfId | Payment Reference | 20170823Ref | 35 |
extendedToken | The extended token retrieved from the authentication call |
Response
The request parameters are
Field Name | Field Description | Sample Data | Size |
Dbtr_Nme | Debtor Name | Mr Barry Reeves | 140 |
Dbtr_Addr | Debtor Address 1 | 1 Road Street | 35 |
Dbtr_Cty | Debtor City | London | 35 |
Dbtr_Ste | Debtor State | London | 35 |
Dbtr_Zip | Debtor Zip | EC1r 4RA | 16 |
Cdtr_Nme | Creditor Name | Mrs Sherry Smith | 140 |
Cdtr_Addr | Creditor Address 1 | 2 Road Street | 35 |
Cdtr_Cty | Creditor City | Paris | 35 |
Cdtr_Ste | Creditor State | Paris | 35 |
Cdtr_Zip | Creditor Zip | 23588 | 16 |
Rec_Dbtr_Nme | Recommended Debtor Name | Mr Barry Reeves | 140 |
Rec_Dbtr_Addr | Recommended Debtor Address 1 | 1 Road Street | 35 |
Rec_Dbtr_Cty | Recommended Debtor City | London | 35 |
Rec_Dbtr_Ste | Recommended Debtor State | London | 35 |
Rec_Dbtr_Zip | Recommended Debtor Zip | EC1r 4RA | 16 |
Dbtr_FATF_Stat | Debtor Status | PASS | 16 |
Dbtr_FATF_Com | Debtor Reason for Status | 70 | |
Rec_Cdtr_Nme | Recommended Creditor Name | Mrs Sherry Smith | 140 |
Rec_Cdtr_Addr | Recommended Creditor Address 1 | 2 Road Street | 35 |
Rec_Cdtr_Cty | Recommended Creditor City | Paris | 35 |
Rec_Cdtr_Ste | Recommended Creditor State | Paris | 35 |
Rec_Cdtr_Zip | Recommended Creditor Zip | 23588 | 16 |
Cdtr_FATF_Stat | Creditor Status | PASS | 16 |
Cdtr_FATF_Com | Creditor Reason for Status | 70 | |
PmtInfId | Payment Reference | 20170823Ref | 35 |
PmtInfId_Stat | Payment Reference Status | PASS | 16 |
PmtInfId_Com | Payment Reference Reason for Status | 70 |