IOPAY→Developers→Dane uwierzytelniające
Setup & uwierzytelnianie

Dane uwierzytelniające

Jak uzyskać, przechowywać i stosować dane uwierzytelniające używane w integracjach płatności online IOPAY.

PolaEmail · IO Seller ID · Secret · Antifraud ID
Gdzie wygenerowaćSprzedaż → Płatności online
UwierzytelnianieBearer token
Jak uzyskać Zobacz dane uwierzytelniające Base API →
Przegląd

Przegląd

Dane uwierzytelniające umożliwiają integracje płatności online. Secret musi pozostać w backendzie, z dala od repozytoriów i publicznych interfejsów.

Bezpieczeństwo

Secret jest poufny.

Secret może znajdować się wyłącznie w backendzie i w odpowiednich sejfach na sekrety.

Rotacja

Ponowne wygenerowanie unieważnia poprzedni klucz.

Zaplanuj zmianę Secretu, aby uniknąć niedostępności podczas rotacji.

Jak uzyskać

Jak uzyskać

  1. Wejdź do Konta Cyfrowego IO.
  2. Przejdź do Sprzedaż → Płatności online.
  3. Włącz płatności online, jeśli dotyczy to rejestracji.
  4. Wygeneruj dane uwierzytelniające i przechowuj wartości w bezpiecznym środowisku.
  5. Skonfiguruj metody płatności, a na koniec opcje integracji checkoutu.
Secret. Secret jest wyświetlany tylko w chwili wygenerowania. Jeśli wygenerujesz nowy, poprzedni klucz zostanie unieważniony.
Dane uwierzytelniające integracji

Pola

KluczFunkcjaUwaga
emailIdentyfikacja powiązana z integracją.Wysyłany podczas uwierzytelniania.
io_seller_idIdentyfikator sellera/konta w kontekście IOPAY.Wysyłany podczas uwierzytelniania i używany w kontekście operacji.
secretSekret uwierzytelniania.Wysyłany podczas uwierzytelniania. Nigdy nie ujawniaj go we frontendzie.
antifraud_idIdentyfikator związany z planem antyfraud.Niewymagany, gdy konto nie ma aktywnego planu antyfraud.

Uwierzytelnij integrację

Wyślij email, secret i io_seller_id, aby uzyskać token używany w kolejnych wywołaniach API.

POST /auth/login
curl --request POST \
  --url https://api.iopay.com.br/api/auth/login \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "your_email",
    "secret": "your_secret",
    "io_seller_id": "<IO_SELLER_ID>"
  }'

Odpowiedź

Access token
{
  "access_token": "<ACCESS_TOKEN>",
  "token_type": "bearer",
  "token_scope": "transaction",
  "expires_in": 3600
}
Bearer Token. Używaj zwróconego access_token jako Authorization: Bearer your_token w kolejnych wywołaniach API.
Dodatkowa konfiguracja

Konfiguracja

Po uzyskaniu danych uwierzytelniających konfiguracja płatności online może obejmować Kredyt, Pix i Boleto, liczbę rat i parametry checkoutu.

Webhook

URL powiadomień.

Podaj URL HTTPS do odbierania powiadomień z operacji.

Domena

Ograniczenie HTTPS.

Ogranicz integracje do oczekiwanej domeny, gdy wymaga tego konfiguracja.

Branding

URL logo.

Powiąż URL logo HTTP/HTTPS z kompatybilnymi integracjami.

Dobre praktyki

Dobre praktyki

  • Przechowuj sekrety w zmiennych środowiskowych lub menedżerach sekretów.
  • Nie wysyłaj Secretu w JavaScripcie wykonywanym w przeglądarce.
  • Oddziel sandbox/testy od produkcji.
  • Zaplanuj rotację kluczy bez przerywania przetwarzania.
  • Rejestruj, kto zmieniał dane uwierzytelniające w środowiskach wewnętrznych.