BIC / SWIFT Code Validatie API

Hoe kunt u de BIC Validatie API in uw software integreren

1. Wat is de BIC Validation API?

Bij het verwerken van betalingen via de bank en het afhandelen van IBAN-gerelateerde transacties, is het van vitaal belang dat u de juiste SWIFT / BIC-code ontvangt voor sucecful betalingen.
Ons bedrijf heeft de officiële BIC-directory van S.W.I.F.T SCRL in licentie gekregen om een krachtige en eenvoudige manier te bieden om BIC automatisch te valideren. Met deze service kunt u BIC-directory lookup in uw software integreren voor interne doeleinden

BIC Validation API heeft SWIFtref Data Inside. BIC-gegevens gebruikt met toestemming van S.W.I.F.T. CVBA. Database rechten voorbehouden 2018

2. Eigenschappen

Belangrijkste functies van BIC Validatie API:

  • Informatie ophalen over de bank op basis van de BIC.
  • Zoeken in de BIC-directory naar een deel van de banknaam en het land.
  • Zoeken in de BIC-directory naar historische records.
  • Zowel een volledige als vereenvoudigde API-respons voor eenvoudige integratie.


3. API Gebruik

De BIC Validatie API is gebaseerd op REST en ondersteunt eenvoudige HTTP GET- of POST-aanvragen.

De geaccepteerde parameters worden weergegeven in de onderstaande tabel:

Veldnaam Lengte Type Omschrijving
bic 11 String BIC / SWIFT-code lookup. Kan 8 of 11 tekens bevatten
bank_naam 256 String Deel van een banknaam om in de BIC-directory te zoeken.
land 2 String Tweeletterige Landcode. Noodzakelijk bij zoeken op banknaam.
api_key 128 String Uw persoonlijke API key.
format 4 String Vereist om het formaat van de geretourneerde gegevens te specificeren. Momenteel ondersteunde waarden:json, xml
Beperken Integer Optioneel: kan worden gebruikt om het aantal resultaten te beperken bij het zoeken op banknaam.
hist integer Optioneel: kan worden gebruikt om historische gegevens uit de database weer te geven voor zowel bank- als BIC-zoekopdrachten.
In uw Online Portal vindt u uw API-sleutel en kunt u een Endpoint-URL aanvragen, die wordt gebruikt om de zoekverzoeken te beveiligen.


4. API XML Respons Structuur

U kunt een XSD Schema van de API-reactie downloaden.
Een gedetailleerde beschrijving van de teruggegeven velden is te zien in de onderstaande tabel:

aan                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             
Veldnaam Type Lengte Altijd beschikbaar Omschrijving
MODIFICATI VLAG Alfabetisch 1 Ja In delta files:
• A (toevoeging)
• M (modificatie)
• D (verwijdering) in volledige bestanden in volledige bestanden:
• A (toevoeging)
GEWIJZIGD VELD Numeriek 186 Ne Registreert het veld (of TAG) dat is gewijzigd als gevolg van een wijziging in een record of als het resultaat van een nieuwe EVENT.
  Een of meer kolommen worden aangegeven als een reeks getallen waarbij elk getal de kolom vertegenwoordigt die is gewijzigd ten opzichte van de vorige registratie of vorige EVENEMENT.
  Voorbeeld & quot; 6,7,8,9 & quot;   Dit betekent dat EVENEMENT TYPE, EVEENEMEN DATUM, BIC8 en FILIAAL BIC een
hebben   veranderd.
  De volgende VELDEN worden uitgesloten van opname in GEWIJZIGD VELD:
• RECORD KEY
• GEWIJZIGD VELD
• MODIFICATIE VLAG
RECORD KEY Alfanumeriek 12 Jes De unieke sleutel van de record in het bestand
  Elke record vertegenwoordigt een gebeurtenis in de BIC-levenscyclus.
  Na toekenning verandert de RECORD-toets nooit.
VORIGE RECORD KEY Alfanumeriek 12 Ne De RECORD KEY van de eerder gekoppelde EVENEMENT-versie   Alle gerelateerde evenementen zijn gekoppeld en kunnen worden gevonden met behulp van deze informatie.
VOLGENDE RECORD KEY Alfanumeriek 12 Nee De RECORDS KEY van de volgende gerelateerde gekoppelde gebeurtenis
  Alle gerelateerde evenementen zijn gekoppeld en kunnen worden gevonden met behulp van deze informatie
