Hoppa till huvudinnehåll
Detta dokument kommer att introducera en bankkort tvåfaktorsverifiering API integration beskrivning, som kan användas för att verifiera äktheten och överensstämmelsen av namn och bankkortnummer.

​
Ansökningsprocess

För att använda API:et måste du först gå till bankkort tvåfaktorsverifiering API motsvarande sida för att ansöka om den tjänst som behövs. När du kommer till sidan, klicka på “Acquire” knappen, som visas i bilden: Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att uppmanas att registrera dig och logga in. Efter inloggning och registrering kommer du automatiskt att återvända till den aktuella sidan. Vid första ansökan kommer det att finnas en gratis kvot som ges, så att du kan använda API:et gratis.

​
Grundläggande användning

Först bör du förstå den grundläggande användningsmetoden, vilket är att ange bankkortets kortnummerinformation för att få en bearbetad resultatbild. Du behöver först 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 Request Headers, 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, som kan väljas direkt efter ansökan.
Dessutom har vi ställt in Request Body, inklusive:
  • bank_card: den bankkortnummerinformation som behöver bearbetas, är ett obligatoriskt parameter.
  • name: användarens namn, är ett obligatoriskt parameter.
  • encryption: valfritt, känsliga fält krypteringsparameter (om krypterad text behöver skickas).
När du har valt kan du se att motsvarande kod också genererades till höger, som visas i bilden:

Klicka på “Try” knappen för att utföra testet, som visas i bilden ovan, här fick vi följande resultat: 
{
  "result": "0",
  "description": "Autentisering godkänd"
}
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • result, autentiseringsresultatkod, avgiftsinformation som följer.
    • Avgiftsresultatkod:
      • 0: Autentisering godkänd
      • -1: Autentisering inte 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 tagits
      • -11: Detta kort har anmälts för förlust
      • -12: Detta kort har gått ut
      • -13: Begränsat kort
      • -14: För många felaktiga lösenordsförsök
      • -15: Utfärdande bank stöder inte denna transaktion
    • Ingen avgiftsresultatkod:
      • -2: Namnverifiering inte godkänd
      • -3: Bankkortnummer är felaktigt
      • -16: Verifieringscentralens tjänst är upptagen
      • -17: Verifieringsantalet har överskridits, vänligen försök igen nästa dag
  • description, affärsresultatsbeskrivning.
Det kan ses att äktheten och överensstämmelsen av namnet och bankkortnumret för detta bankkort har godkänts. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan: 
curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-2e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "bank_card": "***"
}'
Python integrationskoden ser ut så här: 
curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-2e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "bank_card": "***"
}'

​
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: Internt serverfel, något gick fel på servern.

​
Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "hämtning misslyckades"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder bankkort tvåfaktorsverifiering API för att verifiera äktheten och överensstämmelsen av namn och bankkortnummer. 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.