BIC/SWIFT-kode validerings-API

Sådan integrerer du BIC validerings-API i din software

1. Hvad er BIC validerings-API?

Ved ekspedition af pengeoverførelser og IBAN-relaterede transaktioner, er det afgørende at have den korrekte SWIFT / BIC kode, hvis betalingen skal gå igennem.
Vores virksomhed har licenseret det officielle BIC-register fra S.W.I.F.T SCRL for at tilvejebringe en effektiv og enkel måde til automatisk validering af BIC. Denne service giver dig mulighed for at integrere opslag i BIC kode registret i din software til interne formål

BIC validerings-API har SWIFTRef Data inden i. BIC data bruges med tilladelse fra S.W.I.F.T. SCRL. Database rettigheder forbeholdes 2019

2. Funktioner

Nøglefunktioner af BIC validerings-API:

  • Find information om banken baseret på BIC-koden.
  • Gennemsøg BIC-registret ved at indtaste en del af banknavnet og landet.
  • Gennemsøg BIC-registret for historiske optegnelser.
  • Brug både komplet og forenklet API-respons for lettere integrering.


3. API brug

BIC Validerings API er REST-baseret og understøtter enkle HTTP GET eller POST forespørgsler.

De accepterede parametre er angivet i skemaet herunder:

Feltnavn Længde Type Beskrivelse
bic 11 Streng BIC / SWIFT kode til opslag. Kan være på 8 eller 11 tegn
bank_navn 256 Streng Del af et banknavn til at foretage søgning i BIC-registret.
land 2 Streng Landekode på to bogstaver. Påkrævet ved søgning efter banknavn.
api_key 128 Streng Din personlige API-nøgle.
format 4 Streng Påkrævet for at specificere formatet på de hentede data. Nuværende understøttede værdier: json, xml
grænse Heltal Valgfrit: kan bruges til at begrænse antallet af resultater ved søgning efter banknavn.
hist Heltal Valgfrit: kan bruges til at vise historiske optegnelser fra databasen for både bank og BIC søgninger.
Inde i din Online Portal kan du finde din API-nøgle og Anmodnings slut-URL, som bruges til at sikre søgningsanmodninger.


4. API XML respons struktur

Du kan downloade et XSD-skema over API responser.
En detaljeret beskrivelse over de tilbagesendte felter kan ses i skemaet herunder:

