Skip to main content
Denna artikel kommer att introducera en grundläggande information om bankkort API integration, som kan användas för att hämta grundläggande information om bankkort.

​
Ansökningsprocess

För att använda grundläggande information om bankkort API, börja med att gå till Ace Data Cloud-konsolen 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 där du uppmanas att registrera dig och logga in. När detta är klart kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka 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 konsolen.
📘 Fullständig dokumentation: Grundläggande information om bankkort API →

​
Grundläggande användning

Först bör du förstå den grundläggande användningsmetoden, vilket är att ange bankkortets nummer för att få verifieringsresultatet efter behandling. Du behöver först enkelt skicka ett bank_card-fält, och 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 typ av svar du vill ta emot, här anges 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: bankkortnummer.
  • encryption: valfritt, krypteringsparameter för känsliga fält (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 testa, som visas i bilden ovan, här får vi följande resultat:
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • result, autentiseringsresultatkod, avgiftsinformation nedan.
    • Avgiftsresultatkod:
      • 0: Frågan lyckades
      • -1: Ingen information hittades
    • Ingen avgiftsresultatkod:
      • -2: Verifieringscentret är upptaget
      • -3: Bankkortet finns inte
  • description, affärsresultatsbeskrivning.
  • account_bank, bank där kontot är öppnat.
  • account_type, korttyp: 1. Betalkort; 2. Kreditkort; 3. Förbetalt kort; 4. Godkänt kreditkort.
Det kan ses att grundläggande information om bankkortet har hämtats. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan:
Python integrationskoden ser ut så här:

​
Felhantering

När du anropar API:et, om du stöter på ett 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.

​
Exempel på felrespons

​
Slutsats

Genom detta dokument har du fått en förståelse för hur du använder grundläggande information om bankkort API för att hämta grundläggande information om det angivna bankkortnumret. 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.