Płatności cykliczne (MIT)

Konfiguracja cyklicznych płatności i subskrypcji inicjowanych przez sprzedawcę

Płatności cykliczne umożliwiają obciążanie klientów według harmonogramu bez ich aktywnego udziału. Jest to przepływ transakcji inicjowanych przez sprzedawcę (MIT).

Jak to działa

Przepływ cykliczny składa się z dwóch faz:

Pierwsza płatność — Klient uwierzytelnia się i płaci, udzielając zgody na przyszłe obciążenia
Kolejne płatności — Obciążasz zapisaną kartę klienta bez jego interakcji

Faza 1: Pierwsza płatność

Utwórz zamówienie z recurring_type: "first" i schedule_type:

POST /v1/orders/

{
  "merchant_order_id": "first-recurring",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "first",
      "schedule_type": "scheduled"
    }
  ]
}

Typy harmonogramu

Typ	Opis
`scheduled`	Stały harmonogram (np. miesięczna subskrypcja)
`unscheduled`	Zmienny czas (np. doładowanie przy niskim saldzie)

Po pomyślnej płatności zapisz vault_token i/lub first_transaction_id z odpowiedzi.

Faza 2: Kolejna płatność cykliczna

Obciąż klienta przy użyciu zapisanego tokena:

POST /v1/orders/

{
  "merchant_order_id": "recurring-order",
  "currency": "EUR",
  "amount": 995,
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "recurring",
      "vault_token": "{vault_token}"
    }
  ]
}

Płatności cykliczne nie zwracają payment_url w odpowiedzi, ponieważ interakcja klienta nie jest potrzebna. Płatność jest przetwarzana natychmiast.

Możesz użyć zarówno vault_token, jak i first_transaction_id, aby odwołać się do zapisanej karty.

Ważność tokena

Tokeny cykliczne mają maksymalną ważność 1 roku. Po wygaśnięciu musisz zainicjować nową pierwszą płatność, aby uzyskać nowy token.

Upewnij się, że Twój system poprawnie obsługuje wygasanie tokenów. Skonfiguruj proces ponownego uwierzytelniania klientów przed wygaśnięciem ich tokenów.

Cykliczne a jednym kliknięciem

Cecha	Cykliczne (MIT)	Jednym kliknięciem (CIT)
Inicjowane przez	Sprzedawcę	Klienta
Klient obecny	Nie	Tak
Zastosowanie	Subskrypcje, zaplanowane obciążenia	Szybka realizacja zamówień dla powracających klientów
Wymagane `schedule_type`	Tak	Nie
Zwracany `payment_url`	Nie	Tak

Powiązane punkty końcowe

Utwórz zamówienie — użyj recurring_type i schedule_type w transakcji, aby skonfigurować lub obciążyć płatności cykliczne