Authorize.Net

Czego potrzebujesz

API Login ID i Transaction Key zawsze idą razem. Signature Key jest niezależny.

Dlaczego prosimy o każde pole

API Login ID

Nazywa Twoje konto przy wywołaniach API. Działa tylko w parze z Transaction Key.

Transaction Key

Sekret, który dowodzi, że żądanie API jest Twoje. Razem z API Login ID pozwala nam zbudować hostowany formularz płatności, by obciążenie przeszło przez Twoje konto.

Signature Key

Dowodzi, że przychodzący webhook naprawdę pochodzi od Authorize.Net, by nikt nie mógł sfałszować zdarzenia "opłacono". To wartość odrębna od Transaction Key.

Success URL i Cancel URL

Zwykłe ustawienia: gdzie trafia kupujący po zapłacie lub rezygnacji. Nie są tajne.

Konfiguracja

1. Utwórz darmowe konto sandbox (bez płatności)

   Nie potrzebujesz płatnego konta akceptanta, by testować. Authorize.Net oferuje darmowy sandbox, który odzwierciedla produkcję, bez wymaganej karty kredytowej.

   1. Przejdź na developer.authorize.net/hello_world/sandbox.html i zarejestruj konto sandbox. Użyj tego linku, a nie głównej rejestracji ani strony cennika (to płatne zgłoszenie live).
   2. Zaloguj się do interfejsu Merchant Interface sandboxa na sandbox.authorize.net.

   Schemat podpisu jest identyczny jak w produkcji, więc cokolwiek zweryfikujesz w sandboxie, zachowa się tak samo na żywo.

2. Skopiuj swoje trzy poświadczenia

   Ta sama ścieżka w sandboxie i live: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.

   • API Login ID jest pokazany na górze.
   • Transaction Key: wybierz "New Transaction Key", potwierdź i skopiuj go natychmiast (jest pokazywany raz).
   • Signature Key: wybierz "New Signature Key", potwierdź i skopiuj go od razu.

   ⤢
3. Dodaj webhook
   1. Account → Settings → Business Settings → Webhooks, dodaj endpoint.
   2. Ustaw adres URL endpointu na adres webhooka Twojego projektu (poniżej).
   3. Subskrybuj zdarzenia. Płatności jednorazowe: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created oraz zdarzenia fraud.* (held, approved, declined). Subskrypcje (Automated Recurring Billing): zdarzenia net.authorize.customer.subscription.*. Odnowienia przychodzą jako authcapture.created, już objęte. Dodatkowe zdarzenia są nieszkodliwe.
   4. Zapisz. Authorize.Net podpisuje każdą dostawę Twoim Signature Key.

   https://api.coinmoebius.com/webhook/authorizenet/<your project id>

   ⤢

   Coin Moebius zapisuje każdy identyfikator zdarzenia raz i ignoruje duplikaty, więc powtórnie odtworzone webhooki są obsłużone za Ciebie.

4. Testuj kartami sandbox

   Karty sandbox nigdy nie obciążają prawdziwej karty. Użyj dowolnej przyszłej daty ważności (na przykład 12/2030) i dowolnego CVV (3 cyfry lub 4 dla American Express).

   Sieć	Karta
   Visa	4111111111111111
   Mastercard	5424000000000015
   American Express	370000000000002
   Discover	6011000000000012

5. Podłącz w panelu

   Add provider → Authorize.Net. Wpisz Success URL, Cancel URL oraz grupę Live (API Login ID, Transaction Key, Signature Key). Dodaj opcjonalną grupę Sandbox, by testować. Grupa Sandbox działa na zasadzie wszystko albo nic: wszystkie trzy pola albo żadne. Live i sandbox sprawdzane są osobno.

Po podłączeniu

Wykonaj jedną płatność testową przed wejściem na żywo:

1. Utwórz produkt i ustaw jego Environment na Testing. To uruchamia produkt na Twoich poświadczeniach sandbox, więc możesz złożyć pełne zamówienie bez przepływu pieniędzy. (Jeśli pominąłeś zestaw sandbox, produkt Testing wraca do live, więc najpierw go dodaj.)
2. Umieść przycisk kupna na stronie (wystarczy lokalny plik HTML) wskazującej na Twój projekt.
3. Dokończ checkout testową kartą sandbox z powyższej listy.
4. Otwórz zakładkę Transactions. Pojawi się nowy wiersz z etykietą Testing. Gdy jego status osiągnie succeeded, Twoje poświadczenia i webhook działają od początku do końca.

Przełącz Environment produktu na Live, gdy będziesz gotowy na prawdziwe płatności.

Rozwiązywanie problemów

Zacznij od Verify. W panelu kliknij Verify (lub Verify test credentials dla zestawu sandbox), by sprawdzić API Login ID i Transaction Key.

Verify się nie udaje.

API Login ID i Transaction Key muszą być parą z tego samego konta (live lub sandbox). Skopiuj oba ponownie.

Weryfikacja podpisu się nie udaje.

Signature Key to wartość inna niż Transaction Key. Skopiuj Signature Key z tego samego ekranu. Schemat jest identyczny w sandboxie i live.

Płatność się kończy, ale zamówienie pozostaje pending.

Potwierdź, że adres URL webhooka zgadza się dokładnie i że subskrybowałeś zdarzenia płatności.

Produkt testowy obciążył prawdziwą kartę.

Produkt oznaczony jako testowy wraca do Twoich poświadczeń live, gdy nie skonfigurowano kompletnego zestawu sandbox. Dodaj wszystkie trzy pola sandbox albo odznacz produkt jako testowy.

Potwierdź od początku do końca.

Authorize.Net pinguje tylko nieaktywne webhooki: ustaw endpoint jako nieaktywny, wyślij ping, a potem aktywuj go ponownie i obserwuj aktualizację zamówienia.

Warto wiedzieć

Tokeny są krótkotrwałe. Token hostowanego formularza ważny jest około 15 minut. Generujemy świeży przy każdym checkoucie.

Waluta. Authorize.Net to przede wszystkim bramka USA, USD. Waluty inne niż USD zależą od Twojej umowy z procesorem.

Rotacja kluczy. Wygeneruj nowy Transaction Key lub Signature Key kiedy chcesz, a potem wklej go. Pola tajne pozostają puste przy edycji.

Pytania? Join our Discord