Cost+Docs

Ħlasijiet Rikorrenti (MIT)

Issettja ħlasijiet rikorrenti inizjati mill-kummerċjant u abbonamenti

Il-ħlasijiet rikorrenti jippermettulek iċċarġja lill-klijenti fuq skeda mingħajr il-parteċipazzjoni attiva tagħhom. Dan huwa flusso ta' Merchant Initiated Transaction (MIT).

Kif Taħdem

Il-flusso rikorrenti għandu żewġ fażijiet:

  1. L-ewwel ħlas — Il-klijent jawtentika u jħallas, u jagħti permess għal ħlasijiet futuri
  2. Ħlasijiet sussegwenti — Iċċarġja l-karta maħżuna tal-klijent mingħajr l-interazzjoni tagħhom

Fażi 1: L-Ewwel Ħlas

Oħloq ordni b'recurring_type: "first" u 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"
    }
  ]
}

Tipi ta' Skeda

TipDeskrizzjoni
scheduledSkeda fissa (eż., abbonament ta' kull xahar)
unscheduledĦin varjabbli (eż., top-up meta l-bilanċ ikun baxx)

Wara ħlas li rnexxielu, aħżen il-vault_token u/jew first_transaction_id mir-risposta.

Fażi 2: Ħlas Rikorrenti Sussegwenti

Iċċarġja lill-klijent bl-użu tat-token maħżun:

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

Il-ħlasijiet rikorrenti ma jirritornawx payment_url fir-risposta peress li l-ebda interazzjoni tal-klijent mhix meħtieġa. Il-ħlas jiġi pproċessat immedjatament.

Tista' tuża jew vault_token jew first_transaction_id biex tirreferi għall-karta maħżuna.

Validità tat-Token

It-tokens rikorrenti għandhom validità massima ta' sena. Wara l-iskadenza, trid tibda ħlas ġdid biex tikseb token frisk.

Kun żgur li s-sistema tiegħek tittratta l-iskadenza tat-token b'mod graċjuż. Issettja proċess biex terġa tawtentika l-klijenti qabel ma t-tokens tagħhom jiskadu.

Rikorrenti vs Klikk Waħda

KaratteristikaRikorrenti (MIT)Klikk Waħda (CIT)
Inizjat minnKummerċjantKlijent
Klijent preżentiLeIva
Każ ta' użuAbbonamenti, fatturazzjoni skedataCheckout malajr għal klijenti li jerġgħu jiġu
schedule_type meħtieġIvaLe
payment_url rritornatLeIva

Endpoints Relatati

  • Oħloq Ordni — uża recurring_type u schedule_type fit-tranżazzjoni biex tissettja jew iċċarġja ħlasijiet rikorrenti

On this page