Przejdź do głównej zawartości

Wprowadzenie

Witamy w dokumentacji API Paymentic. Ta dokumentacja zawiera wszystkie informacje potrzebne do integracji z naszym systemem płatności i rozpoczęcia akceptowania płatności online.

Środowiska​

Paymentic udostępnia dwa środowiska do pracy z API:

  • Środowisko produkcyjne: https://api.paymentic.com

    • Przeznaczone do obsługi rzeczywistych transakcji płatniczych
    • Wymaga pełnej weryfikacji konta i podpisania umowy
    • Wszystkie transakcje są prawdziwe i podlegają standardowym opłatom

  • Środowisko sandbox: https://api.sandbox.paymentic.com

    • Przeznaczone do testowania integracji
    • Nie wymaga pełnej weryfikacji konta
    • Wszystkie transakcje są symulowane i nie wiążą się z rzeczywistymi płatnościami
    • Idealne do rozwoju, testowania i debugowania integracji

Zalecamy rozpoczęcie integracji od środowiska sandbox, aby przetestować wszystkie funkcje przed przejściem na środowisko produkcyjne.

Uwierzytelnianie API​

Wszystkie zapytania do API Paymentic muszą być uwierzytelnione przy użyciu tokena Bearer. Token ten jest przekazywany w nagłówku HTTP Authorization w następującym formacie:

Authorization: Bearer YOUR_API_TOKEN

Uzyskiwanie tokenu API​

Dostęp do tokenu API można uzyskać w panelu klienta w zakładce Integracja > Dostęp do API. W tym miejscu znajdziesz swój unikalny klucz API, który jest wymagany do autoryzacji wszystkich zapytań do API Paymentic.

Przykład użycia tokenu​

curl -X POST "https://api.paymentic.com/v1/payment/points/{pointId}/transactions" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "title": "Zamówienie #12345"
  }'

Bezpieczeństwo tokenu​

  • Nigdy nie udostępniaj swojego tokenu API publicznie
  • Nie umieszczaj tokenu w kodzie frontendowym
  • Regularnie rotuj swoje tokeny API dla zwiększenia bezpieczeństwa
  • Każdy token ma określone uprawnienia, które można skonfigurować w panelu klienta

Podstawy API​

Format zapytań​

API Paymentic przyjmuje zapytania w formacie JSON. Wszystkie zapytania powinny zawierać nagłówek Content-Type: application/json.

Format odpowiedzi​

Odpowiedzi z API są również zwracane w formacie JSON. Każda odpowiedź zawiera pole data z właściwymi danymi lub pole error w przypadku wystąpienia błędu.

Przykład udanej odpowiedzi:

{
  "data": {
    "id": "ABCD-123-XYZ-9876",
    "redirectUrl": "https://pay.paymentic.com/ABCD-123-XYZ-9876?token=...",
    "whitelabel": null
  }
}

Kody odpowiedzi HTTP​

API Paymentic używa standardowych kodów odpowiedzi HTTP:

  • 200 OK - Zapytanie zostało przetworzone pomyślnie
  • 201 Created - Zasób został pomyślnie utworzony
  • 400 Bad Request - Nieprawidłowe zapytanie
  • 401 Unauthorized - Brak lub nieprawidłowe uwierzytelnienie
  • 403 Forbidden - Brak uprawnień do wykonania operacji
  • 404 Not Found - Zasób nie został znaleziony
  • 500 Internal Server Error - Błąd serwera

Następne kroki​

Po zapoznaniu się z podstawami API, możesz przejść do bardziej szczegółowych sekcji dokumentacji:

W przypadku pytań lub problemów z integracją, skontaktuj się z naszym zespołem wsparcia technicznego.