Opakované platby (MIT)

Opakované platby umožňují účtovat zákazníkům podle plánu bez jejich aktivní účasti. Jedná se o tok Merchant Initiated Transaction (MIT).

Jak to funguje

Tok opakovaných plateb má dvě fáze:

První platba — Zákazník se autentizuje a zaplatí, čímž udělí souhlas s budoucími platbami
Následné platby — Účtujete z uložené karty zákazníka bez jeho interakce

Fáze 1: První platba

Vytvořte objednávku s recurring_type: "first" a 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 plánování

Typ	Popis
`scheduled`	Pevný rozvrh (např. měsíční předplatné)
`unscheduled`	Proměnlivé časování (např. dobití při nízkém zůstatku)

Po úspěšné platbě uložte vault_token a/nebo first_transaction_id z odpovědi.

Fáze 2: Následná opakovaná platba

Účtujte zákazníkovi pomocí uloženého tokenu:

POST /v1/orders/

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

Opakované platby nevracejí payment_url v odpovědi, protože není potřeba žádná interakce zákazníka. Platba je zpracována okamžitě.

K odkazování na uloženou kartu můžete použít buď vault_token, nebo first_transaction_id.

Platnost tokenu

Tokeny pro opakované platby mají maximální platnost 1 rok. Po vypršení musíte zahájit novou první platbu pro získání nového tokenu.

Ujistěte se, že váš systém zpracovává vypršení tokenu elegantně. Nastavte proces pro opětovnou autentizaci zákazníků před vypršením jejich tokenů.

Opakované platby vs. platby jedním kliknutím

Vlastnost	Opakované (MIT)	Jedním kliknutím (CIT)
Iniciováno	Obchodníkem	Zákazníkem
Zákazník přítomen	Ne	Ano
Případ použití	Předplatné, plánované fakturování	Rychlý checkout pro vracející se zákazníky
Vyžadován `schedule_type`	Ano	Ne
Vrácen `payment_url`	Ne	Ano

Související endpointy

Vytvoření objednávky — použijte recurring_type a schedule_type v transakci pro nastavení nebo účtování opakovaných plateb