Cost+Docs

Plăți recurente (MIT)

Configurați plăți recurente inițiate de comerciant și abonamente

Plățile recurente vă permit să taxați clienții conform unui program fără participarea lor activă. Acesta este un flux de Tranzacție Inițiată de Comerciant (MIT).

Cum funcționează

Fluxul recurent are două faze:

  1. Prima plată — Clientul se autentifică și plătește, acordând permisiunea pentru taxări viitoare
  2. Plățile ulterioare — Taxați cardul stocat al clientului fără interacțiunea acestuia

Faza 1: Prima plată

Creați o comandă cu recurring_type: "first" și un 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"
    }
  ]
}

Tipuri de programare

TipDescriere
scheduledProgram fix (de ex., abonament lunar)
unscheduledMoment variabil (de ex., reîncărcare când soldul este scăzut)

După o plată reușită, stocați vault_token și/sau first_transaction_id din răspuns.

Faza 2: Plata recurentă ulterioară

Taxați clientul folosind tokenul stocat:

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

Plățile recurente nu returnează un payment_url în răspuns deoarece nu este necesară interacțiunea clientului. Plata este procesată imediat.

Puteți folosi fie vault_token, fie first_transaction_id pentru a referenția cardul stocat.

Valabilitatea tokenului

Tokenurile recurente au o valabilitate maximă de 1 an. După expirare, trebuie să inițiați o primă plată nouă pentru a obține un token proaspăt.

Asigurați-vă că sistemul dvs. gestionează expirarea tokenurilor în mod corespunzător. Configurați un proces de re-autentificare a clienților înainte ca tokenurile lor să expire.

Recurent vs. Un click

CaracteristicăRecurent (MIT)Un click (CIT)
Inițiat deComerciantClient
Clientul prezentNuDa
Caz de utilizareAbonamente, facturare programatăCheckout rapid pentru clienții care revin
schedule_type necesarDaNu
payment_url returnatNuDa

Endpoint-uri asociate

  • Creare comandă — folosiți recurring_type și schedule_type în tranzacție pentru a configura sau taxa plăți recurente

On this page