CartDNA jest Shopify partnerem rozwoju aplikacji płatniczych

Logo CartDNA

API CartDNA

Użyj API CartDNA do bezpiecznego uwierzytelniania, tworzenia żądań płatności, kontrolowania wyboru metody płatności i aktualizowania systemów przez przepływy callback. Stworzone dla zespołów potrzebujących elastycznej infrastruktury płatniczej i niezawodnej kontroli backendu.

Co umożliwia API

API CartDNA dostarcza kluczowych akcji niezbędnych do orkiestracji płatności. Możesz żądać tokena dostępu, przesyłać żądania płatności, definiować dane klienta i zamówienia, wybierać obsługiwane metody płatności i otrzymywać aktualizacje statusu przez URL callbacka.

Kluczowe możliwości API

Uwierzytelnianie

Użyj danych uwierzytelniających klienta, aby żądać tokena dostępu, a następnie dołącz go do autoryzowanych żądań.

Tworzenie płatności

Twórz żądania płatności ze szczegółami zamówienia, kwotą, walutą, danymi klienta i wyborem metody płatności.

Kontrole bezpieczeństwa

Chroń każde żądanie walidacją znacznika czasu, kluczami idempotencji i podpisami żądań.

Przepływ przekierowania klienta

Użyj zwróconego URL płatności, aby wysłać klientów do doświadczenia płatniczego.

Aktualizacje oparte na callbackach

Odbieraj aktualizacje płatności w swoim backendzie, aby system zamówień pozostał dokładny.

Zbudowane dla prawdziwych przepływów transakcji

Żądania API CartDNA obsługują typowe akcje transakcji, takie jak tworzenie płatności i przepływy preautoryzacji, w zależności od konfiguracji twojego konta handlowca. Daje to deweloperom elastyczność przy obsłudze bezpośrednich przechwytów, płatności etapowych lub logiki checkout specyficznej dla metody.

Lokalne i globalne wsparcie płatności

Publiczne odniesienie do API pokazuje wsparcie dla kilku metod płatności i walut, w tym kart i wybranych metod lokalnych. Daje to handlowcom większą elastyczność przy sprzedaży na różnych rynkach i pomaga deweloperom budować doświadczenia płatnicze odpowiadające oczekiwaniom klientów.

Przykłady:

  • Karty dla szerokiego globalnego zasięgu
  • Bancontact dla Belgii
  • Boleto i Pix dla Brazylii
  • Klarna dla wybranych rynków międzynarodowych
  • Przelewy24 dla Polski

Bezpieczeństwo jest priorytetem

CartDNA używa warstwowej ochrony żądań. Tokeny kontrolują dostęp do API. Znaczniki czasu pomagają ograniczyć problemy z powtórzeniami. Klucze idempotencji zmniejszają przypadkowe duplikaty. Podpisy chronią krytyczne pola płatności przed manipulacją. Ta struktura jest praktyczna dla systemów produkcyjnych, gdzie ważna jest niezawodność płatności.

Planuj na przewidywalne stany awarii

Twoja integracja powinna obsługiwać typowe przypadki awarii API, takie jak nieprawidłowe tokeny, wygasłe żądania, duplikaty żądań i nieprawidłowe podpisy. Buduj czytelne mechanizmy ponowień tam gdzie bezpiecznie, rejestruj kontekst żądań i pokazuj użyteczne wewnętrzne komunikaty błędów zespołom wsparcia.

Jak budować czysto

Trzymaj wszystkie sekrety po stronie serwera

Używaj kluczy idempotencji UUID

Standaryzuj formaty ID zamówień

Rejestruj dostarczenia callbacków

Uzgadniaj wyniki przekierowań z ostatecznym statusem backendu

Oddziel dane uwierzytelniające sandbox i produkcyjne

Testuj generowanie podpisów na stałych przykładach payloadów

Potrzebujesz szczegółów na poziomie endpointu?

Dla dokładnych nagłówków, przykładów żądań, pól payloadów i formatów odpowiedzi użyj pełnej dokumentacji API CartDNA.

Przejdź do dokumentacji API