All Sender and Recievers Correspondents

This call is designed to return the correspondent bank details required to make a payment for the payment details entered. This call does not return any details on the branch itself.  The call will validate the clients account number and bank code data and respond with only the correspondent details for the currency that the user entered.  The search criteria as below and also require the user to enter a valid ISO currency code.

  1. BIC
  2. National id
  3. BIC and domestic account number
  4. National id and domestic account number
  5. Structured account number (BBAN, IBAN or CLABE).

The service returns the correspondnet details for both the sending and recieivng bank and the address of each of the correspondents for the reciever.

METHOD

GET command, in “application/json” format

https://apps.applyfinancial.co.uk/validate-api/rest/convert/2.3

REQUEST

The request parameters can be seen below

Field name Field description Mandatory or Optional Sample data
originCountryCode Originator ISO 2 digit country code M TR
originBIC BIC of the originator M AKBKTRISXXX
originAcct Account number of the originator O
currencyCode ISO 3 digit currency code M JPY
assetCategory Cateogry of the payment type O COPA
countryCode Beneficiary ISO 2 digit country code M US
nationalId National id or BIC of the beneficiary M SMBCUS33
benAcct Account number of the beneficiary O
ref Your refernce number O
errorComment No in use O
token Security token M

RESPONSE

Field Name Field Description Sample
    currencyCode ISO 3 digit currency code  “JPY”,
    originator Label – Originator Bank Details  {
        nm Bank Name  “AKBANK T.A.S.”,
        pstlAdr Postal address  “SABANCI CENTER LEVENT 4, ISTANBUL, 34330, TURKEY”,
        bic Banks BIC  “AKBKTRISXXX”,
        acct Account number  “”,
        codeDetails  {
            codeName1 Code value 1 name  “BIC”,
            codeValue1 Code value 1  “AKBKTRISXXX”,
            codeName2 Code value 2 name  “CHIPS”,
            codeValue2 Code value 2  “095893”,
            codeName3 Code value 3 name  “BIC-4”,
            codeValue3 Code value 3  “AKBK”,
            codeName4 Code value 4 name  “Banka Kodu”,
            codeValue4 Code value 4  “004699999”
        },
ssiDetails LABEL
        assetCategory Asset type of correspondent bank account  “ALL”,
        corresBIC Originator correspondent BIC  “SMBCJPJTXXX”,
        corresAcct Originator correspondent account number  “3088”
        preferred Is this the preferred correspondent  “”,
    },
    beneficiary Label – Beneiciary  Bank Details  {
        nm Bank Name  “SUMITOMO MITSUI BANKING CORPORATION”,
        pstlAdr Postal address  “277 PARK AVENUE, NEW YORK, 10172, UNITED STATES OF AMERICA”,
        nationalId Bank national id  “SMBCUS33”,
        bic Banks BIC  “SMBCUS33XXX”,
        acct Account number  “”,
        codeDetails  {
            codeName1 Code value 1 name  “BIC”,
            codeValue1 Code value 1  “SMBCUS33XXX”,
            codeName2 Code value 2 name  “CHIPS”,
            codeValue2 Code value 2  “013571”,
            codeName3 Code value 3 name  “BIC-4”,
            codeValue3 Code value 3  “SMBC”,
            codeName4 Code value 4 name  “ABA”,
            codeValue4 Code value 4  “026009674”
        },
ssiDetails LABEL
      assetCategory Asset type of correspondent bank account  “ALL”,
      corresBIC Beneficary correspondent BIC  “IRVTUS3NXXX”,
      corresAcct Beneficiary correspondent account number  “8900112026”,
      intrmyBIC1 Beneficary intermdiary 1 BIC  “”,
      intrmyAcct1 Beneficiary intermediary 1 account number  “”,
      intrmyBIC2 Beneficary intermdiary 2 BIC  “”,
      intrmyAcct2 Beneficiary intermediary 2 account number  “”,
      institutionName Bank Name  “THE BANK OF NEW YORK MELLON”,
      city Bank City  “NEW YORK,NY”,
      countryName Bank Country  “UNITED STATES OF AMERICA”,
      countryCode Bank ISO 2 digit country code  “US”,
      natId Domestic clearing code  “021000018”,
      preferred Is this the preferred correspondent  “”
    },
    recommendedAcct  “”,
    recommendedBIC Recommended beneficiary bic  “SMBCUS33XXX”,
    status Status code  “CAUTION”,
    comment Error code  “Check Asset category – Originator SSI was found but with incorrect asset category (07ro)”,
    ref Reference number  “20191206094912411”,
    bic8 Was the BIC8 flag set?  “N”

 

SAMPLE

https://apps.applyfinancial.co.uk/validate-api/rest/convert/2.3?originBIC=bukbgb22&originAcct=12345678&currencyCode=USD&countryCode=tr&nationalId=TUBATRIS&benAcct=12345678&token=bQYljJ8WWVip7kjpDksnN4vngxB25Qcr1ipMM7O0FZyuQH7mtggkzisX9hjH98pN0LCRq8WWNcam0Iie&ref&bic8&assetCategory=ANYY