EVENEMENT TYPE Alfabetisch 32 Jas De EVENT of wijzigingsbeschrijving gerelateerd aan de BIC die zich in het verleden, in het heden heeft voorgedaan of die zich in de toekomst zal voordoen.
  Gebeurtenistypes:
• BIC UITGEGEVEN
  • BIC VERLOPEN
  • BIC ACTIEF OP FIN
  • BIC ACTIEF OP FA
  • BIC ACTIEF OP IA
  • BIC GEDEACTIVEERD OP FIN
  • BIC GEDEACTIVEERD OP FA
  • BIC GEDEACTIVEERD OP IA
  • BIC GEDEACTIVATEERD
  • BIC OPGESCHORST
  • BIC GEHERACTIVEERD
  • BIC GEPLUBICEERD
  • BIC JURIDISCHE NAAM GEWIJZIGD
  • BIC INSTITUUTNAAM GEWIJZIGD
  • BIC-ADRES GEWIJZIGD
  • FIN SERVICE CODE GWIJZIGD
  De laatste update-datum is de laatste regel van de BIC-reeks (dat wil zeggen, de meest recente invoer).
  Wanneer een nieuwe EVENT wordt toegevoegd, de MODIFICATIEVLAG en GEWIJZIGDE
  De kolom VELD wordt bijgewerkt in de onmiddellijke vorige gerelateerde EVENT.
EVENEMENT DATUM Alfanumeriek 8 Ja De datum van het EVENEMENT
BIC8 Alfanumeriek 8 Ja BIC (instituut, land en partij suffix) waar:
• Partijprefix (4 tekens)
  • Landcode (2 tekens)
  • Partitiesuffix (2 tekens)
FILIAAL BIC Alfanumeriek 3 Ja De BIC-filiaal identificeerder die is gekoppeld aan de BIC met 8 tekens. Als er geen filiaal-ID bestaat, wordt XXX gebruikt.
BIC Alfanumeriek 11 Ja De volledige BIC: 8-karakters BIC en filiaal identificeerder
RECORD STATUS Alfabetisch 1 Ja Geeft de status van de record aan:
  • [C] = Huidige staat voor de laatste gebeurtenis in de keten tot de publicatiedatum, exclusief [F] uture-gebeurtenissen
  • [H] = historische records in de gebeurtenisketen
  • [F] = Toekomstige gebeurtenis die zal plaatsvinden na de publicatiedatum van de map. De eerder aangegeven [C] urrent-gebeurtenis is geldig tot de datum die is opgegeven in de [F] uture-gebeurtenis.
  Voor TOEKOMSTIGE-evenementen geeft de datum aan wanneer de wijziging GELDIG VAN is.
OPERATIONEEL ACTIEVE RECORD Alfa 1 Ja Er zijn meerdere records voor dezelfde BIC. Dit veld geeft aan welke van de records voor dezelfde BIC de operationeel actieve BIC is en moet worden gebruikt.
  • [Y] Operationeel actief
  • [N] Operationeel inactief
  Voor elke unieke BIC is er één vermelding voor de vermelding van een ACTIEF-status (Y).
  Records met de [H] -istorIEstatus geven altijd [N] aan.
  Records met [C] urrent kunnen [J] of [N] aangeven.
  Records met [F] geven altijd [N].
SUBTYPE INDICATOR Elk type 4 Ja Het bedrijfstype van de entiteit. Subtype-indicator wordt alleen verstrekt voor records met een BIC.
SWIFT FIN Alfabetisch 1 Ja Status van de verbinding van een entiteit met FIN:
  • [Y] verbonden met FIN
  • [N] niet verbonden met FIN
SWIFT FA Alfabetisch 1 Ja Status van de bereikbaarheid van een entiteit via FileAct:
  • [Y] verbonden met FileAct
  • [N] niet verbonden met FileAct
SWIFT IA Alfa 1 Ja Status van de bereikbaarheid van een entiteit via InterAct:
  • [Y] verbonden met InterAct
  • [N] niet verbonden met InterAct
LEGALE NAAM Elke 105 Nee Legale naam Instituuti
NAAM INSTITUUT Elke 105 Ja Handelsnaam Instituute (gepubliceerde naam)
INSTITUUT TYPE Alfabetisch 12 Ja Organisatie die zich hoofdzakelijk bezighoudt met financiële intermediatie en / of financiële hulpactiviteiten
  Type instelling:
  • FINANCIEEL
  • NONFINANCIEEL
