Skip to main content
Denna artikel kommer att introducera en bankkort fyra element verifiering API integration beskrivning, som kan användas för att ange bankkortnummer, namn, kontoinnehavardokumentnummer och registrerat mobilnummer, för att verifiera informationens äkthet och överensstämmelse.

​
Ansökningsprocess

För att använda bankkort fyra element verifiering API, börja med att gå till Ace Data Cloud kontrollpanelen för att få din API-token, som du kan spara för framtida bruk. Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token kan användas för att anropa alla tjänster på plattformen, du behöver inte ansöka om en separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är slut kan du ladda på allmän balans i kontrollpanelen.
📘 Fullständig dokumentation: Bankkort fyra element verifiering API →

​
Grundläggande användning

Först bör du förstå den grundläggande användningsmetoden, vilket är att ange bankkortets kortnummerinformation, så får du en bearbetad resultatbild, först behöver du enkelt överföra ett bank_card fält. Vi kan sedan fylla i motsvarande innehåll på gränssnittet, som visas i bilden:

Här kan vi se att vi har ställt in begärningshuvuden, inklusive:
  • accept: vilken format av svar du vill ta emot, här anges som application/json, det vill säga JSON-format.
  • authorization: nyckeln för att anropa API:et, efter ansökan kan du direkt välja från rullgardinsmenyn.
Dessutom har vi ställt in begärningskroppen, inklusive:
  • bank_card: den bankkortnummerinformation som behöver bearbetas, är ett obligatoriskt parameter.
  • id_card: kontoinnehavardokumentnummer, är ett obligatoriskt parameter.
  • name: användarens namn, är ett obligatoriskt parameter.
  • phone: registrerat mobilnummer.
  • cert_type: typ av kontoinnehavardokument, måste överensstämma med kontoinnehavardokumentet.
  • encryption: valfritt, känsliga fält krypteringsparameter (om du behöver skicka krypterad text).
När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på “Try” knappen för att utföra tester, som visas i bilden ovan, här har vi fått följande resultat:
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • result, verifieringsresultatkod, avgiftsläget är som följer.
    • Avgiftsresultatkod:
      • 0: Verifiering godkänd
      • -1: Verifiering ej godkänd
      • -4: Kortinnehavarens information är felaktig
      • -5: Ingen kortbetalning aktiverad
      • -6: Detta kort har beslagtagits
      • -7: Ogiltigt kortnummer
      • -8: Detta kort har ingen motsvarande utfärdande bank
      • -9: Detta kort är inte initialiserat eller är ett vilande kort
      • -10: Fusk kort, kortet har fastnat
      • -11: Detta kort har anmälts för förlust
      • -12: Detta kort har gått ut
      • -13: Begränsat kort
      • -14: Antal felaktiga lösenord överskrider gränsen
      • -15: Utfärdande bank stöder inte denna transaktion
    • Ingen avgiftsresultatkod:
      • -2: Namnverifiering ej godkänd
      • -3: Bankkortnummer är felaktigt
      • -16: Verifieringscentralens tjänst är upptagen
      • -17: Antal verifieringar överskrider gränsen, vänligen försök igen nästa dag
  • description, affärsresultatsbeskrivning.
Det kan ses att detta bankkortets bankkortnummer, namn, kontoinnehavardokumentnummer och registrerat mobilnummer har äkthet och överensstämmelse. Om du dessutom vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan:
Python integrationskoden ser ut som följer:

​
Felhantering

När du anropar API:et, om du stöter på fel, kommer API:et att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Bad request, kan bero på saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Bad request, kan bero på saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obehörig, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Intern serverfel, något gick fel på servern.

​
Felrespons exempel

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder bankkort fyra element verifiering API för att ange bankkortnummer, namn, kontoinnehavardokumentnummer och registrerat mobilnummer, för att verifiera informationens äkthet och överensstämmelse. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.