Feltnavn Type Længde Altid tilstede Beskrivelse
MODIFIKATIONSFLAG Alfabetisk 1 Ja I delta filer:
• A (tilføjelse)
• M (ændring)
• D (sletning) i hele filer I hele filer:
• A (tilføjelse)
ÆNDRET FELT Numerisk 186 Nej Registrerer det felt (eller TAG), der er ændret, enten som resultat af en ændret optegnelse som resultat af en ny BEGIVENHED.
En eller flere kolonner er angivet som en talrække, hvor hvert tal repræsenterer den kolonne, der er ændret fra den foregående optegnelse eller den foregående BEGIVENHED.
Eksempel "6,7,8,9"
Dette betyder, at BEGIVENHEDSTYPE, BEGIVENHEDSDATO, BIC8 og FILIAL BIC er blevet
ændret.
Følgende FELTER kan ikke anføres i ÆNDRET FELT:
• OPTEGNELSESNØGLE
• ÆNDRET FELT
• ÆNDRINGSFLAG
OPTEGNELSESNØGLE Alfanumerisk 12 Ja Den unikke nøgle for optegnelsen i filen
Hver optegnelse repræsenterer en begivenhed i BIC livscyklussen.
Efter den er tildelt, ændrer OPTEGNELSESNØGLEN sig aldrig.
TIDLIGERE OPTEGNELSESNØGLE Alfanumerisk 12 Nej OPTEGNELSESNØGLE for tidligere linket BEGIVENHED
Alle relaterede begivenheder er forbundet via link og kan findes ved hjælp af disse oplysninger.
NÆSTE OPTEGNELSESNØGLE Alfanumerisk 12 Nej OPTEGNELSESNØGLE for næste relaterede linket begivenhed
Alle relaterede begivenheder er forbundet via link og kan findes ved hjælp af disse oplysninger
BEGIVENHEDSTYPE Alfabetisk 32 Ja BEGIVENHEDEN eller ændringsbeskrivelsen for BIC’en som har fundet sted i fortiden, nutidigt eller vil finde sted i fremtiden.
Begivenhedstyper:
• BIC UDSTEDT
• BIC UDLØBET
• BIC AKTIVERET PÅ FIN
• BIC AKTIVERET PÅ FA
• BIC AKTIVERET PÅ IA
• BIC DEAKTIVERET PÅ FIN
• BIC DEAKTIVERET PÅ FA
• BIC DEAKTIVERET PÅ IA
• BIC DEAKTIVERET
• BIC SUSPENDERET
• BIC GENAKTIVERET
• BIC OFFENTLIGGJORT
• BIC BIC LOVMÆSSIG NAVNEFORANDRING
• BIC INSTITUTIONSNAVN ÆNDRET
• BIC BIC ADRESSE ÆNDRET
• FIN SERVICE KODE ÆNDRET
Den seneste opdatering er den sidste linje i BIC rækkefølgen (dvs. den seneste post).
Når en ny BEGIVENHED tilføjes, bliver MODIFIKATIONSFLAGET og kolonnen for ÆNDRET
FELTET opdateret i den umiddelbart foregående relaterede BEGIVENHED.
BEGIVENHEDSDATO Alfanumerisk 8 Ja Dato for BEGIVENHEDEN
BIC8 Alfanumerisk 8 Ja BIC (institution, land og gruppe suffiks) hvor:
• Gruppepræfiks (4 tegn)
• Landekode (2 tegn)
• Gruppesuffiks (2 tegn)
FILIAL BIC Alfanumerisk 3 Ja BIC filial-identifikator forbundet med BIC på 8 tegn. Hvis der ikke findes nogen filial-identifikator, bruges XXX.
BIC Alfanumerisk 11 Ja Komplet BIC: BIC på 8 tegn med filial-identifikator
OPTEGNELSESSTATUS Alfabetisk 1 Ja Viser optegnelsens status:
• [C] = Current (aktuel) repræsentation af den seneste begivenhed i kæden op til datoen for offentliggørelse, bortset fra [F]remtidige begivenheder
• [H] = Historiske optegnelser i begivenhedskæden
• [F] = Fremtidig begivenhed, der vil finde sted efter datoen for offentliggørelse i registret. Den tidligere angivne [C]urrent (aktuelle) begivenhed vil være gyldig indtil den dato, der specificeres i [F]remtidig begivenhed.
For FREMTIDIGE begivenheder viser datoen, hvornår ændringen vil TRÆDE I KRAFT.
OPERATIONELT AKTIV OPTEGNELSE Alfa 1 Ja Der er flere optegnelser for samme BIC. Dette felt viser, hvilken af optegnelserne for samme BIC er den operationelt aktive BIC og bør bruges.
• [Y] Operationelt aktiv
• [N] Operationelt inaktiv
For hver unik BIC, er der en enkelt optegnelse, der viser AKTIV status (Y).
Optegnelser med [H]istorisk status vil altid vise [N].
Optegnelser med [C]urrent (aktuel) kan vise [Y] eller [N].
Optegnelser med [F] vil altid vise [N].
UNDERTYPE INDIKATOR Alle typer 4 Ja Enhedens forretningstype. Undertype Indikator vises kun for optegnelser med en BIC.
SWIFT FIN Alfabetisk 1 Ja Status for en enheds tilslutning til FIN:
• [Y] tilsluttet FIN
• [N] ikke tilsluttet FIN
SWIFT FA Alfabetisk 1 Ja Status for en enheds tilgængelighed gennem FileAct:
• [Y] tilsluttet FileAct
• [N] ikke tilsluttet FileAct
SWIFT IA Alfa 1 Ja Status for en enheds tilgængelighed gennem InterAct:
• [Y] tilsluttet InterAct
• [N] ikke tilsluttet InterAct
JURIDISK NAVN Alle 105 Nej Institutionens juridiske navn
INSTITUTIONSNAVN Alle 105 Ja Institutionens forretningsnavn (offentlige navn)
INSTITUTIONSTYPE Alfabetisk 12 Ja Organisation, der først og fremmest er involveret i finansiel formidling og/eller i finansielle hjælpeaktiviteter
Institutionstype:
• FINANSIEL
• IKKE-FINANSIEL
ENHEDSTYPE Alfabetisk 16 Ja Identificerer typen af finansiel enhed:
• Juridisk enhed
• Filial
• Operationel
RE FYSISK ADRESSE 1 Alle 35 Nej [Registrering] Vejnavn
RE FYSISK ADRESSE 2 Alle 35 Nej [Registrering] Husnummer
RE FYSISK ADRESSE 3 Alle 35 Nej [Registrering] Bygning, bygningsnavn, etage
RE FYSISK ADRESSE 4 Alle 35 Nej [Registrering] Område
RE BY Alle 35 Nej [Registrering] Bynavn for institutionen/filialen
RE ADM Alle 90 Nej [Registrering] Land, provins, stat eller anden administrativ region for ejeren af institutionen/filialen
RE POSTNUMMER Alle 15 Nej [Registrering] Postnummer for institutionen/filialen
RE POSTBOKSNUMMER Alle 35 Nej Komma-opdelt felt med postboksnummer for institutionen/filialen og det tilknyttede postnummer.
Eksempel
"Boks 103352, 40024"
Dette giver kunder mulighed for at bruge hele postboksadressen:
Boks 103352
40024, DÜSSELDORF (BY)
OP FYSISK ADRESSE 1 Alle 35 Nej [Operationel] Vejnavn
OP FYSISK ADRESSE 2 Alle 35 Nej [Operationel] Husnummer
OP FYSISK ADRESSE 3 Alle 35 Nej [Operationel] Bygning, bygningsnavn, etage
OP FYSISK ADRESSE 4 Alle 35 Nej [Operationel] Område
OP BY Alle 35 Nej [Operationel] Bynavn for institutionen/filialen
OP ADM Alle 90 Nej [Operationel] Land, provins, stat eller anden administrativ region for ejeren af institutionen/filialen
OP POSTNUMMER Alle 15 Nej [Operationel] Postnummer for institutionen/filialen
OP POSTBOKSNUMMER Alle 35 Nej Komma-opdelt felt med postboksnummer for institutionen/filialen og det tilknyttede postnummer.
Eksempel
"BOKS 103352, 40024"
Dette giver kunder mulighed for at bruge hele postboksadressen:
BOKS 103352
40024, DÜSSELDORF (BY)
BR FYSISK ADRESSE 1 Alle 35 Nej [Filial] Vejnavn
BR FYSISK ADRESSE 2 Alle 35 Nej [Filial] Husnummer
BR FYSISK ADRESSE 3 Alle 35 Nej [Filial] Bygning, bygningsnavn, etage
BR FYSISK ADRESSE 4 Alle 35 Nej [Filial] Område
BR BY Alle 35 Nej [Filial] Bynavn for institutionen/filialen
BR ADM Alle 90 Nej [Filial] Land, provins, stat eller anden administrativ region for ejeren af institutionen/filialen
BR POSTNUMMER Alle 15 Nej [Filial] Postnummer for institutionen/filialen
BR POSTBOKSNUMMER Alle 35 Nej Komma-opdelt felt med postboksnummer for institutionen/filialen og det tilknyttede postnummer.
Eksempel
"Boks 103352, 40024"
Dette giver kunder mulighed for at bruge hele postboksadressen:
Boks 103352
40024, DÜSSELDORF (BY)
FILIAL OPLYSNINGER Alle 70 Nej Filial oplysninger
Dette er en gratis tekstbeskrivelse af filialen leveret af det tilhørende finanshus. Foreløbig leveres dette kun for registreringer med BIC, og kun når det pågældende finanshus ønsker at levere disse ekstra oplysninger. Oplysningerne skaffes fra BIC registret.
LANDENAVN Alle 70 Ja Landenavnet for institutionen/filialen som vist på ISO 3166
ISO LANDEKODE Alfabetisk 2 Ja ISO 3166-1 alfa-2 kode af landet for institutionen/filialen
STEDKODE Alle typer 1 Ja Indeholder stedet (officielt i position 7 af BIC standard:2009)
Eksempler:
• I FR, BIC i Paris = P
• I BE, BIC i Bruxelles = B
• I US, BIC på Østkysten = 3
FIN SERVICEKODER Alle typer 60 Nej FIN servicekoder (kaldes også merværdi servicekoder). Servicekoder leveres kun for optegnelser, der indeholder en BIC.
Feltet kan indeholde op til 20 koder på tre tegn i alfabetisk orden.
OPTEGNELSESNØGLE BDP Alfanumerisk 12 Nej Bankens unikke nøgle Register plus optegnelsen i filen .
Felt A Alle 1 Nej Reserveret til fremtidig brug
Felt B Alle 64 Nej Reserveret til fremtidig brug
Felt C Alle 128 Nej Reserveret til fremtidig brug
Felt D Alle 256 Nej Reserveret til fremtidig brug
Felt E Alle 11 Nej Reserveret til fremtidig brug
Felt F Alle 12 Nej Reserveret til fremtidig brug
API systemet leverer resultater i XML format, som er let at fortolke for flere forskellige programmeringssprog og platforme.

Et eksempel på et XML svar fra API for en BIC søgning ville være:


<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 ADRESSE ÆNDRET</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>FINANSIEL</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>(ALLE FILIALER I STORBRITANNIEN)</branch_information>
<country_name>STORBRITANNIEN</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 fejl

I tilfælde af, at API sender en XML respons, der indeholder en fejlmeddelelse.

XML tags sendes tilbage uden andre felter i XML responsen.

Herunder finder du en beskrivelse af alle mulige fejlmeddelelser, der kan sendes:

Statuskode Type Beskrivelse
301 Kontofejl Ugyldig API nøgle
302 Kontofejl Abonnement udløbet
303 Kontofejl Ikke flere forespørgsler
304 Kontofejl Du har ikke adgang til denne API
401 Inputfejl Acceptabel SWIFT længde 8 eller 11 tegn
402 Inputfejl Banknavn ugyldigt! Banksøgning bør indeholde mindst 4 tegn.
Tilladte tegn a-z, A-Z, 0-9, [mellemrum]!
403 Inputfejl Forkert landekode! Landekode kan kun indeholde 2 bogstaver, for eksempel: UK, DE, FR