Saltar al contenido

Pagos recurrentes

Mantén los pagos recurrentes ligados a la relación con tus clientes

Crea y gestiona suscripciones con tarjeta, monitorea su estado y recupera los cobros fallidos con reintentos configurables. Disponibles hoy en Colombia, México y Perú; para otros mercados, nuestro equipo define contigo un flujo recurrente con métodos de pago locales.

Contactar a ventasDocumentación de suscripciones
  • Cobro programado o bajo demanda
  • Reintentos configurables
  • Cada renovación trazable
Disponibles hoy · otros mercados a pedido
CO · MX · PE
Cobros programados y bajo demanda
2 modelos
Intentos e intervalos configurables
Reintentos
En cada cobro
Webhook

Suscripciones con tarjeta

Suscripciones con reintentos configurables

Todo lo necesario para cobrar según un calendario, recuperar cobros fallidos y mantener tus sistemas sincronizados.

  • Programado o bajo demanda

    Cobra con un calendario fijo a partir de un plan, o bajo demanda cuando el uso o un evento lo requieran.

  • Reintentos configurables

    Define cuántas veces reintentar un cobro fallido y el intervalo entre intentos, según tu modelo de cobro.

  • Estado de pago claro

    Si fallan todos los reintentos, la suscripción queda marcada para que tu equipo pueda dar el siguiente paso.

  • Cada cobro es trazable

    Cada renovación se registra como una transacción individual, con su propio estado, webhook y datos de reporte.

  • API de planes

    Crea, actualiza y consulta planes con montos e intervalos de cobro predefinidos.

  • Control total

    Actualiza el monto, la frecuencia o los datos del pagador, cambia de plan o cancela una suscripción por API.

Flujo del dinero

Cómo se ejecuta el cobro de una suscripción

La tarjeta se tokeniza una vez; cada renovación se cobra automáticamente, con reintentos configurables.

  1. 1

    ClienteTu plataforma:

    Se suscribe con tarjeta

    Localpayment tokeniza los datos de la tarjeta una sola vez para su uso recurrente.

  2. 2

    Tu plataformaLocalpayment:

    Crea la suscripción

    Plan, monto y ciclo de cobro vinculados al token.

  3. 3

    LocalpaymentRiel local / banco:

    Cobra en cada ciclo

    Adquirencia local, para que el emisor vea una transacción doméstica.

  4. 4

    Riel local / bancoLocalpayment:

    Aprobada o rechazada

    Los rechazos se reintentan según el calendario que configures.

  5. 5

    LocalpaymentTu plataforma:

    Webhook por cobro

    Tu plataforma extiende o pausa el acceso según el resultado.

Flujo ilustrativo. Las suscripciones con tarjeta están disponibles en Colombia, México y Perú; consulta las páginas de país.

Cómo funciona

Así funciona una suscripción

  1. 01

    Crea

    Elige un plan fijo o un monto y una frecuencia personalizados, y envía POST /api/payin/subscriptions con el token de la tarjeta. Recibes el ID de la suscripción.

  2. 02

    Renueva

    Cada ciclo se cobra automáticamente, o bajo demanda. Los cobros fallidos se reintentan según tu configuración y los webhooks informan cada resultado.

  3. 03

    Gestiona

    Actualiza el monto, la frecuencia o los datos del pagador, cambia de plan o cancela por API, y sigue cada cambio por webhook.

Especificaciones

Pagos recurrentes de un vistazo

  • Suscripciones con tarjeta

    Cómo funciona
    Disponibles en Colombia, México y Perú
    Detalles
    Cobro programado o bajo demanda con tarjetas tokenizadas

  • Planes

    Cómo funciona
    Crea y gestiona planes a través de la API
    Detalles
    Define monto, moneda y frecuencia de cobro

  • Reintentos

    Cómo funciona
    Configura reglas de reintento para pagos fallidos
    Detalles
    Define la cantidad de intentos y el intervalo entre ellos

  • Gestión de suscripciones

    Cómo funciona
    Actualiza o cancela suscripciones a través de la API
    Detalles
    Gestiona monto, frecuencia, datos del pagador o cambios de plan

  • Reportes

    Cómo funciona
    Sigue cada renovación como una transacción individual
    Detalles
    Monitorea el estado con webhooks y reportes

  • Límites y precios

    Cómo funciona
    Definidos por mercado y medio de pago
    Detalles
    Contacta a nuestro equipo para más detalles

