Skip to main content
Niniejszy dokument przedstawia sposób integracji API weryfikacji dwóch elementów karty bankowej, które można wykorzystać do weryfikacji autentyczności i zgodności imienia oraz numeru karty bankowej.

​
Proces aplikacji

Aby skorzystać z API weryfikacji dwóch elementów karty bankowej, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość. Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do korzystania ze wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, aby móc skorzystać z usługi bez opłat; w przypadku niewystarczającego limitu można doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: API weryfikacji dwóch elementów karty bankowej →

​
Podstawowe użycie

Najpierw zapoznaj się z podstawowym sposobem użycia, polegającym na wprowadzeniu informacji o numerze karty bankowej, aby uzyskać przetworzony wynik w postaci obrazu. Należy najpierw przekazać prosty parametr bank_card. Następnie możemy wypełnić odpowiednie pola na interfejsie, jak pokazano na obrazku:

Możemy zauważyć, że ustawiliśmy nagłówki żądania, w tym:
  • accept: format odpowiedzi, który chcemy otrzymać, tutaj wpisujemy application/json, czyli format JSON.
  • authorization: klucz do wywołania API, który można bezpośrednio wybrać po złożeniu wniosku.
Dodatkowo ustawiono ciało żądania, w tym:
  • bank_card: informacje o numerze karty bankowej, jest to parametr obowiązkowy.
  • name: imię użytkownika, jest to parametr obowiązkowy.
  • encryption: opcjonalny, parametr szyfrowania dla wrażliwych danych (jeśli wymagane jest przesłanie zaszyfrowanych danych).
Po dokonaniu wyboru, można zauważyć, że po prawej stronie wygenerowano odpowiedni kod, jak pokazano na obrazku:

Kliknij przycisk „Try”, aby przeprowadzić test, jak pokazano na powyższym obrazku, otrzymujemy następujący wynik:
Zwracany wynik zawiera wiele pól, które są opisane poniżej:
  • result, kod wyniku autoryzacji, sytuacja dotycząca opłat jest następująca.
    • Kody wyników płatnych:
      • 0: Autoryzacja zakończona sukcesem
      • -1: Autoryzacja nie powiodła się
      • -4: Błędne informacje o posiadaczu karty
      • -5: Nieaktywowana płatność bez karty
      • -6: Karta została zatrzymana
      • -7: Nieprawidłowy numer karty
      • -8: Ta karta nie ma odpowiadającego wydawcy
      • -9: Karta nie została zainicjowana lub jest w stanie uśpienia
      • -10: Karta oszukańcza, zatrzymana karta
      • -11: Ta karta została zgłoszona jako zgubiona
      • -12: Ta karta wygasła
      • -13: Karta z ograniczeniami
      • -14: Przekroczono limit błędów hasła
      • -15: Wydawca karty nie obsługuje tej transakcji
    • Kody wyników bezpłatnych:
      • -2: Weryfikacja imienia nie powiodła się
      • -3: Numer karty bankowej jest błędny
      • -16: Usługa centrum weryfikacji jest zajęta
      • -17: Przekroczono limit weryfikacji, spróbuj ponownie następnego dnia
  • description, opis wyniku biznesowego.
Można zauważyć, że autentyczność i zgodność imienia oraz numeru karty bankowej zostały potwierdzone. Jeśli chcesz wygenerować odpowiedni kod integracyjny, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco:
Kod integracyjny w Pythonie wygląda następująco:

​
Obsługa błędów

Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informację. Na przykład:
  • 400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacji.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

​
Przykład odpowiedzi błędu

​
Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak korzystać z API weryfikacji dwóch elementów karty bankowej do weryfikacji autentyczności i zgodności imienia oraz numeru karty bankowej. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W przypadku jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.