DLA PROGRAMISTÓW

Czytelny model. Świadome wdrożenie.

Poznaj koncepcję integracji MatPay. To założenia techniczne i przykładowe dane, a nie dokumentacja działającego API.

Publiczne API, sandbox, klucze, SDK i webhooki nie są jeszcze udostępnione. Nie wysyłaj żądań na niepotwierdzone adresy.

Model płatności

Kwoty w przykładach zapisujemy w groszach. Identyfikatory, statusy i struktura zdarzenia są poglądowe — kontrakt produkcyjny będzie wymagał osobnego ustalenia.

{
  "id": "demo_payment_1048",
  "amount": 24900,
  "currency": "PLN",
  "order_id": "DEMO-1048",
  "status": "pending",
  "mode": "demo"
}

Przykład koncepcyjny · nieaktywne API

Co wymaga wdrożenia?

Autoryzacja i sekrety
Klucze wyłącznie po stronie serwera, podział środowisk i kontrola uprawnień.
Idempotencja
Ponowne żądanie nie powinno tworzyć drugiej płatności dla tej samej operacji.
Weryfikacja zdarzeń
Podpis, identyfikator, kwota i waluta muszą być sprawdzone przed zmianą statusu zamówienia.
Bezpieczne dane płatnicze
Formularz i tokenizacja po stronie uprawnionego dostawcy. Demo MatPay nie przyjmuje rzeczywistych danych karty.
Obsługa błędów
Ponowienia, wygasanie sesji, uzgodnienie statusu i monitoring wymagają wdrożenia i testów.

Przykładowe stany

Oczekująca

OpłaconaNieudanaWygasła

Zwrot jest osobną operacją po udanej płatności. Panel demonstracyjny umożliwia zmianę przykładowego statusu na „Zwrócona”.

Sprawdź scenariusze w demo