Las suscripciones con tarjeta están disponibles actualmente en Colombia, México y Perú. Las funcionalidades específicas y las condiciones comerciales se confirman durante el onboarding.

Operaciones

Renovaciones que finanzas puede rastrear

Como cada renovación se registra como una transacción individual, las suscripciones con tarjeta se concilian igual que los pagos únicos: mismos identificadores, mismos webhooks, mismos reportes.

  • Tu externalId y nuestro internalId en cada cobro
  • Webhooks firmados con HMAC-SHA256 para cobros, fallos y cambios
  • Gestión de contracargos de suscripciones
  • Reportes del Business Portal con exportación a XLS

Para desarrolladores

Crea una suscripción con una sola llamada

Envía el plan, el token de la tarjeta y tu política de reintentos. Localpayment ejecuta cada cobro a partir de ahí y te informa por webhook.

  • Planes fijos (planId) o montos y frecuencias personalizados
  • retry.repetitions, retry.intervalValue y retry.intervalUnit
  • Actualiza o cancela por API en cualquier momento
Documentación de suscripciones
# Ilustrativo: campos simplificados; ver docs.localpayment.com para el contrato completo
curl -X POST https://api.stage.localpayment.com/api/payin/subscriptions \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": { "type": "CreditCard", "code": "1900", "flow": "DIRECT" },
    "externalId": "5d7c2a90-0000-4000-8000-000000000031",
    "country": "COL",
    "currency": "COP",
    "planId": "<your-plan-id>",
    "accountNumber": "<your-account-number>",
    "conceptCode": "0001",
    "merchant": { "type": "COMPANY", "name": "Comercio Ejemplo S.A.S." },
    "payer": {
      "type": "INDIVIDUAL",
      "name": "Andrés",
      "lastname": "Gómez",
      "document": { "type": "CC", "id": "1000000000" },
      "email": "andres.gomez@example.com"
    },
    "card": { "token": "<card-token>" },
    "retry": { "repetitions": 3, "intervalValue": 1, "intervalUnit": "day" }
  }'

Casos de uso

Pensado para negocios que cobran una y otra vez

Preguntas frecuentes

¿Dónde están disponibles las suscripciones con tarjeta?

En Colombia, México y Perú, con modelos programados y bajo demanda.

¿Qué pasa cuando falla una renovación?

Reintentamos según las reglas que configures. Si fallan todos los reintentos, la suscripción queda marcada y no se intentan más cobros automáticos, para que tu equipo pueda dar el siguiente paso.

¿Puedo modificar una suscripción después de iniciada?

Sí. Puedes actualizar el monto, la frecuencia o los datos del pagador, cambiar de plan o cancelar por API.

¿Las renovaciones aparecen en mis reportes?

Sí. Cada renovación se registra como una transacción individual, así que aparece en tus reportes y webhooks como cualquier otro pago.

¿Puedo cobrar suscripciones con métodos de pago locales?

Las suscripciones con tarjeta funcionan en Colombia, México y Perú. Para otros países, nuestro equipo puede diseñar contigo un flujo recurrente sobre métodos locales.

También en la misma API

Mantén a tus suscriptores renovando

Cuéntanos tu modelo de cobro y los mercados donde vendes: activamos suscripciones con tarjeta o definimos un flujo recurrente con métodos locales.

Contactar a ventasDocumentación de suscripciones

¿Cómo podemos ayudarte?

Descarga tu ejemplar

Déjanos tus datos y obtén la edición completa al instante.