Pagamenti Ricorrenti (MIT)

I pagamenti ricorrenti ti consentono di addebitare i clienti secondo una pianificazione senza la loro partecipazione attiva. Questo è un flusso Merchant Initiated Transaction (MIT).

Come Funziona

Il flusso ricorrente ha due fasi:

Primo pagamento — Il cliente si autentica e paga, concedendo il permesso per addebiti futuri
Pagamenti successivi — Addebiti la carta memorizzata del cliente senza la sua interazione

Fase 1: Primo Pagamento

Crea un ordine con recurring_type: "first" e 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"
    }
  ]
}

Tipi di Pianificazione

Tipo	Descrizione
`scheduled`	Pianificazione fissa (es. abbonamento mensile)
`unscheduled`	Tempistica variabile (es. ricarica quando il saldo è basso)

Dopo un pagamento riuscito, salva il vault_token e/o il first_transaction_id dalla risposta.

Fase 2: Pagamento Ricorrente Successivo

Addebita il cliente utilizzando il token memorizzato:

POST /v1/orders/

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

I pagamenti ricorrenti non restituiscono un payment_url nella risposta poiché non è necessaria l'interazione del cliente. Il pagamento viene elaborato immediatamente.

Puoi usare sia vault_token che first_transaction_id per riferire la carta memorizzata.

Validità del Token

I token ricorrenti hanno una validità massima di 1 anno. Dopo la scadenza, devi avviare un nuovo primo pagamento per ottenere un token aggiornato.

Assicurati che il tuo sistema gestisca la scadenza del token in modo adeguato. Configura un processo per ri-autenticare i clienti prima che i loro token scadano.

Ricorrente vs Un Clic

Caratteristica	Ricorrente (MIT)	Un Clic (CIT)
Iniziato da	Commerciante	Cliente
Cliente presente	No	Sì
Caso d'uso	Abbonamenti, fatturazione programmata	Checkout veloce per clienti di ritorno
`schedule_type` richiesto	Sì	No
`payment_url` restituito	No	Sì

Endpoint Correlati

Crea Ordine — usa recurring_type e schedule_type nella transazione per configurare o addebitare pagamenti ricorrenti