Puedes aplicar un cupón de descuento a un checkout creado por API usando el parámetro discount_code al crear o actualizar el checkout. Solo necesitas enviar el código del cupón y Recurrente calcula automáticamente el descuento.
Crear un checkout con descuento
Al crear un checkout por API, incluye el campo discount_code en el cuerpo de la petición:
POST /api/checkouts{ "items": [{ "name": "Producto", "currency": "GTQ", "amount_in_cents": 10000, "charge_type": "one_time" }], "discount_code": "WELCOME10"}
Si el código es válido, el checkout se crea con el descuento aplicado. Si el código no existe o no es válido, la petición retorna error 400 Bad Request.
Actualizar un checkout existente con descuento
También puedes aplicar un descuento a un checkout ya creado usando PATCH:
PATCH /api/checkouts/{checkout_id}{ "discount_code": "WELCOME10"}
El descuento se recalcula y la respuesta incluye los datos actualizados.
Datos del descuento en la respuesta
Cuando un checkout tiene descuento, la respuesta del API incluye estos campos adicionales:
subtotal_in_cents — Monto original antes del descuento (en centavos).
total_in_cents — Monto final después del descuento (en centavos).
discount — Objeto con el detalle del descuento aplicado:
amount_in_cents — Monto del descuento en centavos.
coupon — Datos del cupón aplicado.
Si el checkout no tiene descuento, el campo discount es null y subtotal_in_cents es igual a total_in_cents.
Ejemplo de respuesta
{ "id": "chk_abc123", "status": "pending", "subtotal_in_cents": 10000, "total_in_cents": 9000, "discount": { "amount_in_cents": 1000, "coupon": { ... } }, "currency": "GTQ"}
Importante: El cupón debe estar creado y activo en tu cuenta de Recurrente antes de usarlo en el API. Puedes crear cupones desde la sección de Cupones en tu panel. No puedes aplicar un discount_code a un checkout que ya fue pagado.
¿Necesitas más ayuda? Contacta a soporte por correo [email protected] o escríbenos por WhatsApp.