LunaPay® · Documentación

De tu primer cobro a una integración propia.

Descargar OpenAPI 3.1

Revisado el 19/09/2026

Suscripciones y cuotas

Una suscripción crea ciclos. Una compra en cuotas sigue siendo una sola venta.

Ejemplos para ejecutar en tu servidor con datos propios de sandbox. Las claves nunca se incluyen en el frontend. Esta documentación no habilita operaciones live.

Automática o manual

automatic_recurring necesita cuenta y mandato válido. manual_renewal genera una nueva solicitud que el comprador paga cada período. No se presume que una wallet o una transferencia admita débito automático.

Ejemplo de servidor
curl "https://payments.lunapay.ar/v1/subscriptions" \
  -H "Authorization: Bearer $LUNAPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sandbox-subscription-00001" \
  -d '{
  "customerId": "CUSTOMER_UUID",
  "priceId": "RECURRING_PRICE_UUID",
  "contractId": "CONTRACT_UUID",
  "accountId": "ACCOUNT_UUID",
  "mode": "automatic_recurring",
  "termsVersion": "ACCEPTED_VERSION",
  "consent": true
}'

Prueba y cancelación

El trial se configura en el precio recurrente. Un mes gratis termina en la misma fecha del mes siguiente, ajustando al último día válido. Sin mandato no se promete cobro automático. La cancelación del mandato es asíncrona; verificá su estado.

Ejemplo de servidor
curl "https://payments.lunapay.ar/v1/subscriptions/SUBSCRIPTION_UUID/cancel" \
  -H "Authorization: Bearer $LUNAPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sandbox-cancel-00001" \
  -d '{}'

Tres cuotas Payway

Disponible solo para operaciones ARS y tarjetas de crédito locales elegibles, con campaña y cuenta habilitadas para el canal. Se procesa el total con tres cuotas; no se crean tres suscripciones. Sin adhesión verificada no se ofrece en live.

Contrato de desarrollo · fuente: Payments · 9f82d06

Siguiente guíaFacturación y emisor