Cost+Docs

Opakujuce sa platby (MIT)

Nastavenie opakujucich sa platieb a predplatnych iniciovaných obchodnikom

Opakujuce sa platby vam umoznuju ucastovat zakaznikov podla planu bez ich aktivnej ucasti. Ide o proces Merchant Initiated Transaction (MIT).

Ako to funguje

Proces opakujucich sa platieb ma dve fazy:

  1. Prva platba -- Zakaznik sa autentifikuje a zaplati, cim udeli povolenie pre buduci ucastovania
  2. Nasledne platby -- Ucastujete ulozenou kartu zakaznika bez jeho interakcie

Faza 1: Prva platba

Vytvorte objednavku 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 planu

TypPopis
scheduledFixny plan (napr. mesacne predplatne)
unscheduledVariabilne casovanie (napr. dobitie pri nizkom zostatku)

Po uspesnej platbe ulozte vault_token a/alebo first_transaction_id z odpovede.

Faza 2: Nasledna opakujuca sa platba

Ucastite zakaznika pomocou ulozeneho 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}"
    }
  ]
}

Opakujuce sa platby nevracaju payment_url v odpovedi, pretoze interakcia zakaznika nie je potrebna. Platba sa spracuje okamzite.

Na referencovanie ulozenej karty mozete pouzit bud vault_token alebo first_transaction_id.

Platnost tokenu

Tokeny pre opakujuce sa platby maju maximalnu platnost 1 rok. Po exspiracii musite inicializovat novu prvu platbu na ziskanie noveho tokenu.

Uistite sa, ze vas system elegantne spracuvava exspiraciu tokenov. Nastavte proces na opätovnu autentifikaciu zakaznikov pred exspiraciou ich tokenov.

Opakujuce sa platby vs. platby jednym klikom

VlastnostOpakujuce sa (MIT)Jednym klikom (CIT)
IniciovaneObchodnikomZakaznikom
Zakaznik pritomnyNieAno
PouzitiePredplatne, planovane fakturovanieRychla pokladna pre vracajucich sa zakaznikov
schedule_type povinnyAnoNie
payment_url v odpovediNieAno

Suvisiace endpointy

  • Vytvorenie objednavky -- pouzite recurring_type a schedule_type v transakcii na nastavenie alebo ucastenie opakujucich sa platieb

On this page