Pagos recurrentes (MIT)

Los pagos recurrentes te permiten cobrar a los clientes de forma programada sin su participacion activa. Este es un flujo de transaccion iniciada por el comerciante (MIT).

Como funciona

El flujo recurrente tiene dos fases:

Primer pago — El cliente se autentica y paga, otorgando permiso para cobros futuros
Pagos posteriores — Cobras a la tarjeta almacenada del cliente sin su interaccion

Fase 1: Primer pago

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

Tipos de programacion

Tipo	Descripcion
`scheduled`	Programacion fija (ej., suscripcion mensual)
`unscheduled`	Frecuencia variable (ej., recarga cuando el saldo es bajo)

Despues de un pago exitoso, almacena el vault_token y/o first_transaction_id de la respuesta.

Fase 2: Pago recurrente posterior

Cobra al cliente usando el token almacenado:

POST /v1/orders/

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

Los pagos recurrentes no devuelven un payment_url en la respuesta, ya que no se requiere interaccion del cliente. El pago se procesa de inmediato.

Puedes usar tanto vault_token como first_transaction_id para referenciar la tarjeta almacenada.

Validez del token

Los tokens recurrentes tienen una validez maxima de 1 ano. Tras su expiracion, debes iniciar un nuevo primer pago para obtener un token nuevo.

Asegurate de que tu sistema gestione la expiracion de tokens de forma adecuada. Configura un proceso para reautenticar a los clientes antes de que sus tokens expiren.

Recurrente vs. Un clic

Caracteristica	Recurrente (MIT)	Un clic (CIT)
Iniciado por	Comerciante	Cliente
Cliente presente	No	Si
Caso de uso	Suscripciones, facturacion programada	Pago rapido para clientes recurrentes
`schedule_type` obligatorio	Si	No
`payment_url` devuelto	No	Si

Endpoints relacionados

Crear pedido — usa recurring_type y schedule_type en la transaccion para configurar o cobrar pagos recurrentes