ENTITEIT TYPE Alfabetisch 16 Ja Identificeert het type financiële entiteit:
  • Juridische entiteit
  • Filiaal   • Operationeel
RE ADRES 1 Alle 35 Nee [Registratie] Straatnaam
RE ADRES 2 Alle 35 Nee [Registratie] Straatnummer
RE ADRES 3 Alle 35 Nee [Registratie] Gebouw, naam gebouw, verdieping
RE ADRES 4 Alle 35 Nee [Registratin] Gebied
RE STAD Alle 35 Nee [Registratie] Plaatsnaam van de instelling / filiaal
RE CPS Alle 90 Nee [Registratie] Provincie, regio, staat of andere administratieve regio van de instelling / filiaal
RE POSTCODE Alle 15 Nee [Registratie] Postcode van de instelling / filiaal
RE POB NUMBER Alle 35 Nee Door komma's gescheiden veld met het POB-nummer van de instelling / het filiaal en de bijbehorende postcode.
  Voorbeeld
  & quot; POB 103352, 40024 & quot;
  Hiermee kunnen klanten het volledige POB-adres gebruiken:
  POB 103352
  40024, DUSSELDORF (STAD)
OP StrAATADRES 1 Alle 35 Nee [Operationeel] Straatnaam
OP StrAATADRES 2 Alle 35 Nee [Operationeel] Straatnummer
OP StrAATADRES 3 Alle 35 Nee [Operationeel] Gebouw, naam van gebouw, verdieping
OP StrAATADRES 4 Alle 35 Nee [Operationeel] gebied
OP STAD Alle 35 Nee [Operationeel] Plaatsnaam van de instelling / branche
OP CPS Alle 90 Nee [Operationeel] Provincie, provincie, staat of andere administratieve regio van de instelling / filiaal
OP POSTCODE Alle 15 Nee [Operationeel] Postcode van de instelling / filiaal
OP POB NUMMER Alle 35 Nee Door komma's gescheiden veld met het POB-nummer van de instelling / het filiaal en de bijbehorende postcode.
  Voorbeeld
  & quot; POB 103352, 40024 & quot;
  Hiermee kunnen klanten het volledige POB-adres gebruiken:
POB 103352
40024, DUSSELDORF (STAD)
BR StrAATADRES 1 Alle 35 Nee [Filiaal] Straatnaam
BR StrAATADRES 2 Alle 35 Nee [Filiaal] Straatnummer
BR StrAATADRES 3 Alle 35 Nee [Filiaal] Gebouw, naam van gebouw, verdieping
BR StrAATADRES 4 Alle 35 Nee [Filiaal] Area
BR STAD Alle 35 Nee [Tak] Plaatsnaam van de instelling / filiaal
BR CPS Alle 90 Nee [Plaats] Provincie, provincie, staat of andere administratieve regio van de instelling / filiaal
BR POSTCODE Alle 15 Nee [Tak] Postcode van de instelling / filiaal
BR POB NUMMER Alle 35 Nee Door komma's gescheiden veld met het POB-nummer van de instelling / het filiaal en de bijbehorende postcode.
  Voorbeeld
  & quot; POB 103352, 40024 & quot;
  Hiermee kunnen klanten het volledige POB-adres gebruiken:
POB 103352
40024, DUSSELDORF (STAD)
FILIAALINFORMATIE Alle 70 Nee Filiaalgegevens
  Dit is een gratis tekstbeschrijving van het filiaal zoals verstrekt door de financiële instelling waartoe het behoort. Voorlopig wordt dit alleen verstrekt voor boekingen met een BIC en alleen als de betrokken financiële instelling deze extra informatie wil verstrekken. De informatie is afkomstig van de BIC-directory.
LANDNAAM Alle 70 Ja De landnaam van de instelling / het filiaal zoals aangegeven in ISO 3166
ISO LANDCODE Alfabetisch 2 Ja De ISO 3166-1 alpha-2 code van het land van de instelling / het filiaal
LOCATIECODE Elk type 1 Ja Bevat de locatie (formeel in positie 7 van BIC-standaard: 2009)
Voorbeelden:
  • In FR, BIC's in Parijs = P
  • In BE, BICs in Brussel = B
  • In VS, BICs in Oost-kosten = 3
FIN SERVICECODES Elk type 60 Nee FIN-servicecodes (ook codes met toegevoegde servicecodes genoemd). Servicecodes worden alleen verstrekt voor records met een BIC.
  Het veld kan maximaal 20 codes van drie tekens in alfabetische volgorde bevatten.
RECORD KEY BDP alfanumerieke 12 Nee De unieke sleutel van de Bank Directory Plus-record in het bestand.
VELD A Alle 1 Nee Gereserveerd voor toekomstig gebruik
VELD B Alle 64 Nee Gereserveerd voor toekomstig gebruik
VELD C Alle 128 Nee Gereserveerd voor toekomstig gebruik
VELD D Alle 256 Nee Gereserveerd voor toekomstig gebruik
VELD E Alle 11 Nee Gereserveerd voor toekomstig gebruik
VELD F Alle 12 Nee Gereserveerd voor toekomstig gebruik
Het API-systeem levert resultaten op in XML-indeling, die gemakkelijk te ontleden is in verschillende programmeertalen en platforms.

  Een voorbeeld XML-antwoord van de API voor een BIC-zoekopdracht zou zijn:


<result>
<bicdata>
<row>
<modification_flag>A</modification_flag>
<changed_field>34</changed_field>
<record_key>BP0000004OQQ</record_key>
<previous_record_key>BP00000030XZ</previous_record_key>
<next_record_key/>
<event_type>BIC ADDRESS CHANGED</event_type>
<event_date>20150606</event_date>
<bic8>BARCGB22</bic8>
<branch_bic>XXX</branch_bic>
<bic>BARCGB22XXX</bic>
<record_status>C</record_status>
<operationally_active_record>Y</operationally_active_record>
<subtype_indicator>SUPE</subtype_indicator>
<swift_fin>Y</swift_fin>
<swift_fa>N</swift_fa>
<swift_ia>N</swift_ia>
<legal_name>BARCLAYS BANK PLC</legal_name>
<institution_name>BARCLAYS BANK PLC</institution_name>
<institution_type>FINANCIAL</institution_type>
<entity_type>Legal Entity</entity_type>
<re_street_address_1>1, CHURCHILL PLACE</re_street_address_1>
<re_street_address_2/>
<re_street_address_3/>
<re_street_address_4/>
<re_city>LONDON</re_city>
<re_cps/>
<re_zip_code>E14 5HP</re_zip_code>
<re_pob_number/>
<op_street_address_1>1 CHURCHILL PLACE</op_street_address_1>
<op_street_address_2/>
<op_street_address_3/>
<op_street_address_4/>
<op_city>LONDON</op_city>
<op_cps>LONDON E14 5HP</op_cps>
<op_zip_code/>
<op_pob_number/>
<br_street_address_1/>
<br_street_address_2/>
<br_street_address_3/>
<br_street_address_4/>
<br_city/>
<br_cps/>
<br_zip_code/>
<br_pob_number/>
<branch_information>(ALL U.K. OFFICES)</branch_information>
<country_name>UNITED KINGDOM</country_name>
<iso_country_code>GB</iso_country_code>
<location_code>2</location_code>
<fin_service_codes>EBAERPFINSCOSTGTGT</fin_service_codes>
<record_key_bdp>BD00000006FO</record_key_bdp>
<field_a/>
<field_b/>
<field_c/>
<field_d/>
<field_e/>
<field_f></field_f>
</row>
</bicdata>
<errors/>
</result>




5. API Fouten

In het geval van een fout retourneert de API een XML-antwoord met het foutbericht.

De XML-tags worden geretourneerd zonder andere velden in het XML-antwoord.

Hieronder vindt u een beschrijving van alle mogelijke foutmeldingen die kunnen worden geretourneerd:

                                                                                                     
Statuscode Type Beschrijving
301 Accountfout API Key is ongeldig
302 Accountfout Abonnement verlopen
303 Accountfout Geen vragen beschikbaar
304 Accountfout U hebt geen toegang tot deze API
401 Invoerfout Geaccepteerde SWIFT-lengte 8 of 11 tekens '
402 Invoerfout Banknaam ongeldig! Bank zoeken moet minimaal 4 karakters lang zijn.   
Toegestane tekens a-z, A-Z, 0-9, [spatie]!
403 Invoerfout Landcode onjuist! Toegestaan is de landcode van 2 letters. Voorbeeld: GB, DE, FR