La API de Recurrente te permite crear sesiones de compra, manejar tus productos, suscripciones, y clientes, hacer transferencias de dinero entre diferentes cuentas de Recurrente, y mucho más.
\nCrea una cuenta en Recurrente.
\nLa API responde en formato JSON. Cuando retorna un error, el error es enviado en un error key en JSON.
\nPara encontrar tus Llaves de API, dentro de tu cuenta de Recurrente, ve a:
\nConfiguración → Llaves API.
\nPara autenticarte, debes enviar los siguientes headers en cada request:
\nSi tus llaves de API no se están enviando o son inválidas, recibirás un código de respuesta HTTP 401 Unauthorized.
\nExisten dos formas de realizar pruebas: usando el ambiente Sandbox o haciendo pruebas directamente en producción, dependiendo del tipo de validación que necesites.
\nEl ambiente Sandbox permite hacer pagos de prueba sin generar actividad real. Para utilizarlo:
\nUsa tus llaves de ambiente TEST.
\nSimula un pago exitoso con la tarjeta 4242 4242 4242 4242.
\nLos checkouts creados con llaves TEST:
\nMuestran un aviso que dice \"PRUEBA\" en el link de pago.
\nTienen el atributo live_mode = false.
No crean actividad en la cuenta ni afectan el balance.
\nNo disparan webhooks.
\n\n\nEste ambiente es ideal para pruebas durante la integración inicial o desarrollo.
\n
También es posible realizar pruebas en ambiente LIVE con tus llaves de producción. En estos casos:
\nSe recomienda reembolsar los pagos de prueba el mismo día, ya sea desde el panel de Recurrente o mediante la API en /api/refunds.
Los pagos reembolsados el mismo día son reembolsados al 100% del monto.
\n\n\nEsta opción permite validar el flujo completo, incluyendo actividad en cuenta, webhooks y conciliación.
\n
Si estás usando Wordpress, te recomendamos que utilices nuestro plugin.
\nÚnete y pregunta en nuestro Discord.
\nO envíanos un correo a soporte@recurrente.com
\nIncluye los headers de autenticación y un \"body\" vacío, y recibe una respuesta con el nombre de tu cuenta.
\n{}\n\nEnvía un request de prueba para confirmar que tu autenticación está funcionando correctamente.
\n","_postman_id":"a05a2139-ec27-45ea-a7d8-a0558095823c"},{"name":"Checkouts","item":[{"name":"Create a checkout (item details)","id":"178ed22b-e011-4fcd-802a-cadf2d4bac7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"items[][name]","value":"One Ripe Banana","type":"text","description":"El nombre del producto.
\n"},{"key":"items[][currency]","value":"GTQ","type":"text","description":"La moneda a cobrar.
\nPosibles valores son:
\nMonto a cobrar en centavos.
\n"},{"key":"items[][image_url]","value":"https://www.sourcesplash.com/explore/food","type":"text","description":"(Opcional) URL de la imagen del producto.
\n"},{"key":"items[][quantity]","value":"1","type":"text","description":"(Opcional) Cantidad.
\nSi no incluyes una, el default es 1.
\nEl valor mínimo es 1 y el valor máximo es 9.
\n"},{"key":"items[][has_dynamic_pricing]","value":"false","description":"(Opcional) Indica si el producto debe usar precio dinámico. El precio se convierte en el \"monto a recibir\" neto por el comercio. Disponible solo para pagos únicos.
\n","type":"text","uuid":"ec820402-14be-4586-8686-090716bc6509"},{"key":"success_url","value":"https://www.google.com","type":"text","description":"(Opcional) URL a dónde dirigir al comprador después de un pago exitoso.
\n"},{"key":"cancel_url","value":"https://www.amazon.com","description":"(Opcional) URL a dónde dirigir al comprador cuando abandona el checkout.
\n","type":"text"},{"key":"user_id","value":"us_123456","type":"text","description":"(Opcional) ID del usuario a quien pertenece el checkout. Prepopula los campos de información de usuario (Nombre, Email, etc.)
\n"},{"key":"metadata","value":"{}","description":"(Opcional) Puedes utilizar metadata para almacenar información estructurada adicional sobre un producto.
\nPuedes especificar hasta 50 keys, con nombres de hasta 40 caracteres y valores de hasta 500 caracteres.
\n","type":"text"},{"key":"expires_at","value":"","description":"(Opcional) Fecha en la que quieres que el checkout expire, en formato ISO 8601. Por ejemplo: \"2050-05-15T13:45:30Z\"
\n","type":"text","uuid":"570c7209-90ef-43fc-935b-f49e46216d12"}]},"url":"https://app.recurrente.com/api/checkouts/","urlObject":{"protocol":"https","path":["api","checkouts",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"4ad193df-0151-4143-a714-eb3e87d50bd8","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"items\": [\n {\n \"name\": \"One Ripe Banana\",\n \"currency\": \"GTQ\",\n \"amount_in_cents\": 3000,\n \"image_url\": \"https://source.unsplash.com/400x400/?banana\",\n \"quantity\": 1\n }\n ],\n \"success_url\": \"https://www.google.com\",\n \"cancel_url\": \"https://www.amazon.com\",\n \"user_id\": \"us_123456\",\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/checkouts"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_eegw9j5zgqoae3ms\",\n \"checkout_url\": \"https://app.recurrente.com/checkout-session/ch_eegw9j5zgqoae3ms\"\n}"}],"_postman_id":"178ed22b-e011-4fcd-802a-cadf2d4bac7b"},{"name":"Create a checkout (item details: subscription)","id":"8e34ea92-0d2a-4569-9821-453cd72a44a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"}],"body":{"mode":"formdata","formdata":[{"key":"items[][name]","value":"Membersía Gold","type":"text","description":"El nombre de la suscripción.
\n"},{"key":"items[][currency]","value":"GTQ","type":"text","description":"La moneda a cobrar.
\nPosibles valores son:
\nMonto a cobrar en centavos.
\n"},{"key":"items[][image_url]","value":"https://source.unsplash.com/400x400/?banana","type":"text","description":"(Opcional) URL de la imagen del producto.
\n"},{"key":"items[][quantity]","value":"1","type":"text","description":"(Opcional) Cantidad.
\nSi no incluyes una, el default es 1.
\nEl valor mínimo es 1 y el valor máximo es 9.
\n"},{"key":"success_url","value":"https://www.google.com","type":"text","description":"(Opcional) URL a dónde dirigir al comprador después de un pago exitoso.
\n"},{"key":"cancel_url","value":"https://www.amazon.com","description":"(Opcional) URL a dónde dirigir al comprador cuando abandona el checkout.
\n","type":"text"},{"key":"user_id","value":"us_123456","type":"text","description":"(Opcional) ID del usuario a quien pertenece el checkout. Prepopula los campos de información de usuario (Nombre, Email, etc.)
\n"},{"key":"metadata","value":"{}","description":"(Opcional) Puedes utilizar metadata para almacenar información estructurada adicional sobre un producto.
\nPuedes especificar hasta 50 keys, con nombres de hasta 40 caracteres y valores de hasta 500 caracteres.
\n","type":"text"},{"key":"items[][charge_type]","value":"recurring","description":"Tipo de cargo: recurrente
\n","type":"text"},{"key":"items[][billing_interval]","value":"month","description":"Intervalo de tiempo de pago\nOpciones:
\nCantidad de intervalos de pago
\n","type":"text"},{"key":"items[][periods_before_automatic_cancellation]","value":"12","description":"(Opcional) Periodos a cobrar antes de que se cancele automáticamente
\n","type":"text"},{"key":"items[][free_trial_interval]","value":"month","description":"(Opcional) Intervalo de período de prueba\nOpciones:
\n(Opcional) Cantidad de intervalos de período de prueba
\n","type":"text"},{"key":"items[][has_dynamic_pricing]","value":"true","description":"(Opcional) El precio cambia dependiendo del método de pago que elige el cliente — Tú recibes el monto a cobrar completo. Todos los métodos de pago se activan. Funciona solo para pagos únicos.
\n","type":"text"}]},"url":"https://app.recurrente.com/api/checkouts/","urlObject":{"protocol":"https","path":["api","checkouts",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"c7b5abe3-8566-40aa-b33b-b7879e6acefa","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"items\": [\n {\n \"name\": \"Membresia Gold\",\n \"description\": \"Suscripción con un mes de prueba\",\n \"currency\": \"GTQ\",\n \"amount_in_cents\": 5000,\n \"charge_type\": \"recurring\",\n \"image_url\": \"https://source.unsplash.com/400x400/?banana\",\n \"custom_terms_and_conditions\": \"Terminos y condiciones\",\n \"billing_interval_count\": 1,\n \"billing_interval\": \"month\",\n \"periods_before_automatic_cancellation\": 12,\n \"free_trial_interval_count\": 1,\n \"free_trial_interval\": \"month\",\n \"metadata\": {}\n }\n ],\n \"success_url\": \"https://www.google.com\",\n \"cancel_url\": \"https://www.amazon.com\",\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/checkouts"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_eegw9j5zgqoae3ms\",\n \"checkout_url\": \"https://app.recurrente.com/checkout-session/ch_eegw9j5zgqoae3ms\"\n}"}],"_postman_id":"8e34ea92-0d2a-4569-9821-453cd72a44a2"},{"name":"Create a checkout (Product ID)","id":"115b2b4a-96c7-413d-b270-a77d30f99f0d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"items[][product_id]","value":"prod_1234567","type":"text","description":"Crea un producto primero, y luego utiliza el ID del producto.
\n"},{"key":"success_url","value":"https://www.google.com","type":"text","description":"(Opcional) URL a dónde dirigir al comprador después de un pago exitoso.
\n"},{"key":"cancel_url","value":"https://www.amazon.com","description":"(Opcional) URL a dónde dirigir al comprador cuando abandona el checkout.
\n","type":"text"},{"key":"user_id","value":"us_123456","type":"text","description":"(Opcional) ID del usuario a quien pertenece el checkout. Prepopula los campos de información de usuario (Nombre, Email, etc.)
\n"},{"key":"metadata","value":"{}","description":"(Opcional) Puedes utilizar metadata para almacenar información estructurada adicional sobre un producto.
\nPuedes especificar hasta 50 keys, con nombres de hasta 40 caracteres y valores de hasta 500 caracteres.
\n","type":"text"}]},"url":"https://app.recurrente.com/api/checkouts/","urlObject":{"protocol":"https","path":["api","checkouts",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"6c7419e7-32f1-4a79-a7a4-8f5c569cc67d","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"items\": [\n {\n \"product_id\": \"prod_123456\"\n }\n ],\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/checkouts"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_eegw9j5zgqoae3ms\",\n \"checkout_url\": \"https://app.recurrente.com/checkout-session/ch_eegw9j5zgqoae3ms\"\n}"}],"_postman_id":"115b2b4a-96c7-413d-b270-a77d30f99f0d"},{"name":"Update a checkout","id":"bfa6695c-87c1-45a6-9a7a-713a838e3d86","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"success_url","value":"https://www.google.com","type":"text","description":"(Opcional) URL a dónde dirigir al comprador después de un pago exitoso.
\n"},{"key":"cancel_url","value":"https://www.amazon.com","description":"(Opcional) URL a dónde dirigir al comprador cuando abandona el checkout.
\n","type":"text"},{"key":"metadata","value":"{ \"internalID: 123 }","description":"(Opcional) Puedes utilizar metadata para almacenar información estructurada adicional sobre un producto.
\nPuedes especificar hasta 50 keys, con nombres de hasta 40 caracteres y valores de hasta 500 caracteres.
\n","type":"text"},{"key":"expires_at","value":" \"2050-05-15T13:45:30Z\"","description":"(Opcional) Fecha en la que quieres que el checkout expire, en formato ISO 8601. Por ejemplo: \"2050-05-15T13:45:30Z\"
\n","type":"text","uuid":"570c7209-90ef-43fc-935b-f49e46216d12"}]},"url":"https://app.recurrente.com/api/checkouts/{{checkoutId}}","description":"Este endpoint permite actualizar un checkout existente en la plataforma de Recurrente. Solo se permiten ediciones a checkouts que no han sido pagados, en los campos a continuación.
\n","urlObject":{"protocol":"https","path":["api","checkouts","{{checkoutId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"2a54dc6f-fc38-4ef9-9464-9c23665aaac2","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"items\": [\n {\n \"name\": \"One Ripe Banana\",\n \"currency\": \"GTQ\",\n \"amount_in_cents\": 3000,\n \"image_url\": \"https://source.unsplash.com/400x400/?banana\",\n \"quantity\": 1\n }\n ],\n \"success_url\": \"https://www.google.com\",\n \"cancel_url\": \"https://www.amazon.com\",\n \"user_id\": \"us_123456\",\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/checkouts"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_eegw9j5zgqoae3ms\",\n \"status\": \"unpaid\",\n \"payment\": null,\n \"payment_method\": null,\n \"transfer_setups\": [],\n \"metadata\": {\n \"internalID\": 123\n },\n \"expires_at\": \"2050-05-15T13:45:30Z\",\n \"success_url\": \"https://google.com\",\n \"cancel_url\": \"https://amazon.com\",\n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"total_in_cents\": \"500\",\n \"currency\": \"GTQ\",\n \"latest_intent\": { \n \"id\": \"pa_123\", \n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"type\": \"PaymentIntent\", \n data: { \n \"auth_code\": \"123456\" \n } \n }\n}"}],"_postman_id":"bfa6695c-87c1-45a6-9a7a-713a838e3d86"},{"name":"Get a checkout","id":"eba033f6-cc9d-429d-bdfe-2ec4c197c300","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/checkouts/{{checkoutId}}","urlObject":{"protocol":"https","path":["api","checkouts","{{checkoutId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"1a050cef-2fcc-410c-b21b-d67bfc575e7f","name":"No pagado","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"formdata","formdata":[{"key":"items[][name]","value":"One Ripe Banana","type":"text","disabled":true},{"key":"items[][currency]","value":"GTQ","type":"text","disabled":true},{"key":"items[][amount_in_cents]","value":"3000","type":"text","disabled":true},{"key":"items[][image_url]","value":"https://source.unsplash.com/400x400/?banana","type":"text","disabled":true},{"key":"items[][quantity]","value":"1","type":"text","disabled":true},{"key":"mode","value":"setup","type":"text"}]},"url":"https://app.recurrente.com/api/checkouts/{{checkoutId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_eegw9j5zgqoae3ms\",\n \"status\": \"unpaid\",\n \"payment\": null,\n \"payment_method\": null,\n \"transfer_setups\": [],\n \"metadata\": {},\n \"expires_at\": \"2050-05-15T13:45:30Z\",\n \"success_url\": \"https://google.com\",\n \"cancel_url\": \"https://amazon.com\",\n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"total_in_cents\": \"500\",\n \"currency\": \"GTQ\",\n \"latest_intent\": null\n}"},{"id":"f70e72af-4f8d-4558-a266-d21153a2682d","name":"Pagado, pago único","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"formdata","formdata":[{"key":"items[][name]","value":"One Ripe Banana","type":"text","disabled":true},{"key":"items[][currency]","value":"GTQ","type":"text","disabled":true},{"key":"items[][amount_in_cents]","value":"3000","type":"text","disabled":true},{"key":"items[][image_url]","value":"https://source.unsplash.com/400x400/?banana","type":"text","disabled":true},{"key":"items[][quantity]","value":"1","type":"text","disabled":true},{"key":"mode","value":"setup","type":"text"}]},"url":"http://localhost:3000/api/checkouts/ch_d33gcgfpa8cz4pot"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_d33gcgfpa8cz4pot\",\n \"status\": \"paid\",\n \"payment\": {\n \"id\": \"pa_xnoesqzm\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\",\n \"id\": \"on_dlc21zwk\",\n \"tax_name\": null,\n \"tax_id\": null\n }\n },\n \"payment_method\": {\n \"id\": \"pay_m_ru4ztzg3\",\n \"type\": \"card\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"visa\"\n }\n },\n \"transfer_setups\": [],\n \"metadata\": {},\n \"expires_at\": \"2050-05-15T13:45:30Z\",\n \"success_url\": \"https://google.com\",\n \"cancel_url\": \"https://amazon.com\",\n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"total_in_cents\": \"500\",\n \"currency\": \"GTQ\",\n \"latest_intent\": { \n \"id\": \"pa_123\", \n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"type\": \"PaymentIntent\", \n data: { \n \"auth_code\": \"123456\" \n } \n }\n}"},{"id":"a12923c6-9ccd-4f01-829d-a44bae47513d","name":"Pagado, Inicio de una suscripción","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"formdata","formdata":[{"key":"items[][name]","value":"One Ripe Banana","type":"text","disabled":true},{"key":"items[][currency]","value":"GTQ","type":"text","disabled":true},{"key":"items[][amount_in_cents]","value":"3000","type":"text","disabled":true},{"key":"items[][image_url]","value":"https://source.unsplash.com/400x400/?banana","type":"text","disabled":true},{"key":"items[][quantity]","value":"1","type":"text","disabled":true},{"key":"mode","value":"setup","type":"text"}]},"url":"https://app.recurrente.com/api/checkouts/{{checkoutId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_lmgbvesmihkqzma3\",\n \"status\": \"paid\",\n \"payment\": {\n \"id\": \"pa_ttfeprgn\",\n \"paymentable\": {\n \"type\": \"Subscription\",\n \"id\": \"su_nehndm7j\",\n \"tax_name\": null,\n \"tax_id\": null\n }\n },\n \"payment_method\": {\n \"id\": \"pay_m_ru4ztzg3\",\n \"type\": \"card\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"visa\"\n }\n },\n \"transfer_setups\": [],\n \"metadata\": {},\n \"expires_at\": \"2050-05-15T13:45:30Z\",\n \"success_url\": \"https://google.com\",\n \"cancel_url\": \"https://amazon.com\",\n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"total_in_cents\": \"500\",\n \"currency\": \"GTQ\",\n \"latest_intent\": { \n \"id\": \"pa_123\", \n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"type\": \"PaymentIntent\", \n data: { \n \"auth_code\": \"123456\" \n } \n }\n}"}],"_postman_id":"eba033f6-cc9d-429d-bdfe-2ec4c197c300"},{"name":"Get all checkouts","id":"edc527f1-e4dc-43db-b19d-60ad86412a55","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/checkouts?from_time=2050-05-15T13:45:30Z&until_time=2050-05-15T13:45:30Z&user_id=us_123&page=1&items=20","urlObject":{"protocol":"https","path":["api","checkouts"],"host":["app","recurrente","com"],"query":[{"description":{"content":"(Opcional) Fecha y hora a partir de la cual quieres filtrar los checkouts, en formato ISO 8601. Por ejemplo: \"2024-05-15T13:45:30Z\".
\n","type":"text/plain"},"key":"from_time","value":"2050-05-15T13:45:30Z"},{"description":{"content":"(Opcional) Fecha y hora hasta la cual quieres filtrar los checkouts, en formato ISO 8601. Por ejemplo: \"2024-05-15T13:45:30Z\"
\n","type":"text/plain"},"key":"until_time","value":"2050-05-15T13:45:30Z"},{"description":{"content":"(Opcional) ID del usuario para filtrar los checkouts asociados a él. Por ejemplo: \"us_123\".
\n","type":"text/plain"},"key":"user_id","value":"us_123"},{"description":{"content":"(Opcional) Número de página actual que deseas visualizar.
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"(Opcional) Cantidad de elementos que se deben mostrar por página.
\n","type":"text/plain"},"key":"items","value":"20"}],"variable":[]}},"response":[{"id":"69e7c3c1-9b58-4468-8020-ddf4349dc0f8","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"https://app.recurrente.com/api/checkouts?from_time=2024-05-15T13:45:30Z&until_time=2050-05-15T13:45:30Z&user_id=us_123","protocol":"https","host":["app","recurrente","com"],"path":["api","checkouts"],"query":[{"key":"from_time","value":"2024-05-15T13:45:30Z"},{"key":"until_time","value":"2050-05-15T13:45:30Z"},{"key":"user_id","value":"us_123"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[{\n \"id\": \"ch_lmgbvesmihkqzma3\",\n \"status\": \"paid\",\n \"payment\": {\n \"id\": \"pa_ttfeprgn\",\n \"paymentable\": {\n \"type\": \"Subscription\",\n \"id\": \"su_nehndm7j\",\n \"tax_name\": null,\n \"tax_id\": null\n }\n },\n \"payment_method\": {\n \"id\": \"pay_m_ru4ztzg3\",\n \"type\": \"card\",\n \"card\": {\n \"last4\": \"4242\",\n \"network\": \"visa\"\n }\n },\n \"transfer_setups\": [],\n \"metadata\": {},\n \"expires_at\": \"2050-05-15T13:45:30Z\",\n \"success_url\": \"https://google.com\",\n \"cancel_url\": \"https://amazon.com\",\n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"total_in_cents\": \"500\",\n \"currency\": \"GTQ\",\n \"latest_intent\": { \n \"id\": \"pa_123\", \n \"created_at\": \"2025-05-15T13:45:30Z\",\n \"type\": \"PaymentIntent\", \n data: { \n \"auth_code\": \"123456\" \n } \n }\n}]"}],"_postman_id":"edc527f1-e4dc-43db-b19d-60ad86412a55"}],"id":"0d299b83-dc4a-4ea2-ab2b-2d95e01bc1f4","description":"Un Checkout te entrega un link a una página de compra a la cuál debes redirigir a tu usuario.
Puedes usar checkouts para:
\nUn pago único
\nIniciar una suscripción
\nExisten dos formas de determinar el monto en un checkout:
\nCreando los \"items\" que quiero añadir al checkout directo desde el request.
\nPasando el \"Price ID\" de los productos que quiero añadir.
\nEn esta sección encontrarás ejemplos de ambos casos.
\nPara saber si el usuario ya completó el pago, tú puedes revisar el estado de la compra de dos maneras:
\nUtilizando webhooks (recomendada).
\nLlamando a \"GET Checkout\" con el ID del checkout, y revisando el estado ahí.
\nPara hacer pagos de prueba, utiliza tus llaves de ambiente TEST. Para realizar un pago exitoso, debes utilizar la tarjeta 4242 4242 4242 4242.
\nCheckouts creados con llaves test serán diferentes a los checkouts LIVE de las siguientes maneras:
\nTendrán un aviso que dirá \"PRUEBA\" en el link de pago.
\nTendrán el atributo live_mode = false.
No crearán actividad en la cuenta, ni incrementarán el balance.
\nNo se enviarán webhooks.
\nPara customizar métodos de pago:
\nDebe ir incluido custom_payment_method_settings: true, de lo contrario, el producto regresa a utilizar los defaults de la cuenta.
Para no ofrecer cuotas, available_installments debe ser un array vacío []
Ejemplo:
\n{ \n \"product\": { \n \"name\": \"El nombre del producto\",\n \"custom_payment_method_settings\": \"true\",\n \"card_payments_enabled\": \"true\",\n \"bank_transfer_payments_enabled\": \"true\",\n \"available_installments\": [3, 6, 12, 18],\n \"prices_attributes\": [\n { \n \"amount_in_cents\": \"10000\",\n \"charge_type\": \"one_time\",\n \"currency\": \"GTQ\"\n }\n ]\n }\n}\n\nPuedes expirar un checkout utilizando el atributo de expires_at.
Puedes ponerle una fecha futura (fecha y hora en la que va a expirar), o una fecha pasada (para que se expire instantáneamente).
\nCustomiza la apariencia de tus checkouts desde Ajustes -> Tienda -> Apariencia.
\nPodrás añadir color de fondo, color de acento, y escoger la Fuente (tipografía) que quieras.
\n","_postman_id":"0d299b83-dc4a-4ea2-ab2b-2d95e01bc1f4"},{"name":"Customers","item":[{"name":"Listar clientes","id":"08012a8f-2ef1-4530-acf3-e0c22b6348b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}","description":"Tu llave pública
\n"},{"key":"X-SECRET-KEY","value":"{{secret_key}}","description":"Tu llave secreta
\n"}],"url":"{{base_url}}/api/customers","description":"Obtiene una lista de todos los clientes de tu cuenta, ordenados del más reciente al más antiguo.
\n","urlObject":{"path":["api","customers"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"0328af92-c1f1-4bff-aded-237f5ace77e0","name":"Listado exitoso","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}"},{"key":"X-SECRET-KEY","value":"{{secret_key}}"}],"url":"{{base_url}}/api/customers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"customers\": [\n {\n \"id\": \"cus_abc123\",\n \"user_id\": \"usr_xyz789\",\n \"email\": \"cliente@ejemplo.com\",\n \"name\": \"María García\"\n },\n {\n \"id\": \"cus_def456\",\n \"user_id\": \"usr_uvw012\",\n \"email\": \"otro@ejemplo.com\",\n \"name\": \"Juan López\"\n }\n ]\n}"}],"_postman_id":"08012a8f-2ef1-4530-acf3-e0c22b6348b9"},{"name":"Obtener cliente","id":"03ed4d9f-efe4-452e-ad86-168501f986b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}","description":"Tu llave pública
\n"},{"key":"X-SECRET-KEY","value":"{{secret_key}}","description":"Tu llave secreta
\n"}],"url":"{{base_url}}/api/customers/:id","description":"Obtiene los detalles de un cliente específico.
\nID del cliente (cus_xxx)
\n","type":"text/plain"},"type":"any","value":"cus_abc123","key":"id"}]}},"response":[{"id":"bc935707-763e-4444-b39f-f3ee845d5fc1","name":"Cliente encontrado","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}"},{"key":"X-SECRET-KEY","value":"{{secret_key}}"}],"url":"{{base_url}}/api/customers/cus_abc123"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"cus_abc123\",\n \"user_id\": \"usr_xyz789\",\n \"email\": \"cliente@ejemplo.com\",\n \"name\": \"María García\"\n}"},{"id":"bdca220b-4bcb-4222-9e4f-ab338e53d497","name":"Cliente no encontrado","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}"},{"key":"X-SECRET-KEY","value":"{{secret_key}}"}],"url":"{{base_url}}/api/customers/cus_invalid"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Autenticación Errónea 👀\"\n}"}],"_postman_id":"03ed4d9f-efe4-452e-ad86-168501f986b9"},{"name":"Obtener cliente por user_id","id":"a2991a79-0425-47df-820d-339c718cce8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}","description":"Tu llave pública
\n"},{"key":"X-SECRET-KEY","value":"{{secret_key}}","description":"Tu llave secreta
\n"}],"url":"{{base_url}}/api/customers/:id?user_id=usr_xyz789","description":"Obtiene un cliente buscando por el ID del usuario en lugar del ID del cliente.
\nEsto es útil cuando tienes el user_id de un checkout o pago y quieres obtener el cliente asociado a tu cuenta.
ID del usuario (usr_xxx)
\n","type":"text/plain"},"key":"user_id","value":"usr_xyz789"}],"variable":[{"id":"014ca858-6a3d-4b10-ae6d-d27d4ecfe697","description":{"content":"Ignorado cuando se usa user_id
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[{"id":"dde32c8c-dbaa-4fc6-9f1e-50f9b662de12","name":"Cliente encontrado por user_id","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}"},{"key":"X-SECRET-KEY","value":"{{secret_key}}"}],"url":{"raw":"{{base_url}}/api/customers/x?user_id=usr_xyz789","host":["{{base_url}}"],"path":["api","customers","x"],"query":[{"key":"user_id","value":"usr_xyz789"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"cus_abc123\",\n \"user_id\": \"usr_xyz789\",\n \"email\": \"cliente@ejemplo.com\",\n \"name\": \"María García\"\n}"}],"_postman_id":"a2991a79-0425-47df-820d-339c718cce8e"},{"name":"Crear cliente","id":"188fae7a-7e06-415d-99b5-98061acf6690","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}","description":"Tu llave pública
\n"},{"key":"X-SECRET-KEY","value":"{{secret_key}}","description":"Tu llave secreta
\n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"nuevo@ejemplo.com\",\n \"full_name\": \"Ana Martínez\",\n \"name\": \"Ana M.\"\n}"},"url":"{{base_url}}/api/customers","description":"Crea un nuevo cliente en tu cuenta.
\nSi ya existe un usuario con el email proporcionado, se creará un cliente asociado a ese usuario existente. Si el email es nuevo, se creará tanto el usuario como el cliente.
\nTu llave pública
\n"},{"key":"X-SECRET-KEY","value":"{{secret_key}}","description":"Tu llave secreta
\n"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"María García López\"\n}"},"url":"{{base_url}}/api/customers/:id","description":"Actualiza el nombre de un cliente existente.
\nID del cliente (cus_xxx)
\n","type":"text/plain"},"type":"any","value":"cus_abc123","key":"id"}]}},"response":[{"id":"f5102a4c-da98-448b-9fc8-02976a322a61","name":"Cliente actualizado","originalRequest":{"method":"PUT","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}"},{"key":"X-SECRET-KEY","value":"{{secret_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"María García López\"\n}"},"url":"{{base_url}}/api/customers/cus_abc123"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"cus_abc123\",\n \"user_id\": \"usr_xyz789\",\n \"email\": \"cliente@ejemplo.com\",\n \"name\": \"María García López\"\n}"},{"id":"5a99d060-5f88-462d-837a-d1dddabbf862","name":"Cliente no encontrado","originalRequest":{"method":"PUT","header":[{"key":"X-PUBLIC-KEY","value":"{{public_key}}"},{"key":"X-SECRET-KEY","value":"{{secret_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Nuevo Nombre\"\n}"},"url":"{{base_url}}/api/customers/cus_invalid"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Autenticación Errónea 👀\"\n}"}],"_postman_id":"9d874f2b-72ec-4a10-b013-9155b372e869"}],"id":"4ea1e1f0-8885-45e4-9cc8-54d2c41d8c59","description":"API para gestionar clientes de tu cuenta.
\nLos clientes representan a los usuarios que han realizado compras en tu cuenta. Cada cliente tiene un ID único y está asociado a un usuario (user_id) que puede tener clientes en múltiples cuentas.
\n","_postman_id":"4ea1e1f0-8885-45e4-9cc8-54d2c41d8c59"},{"name":"Payment Intents","item":[{"name":"Update a payment intent","id":"38197825-45ea-4b08-b339-e6029c5d7fbf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"payment_intent[tax_invoice_url]","value":"\"https://example.com/factura123\"","type":"text","description":"El URL de la factura electrónica
\n"}]},"url":"https://app.recurrente.com/api/payment_intents/{{paymentIntentId}}","description":"Para actualizar la factura de un pago, debés pasar el parámetro de tax_invoice_url, como se muestra en el ejemplo.
Un PaymentIntent representa el proceso de recopilar un pago de tu cliente. Puedes usar el PaymentIntent más adelante para guardar información relacionada con la venta, como el URL de la factura.
\nUn PaymentIntent pasa por múltiples estados a lo largo de su vida útil mientras se realizan flujos de autenticación, recopila el pago y, finalmente, crea como máximo un cargo exitoso.
\nPara generar tu factura automáticamente, intégrate con un proveedor como Tributax.
\n","_postman_id":"dcc28795-37e2-4e9b-8026-bbd1f55cc18d"},{"name":"Products","item":[{"name":"Create a product (one time payment)","id":"f67b765a-07c7-4861-af44-5bcbb5fecc4b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"product[name]","value":"El nombre de tu producto","description":"El nombre del producto.
\n","type":"text"},{"key":"product[description]","value":"La descripción es opcional","description":"(Opcional)
\n","type":"text"},{"key":"product[image_url]","value":"https://source.unsplash.com/400x400/?banana","description":"(Opcional) URL de la imagen del producto.
\n","type":"text"},{"key":"product[prices_attributes[][currency]]","value":"GTQ","description":"Posibles valores son:
\n(Opcional) Cantidad.
\n","type":"text"},{"key":"product[cancel_url]","value":"https://www.amazon.com/","description":"(Opcional) URL a dónde dirigir al comprador después de un pago exitoso.
\n","type":"text"},{"key":"product[success_url]","value":"https://www.google.com/","description":"(Opcional) URL a dónde dirigir al comprador cuando abandona el checkout.
\n","type":"text"},{"key":"product[custom_terms_and_conditions]","value":"El texto que tú quieras añadir.","description":"(Opcional)
\n","type":"text"},{"key":"product[phone_requirement]","value":"none","description":"Los valores posibles son:
\n(Opcional) Si deseas capturar dirección de entrega en el checkout. Los valores posibles son:
\n(Opcional) Si deseas capturar NIT/Pasaporte en el checkout. Los valores posibles son:
\n(Opcional) Esto determina si el comprador puede ajustar la cantidad de unidades a comprar de este producto.
\nSi lo dejas en blanco, el valor es \"true\". Puedes cambiarlo a \"false\".
\n","type":"text"},{"key":"product[metadata]","value":"{}","description":"(Opcional) Puedes utilizar metadata para almacenar información estructurada adicional sobre un producto.
\nPuedes especificar hasta 50 keys, con nombres de hasta 40 caracteres y valores de hasta 500 caracteres.
\n","type":"text"},{"key":"product[inventory_quantity]","value":"","description":"(Opcional) Puedes dejarlo vacío si no quieres llevar una cantidad de inventario. Cada compra va reduciendo el inventario disponible, hasta que el producto llega a 0 disponible y se deshabilita.
\n","type":"text","uuid":"f48f4534-9d14-4429-840b-327ea0ed43df"},{"key":"product[has_dynamic_pricing]","value":"","description":"(Opcional) Añade precio dinámico. El precio se convierte en el \"monto a recibir\" neto por el comercio. Disponible solo para pagos únicos.
\n","type":"text","uuid":"a68f46fc-f391-49a4-9675-96da2991bd74"}]},"url":"https://app.recurrente.com/api/products/","urlObject":{"protocol":"https","path":["api","products",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"e0f0674e-6016-4a99-86c6-018132138295","name":"Ejemplo","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"product\": {\n \"name\": \"El nombre de tu producto\",\n \"description\": \"La descripción es opcional\",\n \"image_url\": \"https://source.unsplash.com/400x400/?banana\",\n \"prices_attributes\": [\n {\n \"currency\": \"GTQ\",\n \"charge_type\": \"one_time\",\n \"amount_in_cents\": 500\n }\n ],\n \"cancel_url\": \"https://www.amazon.com/\",\n \"success_url\": \"https://www.google.com/\",\n \"custom_terms_and_conditions\": \"El texto que tú quieras añadir.\",\n \"phone_requirement\": \"none\",\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"none\"\n },\n \"adjustable_quantity\": true,\n \"inventory_quantity\": null,\n \"metadata\": {}\n}\n","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/products/"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"prod_9lstwgbr\",\n \"status\": \"active\",\n \"name\": \"El nombre de tu producto\",\n \"description\": \"Descripción del producto\",\n \"success_url\": \"https://www.google.com/\",\n \"cancel_url\": \"https://www.amazon.com/\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"phone_requirement\": \"none\",\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"none\",\n \"prices\": [\n {\n \"id\": \"price_rky4dog7\",\n \"amount_in_cents\": 500,\n \"currency\": \"GTQ\",\n \"billing_interval_count\": 0,\n \"billing_interval\": \"\",\n \"charge_type\": \"one_time\",\n \"periods_before_automatic_cancellation\": null,\n \"free_trial_interval_count\": 0,\n \"free_trial_interval\": \"\"\n }\n ],\n \"storefront_link\": \"https://app.recurrente.com/s/surf-office/el-nombre-de-tu-producto\",\n \"metadata\": {}\n}"}],"_postman_id":"f67b765a-07c7-4861-af44-5bcbb5fecc4b"},{"name":"Create a product (subscription)","id":"eb67ae47-b9d9-45f6-a22f-773e4772adee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"}],"body":{"mode":"formdata","formdata":[{"key":"product[name]","value":"El nombre de tu producto","type":"text","description":"El nombre del producto.
\n"},{"key":"product[description]","value":"La descripción es opcional","description":"(Opcional)
\n","type":"text"},{"key":"product[image_url]","value":"https://source.unsplash.com/400x400/?banana","type":"text","description":"La moneda a cobrar.
\nPosibles valores son:
\nMonto a cobrar en centavos.
\n"},{"key":"product[prices_attributes[][charge_type]]","value":"recurring","type":"text","description":"(Opcional) URL de la imagen del producto.
\n"},{"key":"product[prices_attributes[][amount_in_cents]]","value":"1000","type":"text","description":"(Opcional) Cantidad.
\nSi no incluyes una, el default es 1.
\n"},{"key":"product[cancel_url]","value":"https://www.amazon.com/","type":"text","description":"(Opcional) URL a dónde dirigir al comprador después de un pago exitoso.
\n"},{"key":"product[success_url]","value":"https://www.google.com/","type":"text","description":"(Opcional) URL a dónde dirigir al comprador cuando abandona el checkout.
\n"},{"key":"product[custom_terms_and_conditions]","value":"El texto que tú quieras añadir.","description":"(Opcional)
\n","type":"text"},{"key":"product[phone_requirement]","value":"none","description":"Los valores posibles son:
\nLos valores posibles son:
\nLos valores posibles son:
\n(Opcional) Esto determina si el comprador puede ajustar la cantidad de unidades a comprar de este producto.
\nSi lo dejas en blanco, el valor es \"true\". Puedes cambiarlo a \"false\".
\n","type":"text"},{"key":"product[prices_attributes[][billing_interval_count]]","value":"1","description":"Cada cuánto quieres cobrar la suscripción en número (e.g. 1 mes, 2 meses)
\n","type":"text"},{"key":"product[prices_attributes[][billing_interval]]","value":"month","description":"Qué plazo quieres usar para cobrar la suscripción. Los valores posibles son:
\n(Opcional) Cuánto quieres dar de periodo de prueba gratuito.
\n","type":"text"},{"key":"product[prices_attributes[][free_trial_interval]]","value":"month","description":"(Opcional) Qué plazo quieres usar para el período de prueba. Los valores posibles son:
\n(Opcional) Cuántos periodos quieres que pasen antes de que la suscripción se cancele automáticamente. Si lo dejas en blanco, la suscripción se continuará conbrando indefinidamente.
\n","type":"text"},{"key":"product[prices_attributes[][periods_before_allowed_to_cancel]]","value":"","description":"(Opcional) Cuántos periodos quieres que pasen antes de permitir que el cliente pueda cancelar su suscripción. Ojo, las suscripciones igual pueden cancelarse por falta de fondos en la tarjeta, tarjeta expirada, y otras razones.
\n","type":"text"},{"key":"metadata","value":"{}","description":"(Opcional) Puedes utilizar metadata para almacenar información estructurada adicional sobre un producto.
\nPuedes especificar hasta 50 keys, con nombres de hasta 40 caracteres y valores de hasta 500 caracteres.
\n","type":"text"}]},"url":"https://app.recurrente.com/api/products/","urlObject":{"protocol":"https","path":["api","products",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"777ff5a5-38ae-4d22-a6d9-df6263eecaa4","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"product\": {\n \"name\": \"El nombre de tu producto\",\n \"description\": \"Descripción del producto\",\n \"success_url\": \"https://www.google.com/\",\n \"cancel_url\": \"https://www.amazon.com/\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"phone_requirement\": \"none\",\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"none\",\n \"prices_attributes\": [\n {\n \"amount_in_cents\": 1000,\n \"currency\": \"GTQ\",\n \"billing_interval_count\": 1,\n \"billing_interval\": \"month\",\n \"charge_type\": \"recurring\",\n \"periods_before_automatic_cancellation\": \"\",\n \"free_trial_interval_count\": 1,\n \"free_trial_interval\": \"month\"\n }\n ],\n \"metadata\": {}\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/products/"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"prod_vsyjzsqf\",\n \"status\": \"active\",\n \"name\": \"El nombre de tu producto\",\n \"description\": \"Descripción del producto\",\n \"success_url\": \"https://www.google.com/\",\n \"cancel_url\": \"https://www.amazon.com/\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"phone_requirement\": \"none\",\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"none\",\n \"prices\": [\n {\n \"id\": \"price_tnxd8fzw\",\n \"amount_in_cents\": 1000,\n \"currency\": \"GTQ\",\n \"billing_interval_count\": 1,\n \"billing_interval\": \"month\",\n \"charge_type\": \"recurring\",\n \"periods_before_automatic_cancellation\": null,\n \"free_trial_interval_count\": 1,\n \"free_trial_interval\": \"month\"\n }\n ],\n \"storefront_link\": \"https://app.recurrente.com/s/surf-office/el-nombre-de-tu-producto-f9ljtq\",\n \"metadata\": {}\n}"}],"_postman_id":"eb67ae47-b9d9-45f6-a22f-773e4772adee"},{"name":"Get a product","id":"1a9e2de5-9afd-4b7b-953e-04671c011c5f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/products/{{productId}}","urlObject":{"protocol":"https","path":["api","products","{{productId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"a26573de-425a-4c64-85ee-8abf09e9626f","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/products/{{productId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Cowboy"},{"key":"Date","value":"Wed, 28 Feb 2024 20:41:18 GMT"},{"key":"Report-To","value":"{\"group\":\"heroku-nel\",\"max_age\":3600,\"endpoints\":[{\"url\":\"https://nel.heroku.com/reports?ts=1709152878&sid=c46efe9b-d3d2-4a0c-8c76-bfafa16c5add&s=kuTXFt%2B%2FCjg5IP9WA7%2BrvXPWCr3z6OyTV9wPXt6zuCE%3D\"}]}"},{"key":"Reporting-Endpoints","value":"heroku-nel=https://nel.heroku.com/reports?ts=1709152878&sid=c46efe9b-d3d2-4a0c-8c76-bfafa16c5add&s=kuTXFt%2B%2FCjg5IP9WA7%2BrvXPWCr3z6OyTV9wPXt6zuCE%3D"},{"key":"Nel","value":"{\"report_to\":\"heroku-nel\",\"max_age\":3600,\"success_fraction\":0.005,\"failure_fraction\":0.05,\"response_headers\":[\"Via\"]}"},{"key":"Connection","value":"keep-alive"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Xss-Protection","value":"0"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, OPTIONS"},{"key":"Etag","value":"W/\"81651a5e4f385ba7019ac6c322343bfe\""},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"Set-Cookie","value":"_recurrente_session=Z5kPcBK0PmEvNofCvy%2BMFNgVePTr8D2vPzbvUsENoUpjsLMq%2F21h9eb17%2FB8pvKsVjWyzfOVY7ZGiJwZKt124GzoWW7scwczjgSwAnTcFqDGM%2FSovORwhxtaPkXsG8NcOziDw1%2FkE556drmpz80HvF9Bab9JRE45sqWZnwvuZIY%2BrZbxmdTs990sjrr%2BMmFayGZNqfXwsQ%3D%3D--4UtQ1cPYXN0wuHHN--xDCfqOme016ix4wPZNEWGQ%3D%3D; path=/; secure; HttpOnly; SameSite=Lax"},{"key":"X-Request-Id","value":"9a93567d-bd07-4f64-88da-ecf22b197576"},{"key":"X-Runtime","value":"0.021820"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Content-Length","value":"1053"},{"key":"Via","value":"1.1 vegur"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"prod_9lstwgbr\",\n \"status\": \"active\",\n \"name\": \"El nombre de tu producto\",\n \"description\": \"Descripción de tu producto\",\n \"success_url\": \"https://www.google.com/\",\n \"cancel_url\": \"https://www.amazon.com/\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"phone_requirement\": \"none\",\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"none\",\n \"prices\": [\n {\n \"id\": \"price_rky4dog7\",\n \"amount_in_cents\": 500,\n \"currency\": \"GTQ\",\n \"billing_interval_count\": 0,\n \"billing_interval\": \"\",\n \"charge_type\": \"one_time\",\n \"periods_before_automatic_cancellation\": null,\n \"free_trial_interval_count\": 0,\n \"free_trial_interval\": \"\"\n }\n ],\n \"storefront_link\": \"https://app.recurrente.com/s/surf-office/el-nombre-de-tu-producto\",\n \"metadata\": {}\n}"}],"_postman_id":"1a9e2de5-9afd-4b7b-953e-04671c011c5f"},{"name":"Get all products","id":"48861d42-db9f-40c6-ab22-21e73160e4da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/products","description":"Por defecto, se muestran los 10 productos más recientes. Para obtener los siguientes 10 productos, agrega query params.
\nEjemplo: https://app.recurrente.com/api/products?page=2
\n","urlObject":{"protocol":"https","path":["api","products"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"3ef0c7c8-58c3-4197-a1d5-e8d64c5a1dd5","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/products"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"prod_9lstwgbr\",\n \"status\": \"active\",\n \"name\": \"El nombre de tu producto\",\n \"description\": \"Descripción de tu producto\",\n \"success_url\": \"https://www.google.com/\",\n \"cancel_url\": \"https://www.amazon.com/\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"phone_requirement\": \"none\",\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"none\",\n \"prices\": [\n {\n \"id\": \"price_rky4dog7\",\n \"amount_in_cents\": 500,\n \"currency\": \"GTQ\",\n \"billing_interval_count\": 0,\n \"billing_interval\": \"\",\n \"charge_type\": \"one_time\",\n \"periods_before_automatic_cancellation\": null,\n \"free_trial_interval_count\": 0,\n \"free_trial_interval\": \"\"\n }\n ],\n \"storefront_link\": \"https://app.recurrente.com/s/surf-office/el-nombre-de-tu-producto\",\n \"metadata\": {}\n },\n {\n \"id\": \"prod_psstwgbr\",\n \"status\": \"active\",\n \"name\": \"El nombre de tu producto 2\",\n \"description\": \"Descripción de tu producto\",\n \"success_url\": \"https://www.google.com/\",\n \"cancel_url\": \"https://www.amazon.com/\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"phone_requirement\": \"none\",\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"none\",\n \"prices\": [\n {\n \"id\": \"price_rky4dog7\",\n \"amount_in_cents\": 500,\n \"currency\": \"GTQ\",\n \"billing_interval_count\": 0,\n \"billing_interval\": \"\",\n \"charge_type\": \"one_time\",\n \"periods_before_automatic_cancellation\": null,\n \"free_trial_interval_count\": 0,\n \"free_trial_interval\": \"\"\n }\n ],\n \"storefront_link\": \"https://app.recurrente.com/s/surf-office/el-nombre-de-tu-producto-2\",\n \"metadata\": {}\n }\n]"}],"_postman_id":"48861d42-db9f-40c6-ab22-21e73160e4da"},{"name":"Update a product","id":"206bfdfb-1531-406e-8d7e-c82c248f3a9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"product[name]","value":"El nuevo nombre","type":"text","description":"El nombre del producto.
\n"},{"key":"product[prices_attributes[0][id]]","value":"{{priceId}}","description":"Si quieres actualizar parámetros del precio, debés incluir el price_id
\n","type":"text"},{"key":"product[prices_attributes[0][amount_in_cents]]","value":"1500","type":"text","description":"El monto a cobrar en centavos
\n"}]},"url":"https://app.recurrente.com/api/products/{{productId}}","description":"Para actualizar el precio de un producto, debés pasar el parámetro de price_id, como se muestra en el ejemplo.
Adicional, puedes actualizar cualquier otro de los parámetros que se muestra en el endpoint de Create a product.
\nPara borrar un precio, adicional a pasar el price_id debés pasar el parámetro de _destroy como mostrado aquí:
product[prices_attributes][0][_destroy]
Puedes crear dos tipos de productos:
\nCobro único one_time
Suscripción recurring
Abajo encontrarás los requests para ambos.
\n","_postman_id":"9ff570ef-8078-490f-b162-ce5aca0a7208"},{"name":"Coupons","item":[{"name":"Create a coupon","id":"b7c5a56d-f50c-45d7-be07-5744313816cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"}],"body":{"mode":"formdata","formdata":[{"key":"coupon[name]","value":"VERANO25","type":"text","description":"El nombre de tu cupón
\n"},{"key":"coupon[amount_off_in_cents]","value":"1500","type":"text","description":"(Opcional) Monto de descuento en centavos (ej. 1500 = Q15.00)
\n"},{"key":"coupon[percent_off]","value":"10","type":"text","description":"(Opcional) Porcentaje de descuento (ej. 10 = 10%)
\n"},{"key":"coupon[currency]","value":"GTQ","type":"text","description":"Moneda ISO (ej. GTQ) – requerido si usas amount_off_in_cents
\n"},{"key":"coupon[duration]","value":"once | forever","type":"text","description":"En caso de una suscripción, si el cupón aplica solo al primer pago (\"once\") o a todos los pagos futuros (\"forever\").
\n"}]},"url":"https://app.recurrente.com/api/coupons","urlObject":{"protocol":"https","path":["api","coupons"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"ab1651ea-8ee5-4ce9-9c60-bdb457943e87","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"coupon\": {\n \"name\": \"NEWCOUPON\",\n \"amount_off_in_cents\": 1500,\n \"currency\": \"GTQ\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/coupons/"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"coup_ugwoxcp4\",\n \"name\": \"NEWCOUPON\",\n \"amount_off_in_cents\": 1500,\n \"percent_off\": null,\n \"max_redemptions\": null,\n \"currency\": \"GTQ\",\n \"duration\": \"once\",\n \"expires_at\": null,\n \"status\": \"active\"\n }"}],"_postman_id":"b7c5a56d-f50c-45d7-be07-5744313816cf"},{"name":"Get a coupon","id":"f2f8a13e-c2b2-4da7-8d57-4de04d26f7a0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/coupons/{{couponId}}","urlObject":{"protocol":"https","path":["api","coupons","{{couponId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"51a49a66-499e-462d-83b3-50062f9b2b45","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/coupons/{{couponID}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Cowboy"},{"key":"Date","value":"Wed, 28 Feb 2024 20:41:18 GMT"},{"key":"Report-To","value":"{\"group\":\"heroku-nel\",\"max_age\":3600,\"endpoints\":[{\"url\":\"https://nel.heroku.com/reports?ts=1709152878&sid=c46efe9b-d3d2-4a0c-8c76-bfafa16c5add&s=kuTXFt%2B%2FCjg5IP9WA7%2BrvXPWCr3z6OyTV9wPXt6zuCE%3D\"}]}"},{"key":"Reporting-Endpoints","value":"heroku-nel=https://nel.heroku.com/reports?ts=1709152878&sid=c46efe9b-d3d2-4a0c-8c76-bfafa16c5add&s=kuTXFt%2B%2FCjg5IP9WA7%2BrvXPWCr3z6OyTV9wPXt6zuCE%3D"},{"key":"Nel","value":"{\"report_to\":\"heroku-nel\",\"max_age\":3600,\"success_fraction\":0.005,\"failure_fraction\":0.05,\"response_headers\":[\"Via\"]}"},{"key":"Connection","value":"keep-alive"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Xss-Protection","value":"0"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Methods","value":"GET, OPTIONS"},{"key":"Etag","value":"W/\"81651a5e4f385ba7019ac6c322343bfe\""},{"key":"Cache-Control","value":"max-age=0, private, must-revalidate"},{"key":"Set-Cookie","value":"_recurrente_session=Z5kPcBK0PmEvNofCvy%2BMFNgVePTr8D2vPzbvUsENoUpjsLMq%2F21h9eb17%2FB8pvKsVjWyzfOVY7ZGiJwZKt124GzoWW7scwczjgSwAnTcFqDGM%2FSovORwhxtaPkXsG8NcOziDw1%2FkE556drmpz80HvF9Bab9JRE45sqWZnwvuZIY%2BrZbxmdTs990sjrr%2BMmFayGZNqfXwsQ%3D%3D--4UtQ1cPYXN0wuHHN--xDCfqOme016ix4wPZNEWGQ%3D%3D; path=/; secure; HttpOnly; SameSite=Lax"},{"key":"X-Request-Id","value":"9a93567d-bd07-4f64-88da-ecf22b197576"},{"key":"X-Runtime","value":"0.021820"},{"key":"Strict-Transport-Security","value":"max-age=63072000; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Content-Length","value":"1053"},{"key":"Via","value":"1.1 vegur"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"coup_ugwoxcp4\",\n \"name\": \"NEWCOUPON\",\n \"amount_off_in_cents\": 1500,\n \"percent_off\": null,\n \"max_redemptions\": null,\n \"currency\": \"GTQ\",\n \"duration\": \"once\",\n \"expires_at\": null,\n \"status\": \"active\"\n }"}],"_postman_id":"f2f8a13e-c2b2-4da7-8d57-4de04d26f7a0"},{"name":"Get all coupons","id":"0c17de0a-7dbd-4ee4-af0c-65cc8d1919db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/coupons","description":"Por defecto, se muestran los 10 cupones más recientes. Para obtener los siguientes 10 cupones, agrega query params.
\nEjemplo: https://app.recurrente.com/api/products?page=2
\n","urlObject":{"protocol":"https","path":["api","coupons"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"9332a002-5418-4bd3-8314-e0e59eadec32","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/coupons"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"coup_ugwoxcp4\",\n \"name\": \"NEWCOUPON\",\n \"amount_off_in_cents\": 1500,\n \"percent_off\": null,\n \"max_redemptions\": null,\n \"currency\": \"GTQ\",\n \"duration\": \"once\",\n \"expires_at\": null,\n \"status\": \"active\"\n }\n ]"}],"_postman_id":"0c17de0a-7dbd-4ee4-af0c-65cc8d1919db"},{"name":"Update a coupon","id":"34d2e10b-4b3f-421d-b61b-bb97a5b5201e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"}],"body":{"mode":"formdata","formdata":[{"key":"coupon[name]","value":"VERANO25","type":"text","description":"El nombre de tu cupón
\n"},{"key":"coupon[amount_off_in_cents]","value":"1500","type":"text","description":"(Opcional) Monto de descuento en centavos (ej. 1500 = Q15.00)
\n"},{"key":"coupon[percent_off]","value":"10","type":"text","description":"(Opcional) Porcentaje de descuento (ej. 10 = 10%)
\n"},{"key":"coupon[currency]","value":"GTQ","type":"text","description":"Moneda ISO (ej. GTQ) – requerido si usas amount_off_in_cents
\n"},{"key":"coupon[duration]","value":"once | forever","type":"text","description":"Duración del cupón
\n"}]},"url":"https://app.recurrente.com/api/coupons/{{couponId}}","urlObject":{"protocol":"https","path":["api","coupons","{{couponId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"dbf59d59-fe20-4d9f-a994-6d1fadc7b3b8","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"coupon\": {\n \"name\": \"NEWCOUPON\",\n \"amount_off_in_cents\": 1500,\n \"currency\": \"GTQ\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/coupons/{{couponID}}"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"coup_ugwoxcp4\",\n \"name\": \"NEWCOUPON\",\n \"amount_off_in_cents\": 1500,\n \"percent_off\": null,\n \"max_redemptions\": null,\n \"currency\": \"GTQ\",\n \"duration\": \"once\",\n \"expires_at\": null,\n \"status\": \"active\"\n }"}],"_postman_id":"34d2e10b-4b3f-421d-b61b-bb97a5b5201e"},{"name":"Delete a coupon","id":"82f9e16d-1c12-4c31-adfd-e5fa0e4d6f5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/coupons/{{couponID}}","urlObject":{"protocol":"https","path":["api","coupons","{{couponID}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"842e152a-3d2e-4dea-8134-a8f937da8c74","name":"Respuesta exitosa","originalRequest":{"method":"DELETE","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/coupons/{{couponID}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"coup_eug4euns\",\n \"status\": \"deleted\"\n}"}],"_postman_id":"82f9e16d-1c12-4c31-adfd-e5fa0e4d6f5d"}],"id":"f19c2096-d60a-47f5-a061-3cfb0af3b0e9","description":"La API de Cupones permite a los comercios crear, consultar, actualizar y eliminar cupones de descuento.
\nUn cupón define una promoción que puede ser aplicada a un pago, por ejemplo un monto fijo de descuento o un porcentaje.
\n","_postman_id":"f19c2096-d60a-47f5-a061-3cfb0af3b0e9"},{"name":"Subscriptions","item":[{"name":"Get a subscription","id":"1ed91657-e1ea-47e1-a0ec-26a0284df540","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions/{{subscriptionId}}","urlObject":{"protocol":"https","path":["api","subscriptions","{{subscriptionId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"addd9ad5-45cb-4af6-803d-f327c58f4802","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions/{{subscriptionId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"su_nehndm7j\",\n \"description\": \"One Free-Testable Banana\",\n \"status\": \"active\",\n \"created_at\": \"2024-03-01T03:52:12.636-06:00\",\n \"updated_at\": \"2024-03-01T03:52:12.982-06:00\",\n \"current_period_start\": \"2024-03-01T03:52:12.636-06:00\",\n \"current_period_end\": \"2024-03-02T03:52:12.636-06:00\",\n \"tax_name\": null,\n \"tax_id\": null,\n \"subscriber\": {\n \"id\": \"us_rdctav2g\",\n \"first_name\": \"Fela\",\n \"last_name\": \"Kuti\",\n \"full_name\": \"Fela Kuti\",\n \"email\": \"test@user.com\",\n \"phone_number\": null\n },\n \"checkout\": {\n \"id\": \"ch_lmgbvesmihkqzma3\"\n },\n \"product\": {\n \"id\": \"pr_7ehozftv\"\n }\n}"}],"_postman_id":"1ed91657-e1ea-47e1-a0ec-26a0284df540"},{"name":"Update a subscription","id":"969f9293-909a-4ddc-96fc-92f89aebfe11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"act","value":"pause|unpause","description":"Pausar/reanudar suscripción
\n","type":"text","uuid":"b779547b-316b-4f8d-ac90-27be969be004"}]},"url":"https://app.recurrente.com/api/subscriptions/{{subscriptionId}}","urlObject":{"protocol":"https","path":["api","subscriptions","{{subscriptionId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"3ec6ac97-8f4b-4f31-a5ca-a89e790171c8","name":"Respuesta exitosa pausar","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions/{{subscriptionId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"su_nehndm7j\",\n \"description\": \"One Free-Testable Banana\",\n \"status\": \"paused\",\n \"created_at\": \"2024-03-01T03:52:12.636-06:00\",\n \"updated_at\": \"2024-03-01T03:52:12.982-06:00\",\n \"current_period_start\": \"2024-03-01T03:52:12.636-06:00\",\n \"current_period_end\": \"2024-03-02T03:52:12.636-06:00\",\n \"tax_name\": null,\n \"tax_id\": null,\n \"subscriber\": {\n \"id\": \"us_rdctav2g\",\n \"first_name\": \"Fela\",\n \"last_name\": \"Kuti\",\n \"full_name\": \"Fela Kuti\",\n \"email\": \"test@user.com\",\n \"phone_number\": null\n },\n \"checkout\": {\n \"id\": \"ch_lmgbvesmihkqzma3\"\n },\n \"product\": {\n \"id\": \"pr_7ehozftv\"\n }\n}"},{"id":"cdd3d335-6175-4ea6-b9ba-1b8b3bfa5f90","name":"Respuesta exitosa reactivar","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions/{{subscriptionId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"su_nehndm7j\",\n \"description\": \"One Free-Testable Banana\",\n \"status\": \"active\",\n \"created_at\": \"2024-03-01T03:52:12.636-06:00\",\n \"updated_at\": \"2024-03-01T03:52:12.982-06:00\",\n \"current_period_start\": \"2024-03-01T03:52:12.636-06:00\",\n \"current_period_end\": \"2024-03-02T03:52:12.636-06:00\",\n \"tax_name\": null,\n \"tax_id\": null,\n \"subscriber\": {\n \"id\": \"us_rdctav2g\",\n \"first_name\": \"Fela\",\n \"last_name\": \"Kuti\",\n \"full_name\": \"Fela Kuti\",\n \"email\": \"test@user.com\",\n \"phone_number\": null\n },\n \"checkout\": {\n \"id\": \"ch_lmgbvesmihkqzma3\"\n },\n \"product\": {\n \"id\": \"pr_7ehozftv\"\n }\n}"}],"_postman_id":"969f9293-909a-4ddc-96fc-92f89aebfe11"},{"name":"Get all subscriptions","id":"c88580ab-7eb2-4661-8cf7-51c63d803d76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions","description":"Por defecto, se muestran las 10 suscripciones más recientes. Para obtener las siguientes 10 suscripciones, agrega query params.
\nEjemplo: https://app.recurrente.com/api/subscriptions?page=2
\n","urlObject":{"protocol":"https","path":["api","subscriptions"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"3d3d5a5e-04de-4a3f-982c-5e65f287079f","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"su_nehndm7j\",\n \"description\": \"One Free-Testable Banana\",\n \"status\": \"active\",\n \"created_at\": \"2024-03-01T03:52:12.636-06:00\",\n \"updated_at\": \"2024-03-01T03:52:12.982-06:00\",\n \"current_period_start\": \"2024-03-01T03:52:12.636-06:00\",\n \"current_period_end\": \"2024-03-02T03:52:12.636-06:00\",\n \"tax_name\": null,\n \"tax_id\": null,\n \"subscriber\": {\n \"id\": \"us_rdctav2g\",\n \"first_name\": \"Fela\",\n \"last_name\": \"Kuti\",\n \"full_name\": \"Fela Kuti\",\n \"email\": \"test@user.com\",\n \"phone_number\": null\n },\n \"checkout\": {\n \"id\": \"ch_lmgbvesmihkqzma3\"\n },\n \"product\": {\n \"id\": \"pr_7ehozftv\"\n }\n }\n]"}],"_postman_id":"c88580ab-7eb2-4661-8cf7-51c63d803d76"},{"name":"Cancel a subscription","id":"cdedeec6-becc-4ed0-b54e-f9f16cf55f6c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions/{{subscriptionId}}","urlObject":{"protocol":"https","path":["api","subscriptions","{{subscriptionId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"4a4637c0-25b0-4851-8a67-cb3f565b6f59","name":"Respuesta exitosa","originalRequest":{"method":"DELETE","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/subscriptions/{{subscriptionId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Suscripción cancelada\"\n}"}],"_postman_id":"cdedeec6-becc-4ed0-b54e-f9f16cf55f6c"}],"id":"7a5bc0f0-920a-401a-a3ff-3abf6dfaeff1","description":"Las suscripciones te permiten crear pagos recurrentes. Puedes cobrar semanal, mensual, o anualmente. O puedes elegir un período más específico, como \"cada 2 meses\". Una vez el usuario empiece su suscripción, se le cobrará recurrentemente en el intervalo seleccionado.
\nLos posibles status de una suscripción son:
\nactive - Cuando la suscripción está activa y los pagos están al día.
paused - Cuando la suscripción fue pausada, ya sea por el comercio o por el usuario. La suscripción no se cobrará de nuevo hasta que el estado sea cambiado a active
past_due - Cuando el período de la suscripción está vencido y no se ha logrado cobrar el último pago. Se hacen 3 re-intentos automáticos de cobrar el pago en los siguientes 5 días. Si se logra cobrar, se cambia a un estado de active. Si no se logra cobrar, se cambia a cancelled.
cancelled - Cuando la suscripción fue cancelada. Ya no se harán intentos de cobro.
unable_to_start - Cuando el primer pago de la suscripción es fallido y no es posible activar la suscripción.
Existen dos formas de crear un checkout. Aquí, vamos a ver la primera:
\nPasando todos los detalles (nombre, precio, etc.) de los \"items\" que quiero añadir.
\nPasando el \"Price ID\" de los productos que quiero añadir.
\nLa moneda a cobrar. Posibles valores son:
\nEl monto a cobrar en centavos
\n","type":"text"},{"key":"recipient_id","value":"recurrente","description":"El recipient_id es el @ de la cuenta a la que quieres enviar dinero.
\n","type":"text"}]},"url":"https://app.recurrente.com/api/transfers/","urlObject":{"protocol":"https","path":["api","transfers",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"41f21141-525e-4a5f-b55d-d1932309f62f","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"currency\": \"GTQ\",\n \"amount_in_cents\": \"100\",\n \"recipient_id\": \"recurrente\"\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/transfers/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"tr_nr4yplup\",\n \"status\": \"completed\"\n}"}],"_postman_id":"2e2168d7-388c-4926-a6d6-d664269c70ff"}],"id":"3d0e24ef-a002-4c80-b744-76a93ba13142","description":"Envía dinero de una cuenta de Recurrente a otra, sin ningún costo.
\nLo único que necesitas es saber el \"@\" de la cuenta a la que quieres enviar dinero, para incluirlo como el recipient_id
El ID del pago que se desea reembolsar
\n","type":"text"}]},"url":"https://app.recurrente.com/api/refunds/","urlObject":{"protocol":"https","path":["api","refunds",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"2b02e18f-3094-4c08-941a-ddf7e98852c9","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"payment_intent_id\": \"pa_e6kc6vx2\"\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/refunds/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"re_3jfrywsf\",\n \"status\": \"succeeded\",\n \"customer\": {\n \"id\": \"us_ik1qykpd\",\n \"email\": \"juan@gmail.com\",\n \"full_name\": \"Juan Perez\"\n },\n \"account_refunded_amount_in_cents\": 2187,\n \"customer_refunded_amount_in_cents\": 2500,\n \"currency\": \"GTQ\",\n \"created_at\": \"2024-06-23T12:26:51.962-06:00\"\n}"}],"_postman_id":"49565144-6f2a-4286-a2cb-60db0e5bed03"},{"name":"Get a refund","id":"fa02efb4-2f0b-4549-8a42-80743d02ee06","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[]},"url":"https://app.recurrente.com/api/refunds/{{refundId}}","urlObject":{"protocol":"https","path":["api","refunds","{{refundId}}"],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"a5554461-e935-442a-a1f9-205e16a7965e","name":"Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"url":"https://app.recurrente.com/api/refunds/{{refundId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"re_3jfrywsf\",\n \"status\": \"succeeded\",\n \"customer\": {\n \"id\": \"us_ik1qykpd\",\n \"email\": \"juan@gmail.com\",\n \"full_name\": \"Juan Perez\"\n },\n \"account_refunded_amount_in_cents\": 2187,\n \"customer_refunded_amount_in_cents\": 2500,\n \"currency\": \"GTQ\",\n \"created_at\": \"2024-06-23T12:26:51.962-06:00\"\n}"}],"_postman_id":"fa02efb4-2f0b-4549-8a42-80743d02ee06"}],"id":"348f9c74-2192-48a9-bc78-632e92a99346","_postman_id":"348f9c74-2192-48a9-bc78-632e92a99346","description":""},{"name":"Webhooks","item":[{"name":"Create a webhook endpoint","id":"8add2fc6-5b79-45e1-91de-47eae7cd80b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"url","value":"https://example.com/webhook","description":"El url al que se enviarán los webhooks
\n","type":"text"},{"key":"description","value":"Mi endpoint de prueba","description":"Opcional. Una breve descripción del endpoint
\n","type":"text"},{"key":"metadata","value":"{}","description":"Opcional. Cualquier información que quieras adjuntar al endpoint
\n","type":"text"}]},"url":"https://app.recurrente.com/api/webhook_endpoints/","description":"Permite crear nuevos webhooks endpoints en donde se enviaran las notificaciones webhook.
\n","urlObject":{"protocol":"https","path":["api","webhook_endpoints",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"08445a7c-37b5-4350-abe0-3de212b53f80","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"url\": \"https://example.com/webhook\",\n \"description\": \"Optional description of the endpoint\",\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/webhook_endpoints/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"description\": \"Optional description of the endpoint\",\n \"url\": \"https://example.com/webhook\",\n \"disabled\": false,\n \"createdAt\": \"2024-05-03T18:28:07.673413Z\",\n \"updatedAt\": \"2024-05-03T18:28:07.673427Z\",\n \"id\": \"ep_2fy6I9KODnHzw7Zf0ZGmMs8gEN9\",\n \"metadata\": {}\n}"}],"_postman_id":"8add2fc6-5b79-45e1-91de-47eae7cd80b9"},{"name":"Delete a webhook endpoint","id":"54a790a1-7ba2-4fbe-afaf-5ea2a4bd9f3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"url":"https://app.recurrente.com/api/webhook_endpoints/{{webhookId}}","description":"This endpoint allows you to create a new webhook endpoint for receiving webhook notifications.
\nurl (text): The URL to which the webhook notifications will be sent.description (text, optional): A brief description of the endpoint.metadata (text, optional): Any additional information you want to attach to the endpoint.{\n \"url\": \"https://your-webhook-url.com\",\n \"description\": \"Optional description of the endpoint\",\n \"metadata\": \"Optional metadata\"\n}\n\nid (string): The ID of the created webhook endpoint.status (string): The status of the request.{\n \"id\": \"webhook_endpoint_id\",\n \"status\": \"success\"\n}\n\nPara activar webhooks para tu cuenta, dentro de tu cuenta de Recurrente, ve a:
\nConfiguración → Desarrolladores y API.
\nAhí apacha en \"Webhooks\", y continúa a añadir el endpoint a donde quieres que sean enviados los requests.
\npayment_intent.succeeded
\nSe emite con un cobro exitoso con tarjeta (crédito o débito). Los fondos ya están en tu balance de Recurrente.
\nEjemplo de respuesta:
\n{\n \"id\": \"pa_id123\",\n \"event_type\": \"payment_intent.succeeded\",\n \"api_version\": \"2024-04-24\",\n \"checkout\": {\n \"id\": \"ch_id123\",\n \"status\": \"paid\",\n \"payment\": {\n \"id\": \"pa_laybj3zw\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\",\n \"id\": \"on_arognqni\",\n \"tax_name\": null,\n \"tax_id\": null,\n \"address\": null,\n \"phone_number\": null\n }\n },\n \"payment_method\": {\n \"id\": \"pay_m_7v5ie3pw\",\n \"type\": \"card\",\n \"card\": {\n \"last4\": \"0000\",\n \"network\": \"visa\"\n }\n },\n \"transfer_setups\": [],\n \"metadata\": {}\n },\n \"created_at\": \"2024-02-16T03:01:13.260Z\",\n \"failure_reason\": null,\n \"amount_in_cents\": 10000,\n \"currency\": \"GTQ\",\n \"fee\": 450,\n \"vat_withheld\": 160,\n \"vat_withheld_currency\": \"GTQ\",\n \"customer\": {\n \"email\": \"hello@example.com\",\n \"full_name\": \"Max Rodriguez\",\n \"id\": \"us_id123\"\n },\n \"payment\": {\n \"id\": \"pa_id123\",\n \"paymentable\": {\n \"id\": \"su_id123\",\n \"tax_id\": null,\n \"tax_name\": null,\n \"type\": \"Subscription\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"product\": {\n \"id\": \"prod_id123\"\n },\n \"invoice\": {\n \"id\": \"inv_123\",\n \"tax_invoice_url\": null\n }\n}\n\npayment_intent.failed
\nCobro fallido con tarjeta.
\nEjemplo de respuesta:
\n{{\n \"id\": \"pa_id123\",\n \"event_type\": \"payment_intent.failed\",\n \"api_version\": \"2024-03-13\",\n \"checkout\": {\n \"id\": \"ch_id123\"\n },\n \"created_at\": \"2024-02-16T03:01:13.260Z\",\n \"failure_reason\": \"Tu banco ha rechazado la transacción. Llama a tu banco y pide que autoricen esta transacción.\",,\n \"amount_in_cents\": 10000,\n \"currency\": \"GTQ\",\n \"fee\": 0,\n \"vat_withheld\": 0,\n \"vat_withheld_currency\": \"GTQ\",\n \"customer\": {\n \"email\": \"hello@example.com\",\n \"full_name\": \"Max Rodriguez\",\n \"id\": \"us_id123\"\n },\n \"payment\": {\n \"id\": \"pa_id123\",\n \"paymentable\": {\n \"id\": \"su_id123\",\n \"tax_id\": null,\n \"tax_name\": null,\n \"type\": \"Subscription\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"product\": {\n \"id\": \"prod_id123\"\n },\n \"invoice\": {\n \"id\": \"inv_123\",\n \"tax_invoice_url\": null\n }\n}\n\nsubscription.create
\nSi el producto es recurrente, se emite además del payment.succeeded este evento con la información de la suscripción.
\nEjemplo de respuesta:
\n{\n \"api_version\": \"2024-04-24\",\n \"created_at\": \"2025-10-13T13:59:27.931Z\",\n \"customer_email\": \"example@example.com\",\n \"customer_id\": \"us_1234\",\n \"customer_name\": \"Pedro Pérez\",\n \"event_type\": \"subscription.create\",\n \"id\": \"su_123\",\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"address\": null,\n \"id\": \"su_123\",\n \"phone_number\": \"+50255555555\",\n \"tax_id\": \"\",\n \"tax_name\": null,\n \"type\": \"Subscription\"\n }\n },\n \"product\": {\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"optional\",\n \"cancel_url\": \"\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"description\": \"Suscripción de prueba\",\n \"has_dynamic_pricing\": false,\n \"id\": \"prod_123\",\n \"metadata\": {},\n \"name\": \"Plan de Prueba\",\n \"phone_requirement\": \"required\",\n \"prices\": [\n {\n \"amount_in_cents\": 999,\n \"billing_interval\": \"month\",\n \"billing_interval_count\": 1,\n \"charge_type\": \"recurring\",\n \"currency\": \"GTQ\",\n \"free_trial_interval\": \"month\",\n \"free_trial_interval_count\": 0,\n \"id\": \"price_123\",\n \"periods_before_automatic_cancellation\": null\n }\n ],\n \"status\": \"active\",\n \"storefront_link\": \"https://app.recurrente.com/s/recurrente/plan-de-prueba\",\n \"success_url\": \"\"\n }\n}\n\nsubscription.past_due
\nSe emite cuando el cobro automático de una suscripción falla por primera vez.
\nNota: En una suscripción, cuando un pago falla, Recurrente intenta cobrarlo de nuevo 3 y 5 días después. Si ambos re-intentos son fallidos, en ese momento se cancela la suscripción.
\nEjemplo de respuesta:
\n{\n \"api_version\": \"2024-04-24\",\n \"created_at\": \"2025-10-13T13:59:27.931Z\",\n \"customer_email\": \"example@example.com\",\n \"customer_id\": \"us_1234\",\n \"customer_name\": \"Pedro Pérez\",\n \"event_type\": \"subscription.past_due\",\n \"id\": \"su_123\",\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"address\": null,\n \"id\": \"su_123\",\n \"phone_number\": \"+50255555555\",\n \"tax_id\": \"\",\n \"tax_name\": null,\n \"type\": \"Subscription\"\n }\n },\n \"product\": {\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"optional\",\n \"cancel_url\": \"\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"description\": \"Suscripción de prueba\",\n \"has_dynamic_pricing\": false,\n \"id\": \"prod_123\",\n \"metadata\": {},\n \"name\": \"Plan de Prueba\",\n \"phone_requirement\": \"required\",\n \"prices\": [\n {\n \"amount_in_cents\": 999,\n \"billing_interval\": \"month\",\n \"billing_interval_count\": 1,\n \"charge_type\": \"recurring\",\n \"currency\": \"GTQ\",\n \"free_trial_interval\": \"month\",\n \"free_trial_interval_count\": 0,\n \"id\": \"price_123\",\n \"periods_before_automatic_cancellation\": null\n }\n ],\n \"status\": \"active\",\n \"storefront_link\": \"https://app.recurrente.com/s/recurrente/plan-de-prueba\",\n \"success_url\": \"\"\n }\n}\n\nsubscription.paused
\nSe emite cuando se pausa la suscripción. Una suscripción pausada no se volverá a cobrar hasta que sea reactivada.
\nEjemplo de respuesta:
\n{\n \"api_version\": \"2024-04-24\",\n \"created_at\": \"2025-10-13T13:59:27.931Z\",\n \"customer_email\": \"example@example.com\",\n \"customer_id\": \"us_1234\",\n \"customer_name\": \"Pedro Pérez\",\n \"event_type\": \"subscription.paused\",\n \"id\": \"su_123\",\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"address\": null,\n \"id\": \"su_123\",\n \"phone_number\": \"+50255555555\",\n \"tax_id\": \"\",\n \"tax_name\": null,\n \"type\": \"Subscription\"\n }\n },\n \"product\": {\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"optional\",\n \"cancel_url\": \"\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"description\": \"Suscripción de prueba\",\n \"has_dynamic_pricing\": false,\n \"id\": \"prod_123\",\n \"metadata\": {},\n \"name\": \"Plan de Prueba\",\n \"phone_requirement\": \"required\",\n \"prices\": [\n {\n \"amount_in_cents\": 999,\n \"billing_interval\": \"month\",\n \"billing_interval_count\": 1,\n \"charge_type\": \"recurring\",\n \"currency\": \"GTQ\",\n \"free_trial_interval\": \"month\",\n \"free_trial_interval_count\": 0,\n \"id\": \"price_123\",\n \"periods_before_automatic_cancellation\": null\n }\n ],\n \"status\": \"active\",\n \"storefront_link\": \"https://app.recurrente.com/s/recurrente/plan-de-prueba\",\n \"success_url\": \"\"\n }\n}\n\nsubscription.cancel
\nSe emite cuando el cobro automático de una suscripción falla por tercera vez.
\nNota: En una suscripción, cuando un pago falla, Recurrente intenta cobrarlo de nuevo 3 y 5 días después. Si ambos re-intentos son fallidos, en ese momento se cancela la suscripción.
\nEjemplo de respuesta:
\n{\n \"api_version\": \"2024-04-24\",\n \"created_at\": \"2025-10-13T13:59:27.931Z\",\n \"customer_email\": \"example@example.com\",\n \"customer_id\": \"us_1234\",\n \"customer_name\": \"Pedro Pérez\",\n \"event_type\": \"subscription.cancel\",\n \"id\": \"su_123\",\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"address\": null,\n \"id\": \"su_123\",\n \"phone_number\": \"+50255555555\",\n \"tax_id\": \"\",\n \"tax_name\": null,\n \"type\": \"Subscription\"\n }\n },\n \"product\": {\n \"address_requirement\": \"none\",\n \"billing_info_requirement\": \"optional\",\n \"cancel_url\": \"\",\n \"custom_terms_and_conditions\": \"Términos y condiciones\",\n \"description\": \"Suscripción de prueba\",\n \"has_dynamic_pricing\": false,\n \"id\": \"prod_123\",\n \"metadata\": {},\n \"name\": \"Plan de Prueba\",\n \"phone_requirement\": \"required\",\n \"prices\": [\n {\n \"amount_in_cents\": 999,\n \"billing_interval\": \"month\",\n \"billing_interval_count\": 1,\n \"charge_type\": \"recurring\",\n \"currency\": \"GTQ\",\n \"free_trial_interval\": \"month\",\n \"free_trial_interval_count\": 0,\n \"id\": \"price_123\",\n \"periods_before_automatic_cancellation\": null\n }\n ],\n \"status\": \"active\",\n \"storefront_link\": \"https://app.recurrente.com/s/recurrente/plan-de-prueba\",\n \"success_url\": \"\"\n }\n}\n\nbank_transfer_intent.pending
\nSe emite cuando se inicia un cobro con transferencia bancaria. En cuanto se reciba el dinero en la cuenta, se emitirá bank_transfer_intent.succeeded. De lo contrario, se emitirá bank_transfer_intent.failed.
\n{\n \"id\":\"ba_123\",\n \"event_type\": \"bank_transfer_intent.pending\",\n \"api_version\": \"2024-04-24\",\n \"created_at\":\"2024-03-04T18:08:40.210Z\",\n \"customer_id\": \"us_t8nlvpwq\",\n \"customer\": {\n \"id\": \"us_t8nlvpwq\"\n },\n \"amount_in_cents\": 10000,\n \"currency\": \"GTQ\",\n \"product\": {\n \"id\":\"prod_123\"\n },\n \"checkout\": {\n \"id\": \"ch_5wlclm4jqpg3fe09\",\n \"status\": \"payment_in_progress\",\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\",\n \"id\": \"on_123\",\n \"tax_name\": \"Acme S.A.\",\n \"tax_id\": \"1234567\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"payment_method\": null,\n \"transfer_setups\": [],\n \"metadata\": {}\n },\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\", // Deprecated, no usar\n \"id\": \"on_123\", // Deprecated, no usar\n \"tax_name\": \"Acme S.A.\",\n \"tax_id\": \"1234567\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"tax_invoice_url\": null\n}\n\nbank_transfer_intent.succeeded
\nSe emite con un cobro exitoso con transferencia bancaria. Los fondos ya están en tu balance de Recurrente.
\n{\n \"id\":\"ba_123\",\n \"event_type\": \"bank_transfer_intent.succeeded\",\n \"api_version\": \"2024-04-24\",\n \"created_at\":\"2024-03-04T18:08:40.210Z\",\n \"customer_id\": \"us_t8nlvpwq\",\n \"customer\": {\n \"id\": \"us_t8nlvpwq\"\n },\n \"amount_in_cents\": 10000,\n \"currency\": \"GTQ\",\n \"product\": {\n \"id\":\"prod_123\"\n },\n \"checkout\": {\n \"id\": \"ch_5wlclm4jqpg3fe09\",\n \"status\": \"paid\",\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\",\n \"id\": \"on_123\",\n \"tax_name\": \"Acme S.A.\",\n \"tax_id\": \"1234567\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"payment_method\": {\n \"id\": \"pay_m_zmbxckyn\",\n \"type\": \"bank_transfer_receiver\",\n \"bank_transfer_receiver\": {}\n },\n \"transfer_setups\": [],\n \"metadata\": {}\n },\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\", // Deprecated, no usar\n \"id\": \"on_123\", // Deprecated, no usar\n \"tax_name\": \"Acme S.A.\",\n \"tax_id\": \"1234567\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"tax_invoice_url\": null\n}\n\nbank_transfer_intent.failed
\nSe emite con un cobro fallido con transferencia bancaria. Esto sucede cuando no se reciben los fondos en la cuenta de banco, o se recibe el monto incorrecto.
\n{\n \"id\":\"ba_123\",\n \"event_type\": \"bank_transfer_intent.failed\",\n \"api_version\":\"2023-08-29\",\n \"created_at\":\"2024-03-04T18:08:40.210Z\",\n \"customer_id\": \"us_t8nlvpwq\",\n \"customer\": {\n \"id\": \"us_t8nlvpwq\"\n },\n \"amount_in_cents\": 10000,\n \"currency\": \"GTQ\",\n \"product\": {\n \"id\":\"prod_123\"\n },\n \"checkout\": {\n \"id\": \"ch_5wlclm4jqpg3fe09\",\n \"status\": \"unpaid\",\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\",\n \"id\": \"on_123\",\n \"tax_name\": \"Acme S.A.\",\n \"tax_id\": \"1234567\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"payment_method\": null,\n \"transfer_setups\": [],\n \"metadata\": {}\n },\n \"payment\": {\n \"id\": \"pa_123\",\n \"paymentable\": {\n \"type\": \"OneTimePayment\", // Deprecated, no usar\n \"id\": \"on_123\", // Deprecated, no usar\n \"tax_name\": \"Acme S.A.\",\n \"tax_id\": \"1234567\",\n \"address\": {\n \"address_line_1\": \"Plaza Obelisco\",\n \"address_line_2\": null,\n \"city\": \"Guatemala\",\n \"country\": \"Guatemala\",\n \"zip_code\": \"01010\"\n },\n \"phone_number\": \"5555-5555\"\n }\n },\n \"tax_invoice_url\": null\n}\n\nsetup_intent.succeeded
\nSe emite cuando se inicia exitosamente una suscripción con un período de prueba. También se emite cuando se tokeniza una tarjeta sin cobrarla.
\n{\n \"api_version\":\"2024-03-13\",\n \"created_at\":\"2024-04-10T10:31:45.806-06:00\",\n \"event_type\":\"setup_intent.succeeded\",\n \"status\":\"succeeded\",\n \"suscription\":{\n \"id\":\"su_vh8v33ac\"\n }\n}\n\nsetup_intent.cancelled
\nSe emite cuando no se logra tokenizar una tarjeta sin cobrarla. Esto sucede cuando el primer pago de una suscripción con período de prueba, falla.
\n{\n \"api_version\":\"2024-03-13\",\n \"created_at\":\"2024-04-10T10:31:45.806-06:00\",\n \"event_type\":\"setup_intent.cancelled\",\n \"status\":\"cancelled\",\n \"suscription\":{\n \"id\":\"su_vh8v33ac\"\n }\n}\n\nLa moneda a cobrar.
\nPosibles valores son:
\nMonto a cobrar en centavos.
\n"},{"key":"custom_account_id","value":"ac_123456","description":"(Opcional) El ID de la cuenta que va a crear el checkout. Debe ser una cuenta conectada (hija).
\nSi lo dejas en blanco, sera tu cuenta quien creará el checkout.
\n","type":"text"},{"key":"transfer_setups[][amount_in_cents]","value":"100","description":"(Opcional) Monto en centavos a enviar a otra cuenta después de un pago exitoso.
\n","type":"text"},{"key":"transfer_setups[][recipient_id]","value":"","description":"(Opcional) El ID de la cuenta a la cuál se va a enviar el monto definido anteriormente al recibir un pago exitoso. Puede ser cualquier cuenta de Recurrente.
\nSi se queda en blanco, se usará el ID de tu cuenta como default, y el monto en centavos se te transferirá a ti.
\n","type":"text"}]},"url":"https://app.recurrente.com/api/checkouts/","urlObject":{"protocol":"https","path":["api","checkouts",""],"host":["app","recurrente","com"],"query":[{"disabled":true,"key":" ","value":null}],"variable":[]}},"response":[{"id":"45bc2a4a-78c6-46e5-a654-3696d02e2bcb","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[{"key":"items[][currency]","value":"GTQ","type":"text","description":"La moneda a cobrar.\n\nPosibles valores son:\n- GTQ\n- USD"},{"key":"items[][amount_in_cents]","value":"3000","type":"text","description":"Monto a cobrar en centavos."},{"key":"custom_account_id","value":"ac_123456","description":"El ID de la cuenta que va a crear el checkout. Debe ser mi cuenta o una cuenta conectada (hija).","type":"text"},{"key":"transfer_setups[][amount_in_cents]","value":"100","description":"(Opcional) Monto en centavos a enviar a otra cuenta después de un pago exitoso.","type":"text"},{"key":"transfer_setups[][recipient_id]","value":"","description":"(Opcional) El ID de la cuenta a la cuál se va a enviar el monto definido anteriormente al recibir un pago exitoso. Puede ser cualquier cuenta de Recurrente.\n\nSi se queda en blanco, se usará el ID de tu cuenta como default, y el monto en centavos se te transferirá a ti.","type":"text"}]},"url":"https://app.recurrente.com/api/checkouts/"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ch_672wumotzeuqqyzf\",\n \"checkout_url\": \"https://app.recurrente.com/checkout-session/ch_672wumotzeuqqyzf\"\n}"}],"_postman_id":"00127df5-bcaa-4da6-8c00-1cb2edc336d8"}],"id":"d167128f-dc3d-49b7-bd5b-71bfcb29a81c","description":"Si estás construyendo una plataforma o un marketplace, y quieres:
\nCobrar en nombre de alguien más o;
\nCompartir los ingresos de las ventas con otras cuentas
\nLa funcionalidad de \"Cuentas conectadas\" es para ti.
\n👨💻 Con Cuentas Conectadas puedes realizar cobros en nombre de otras cuentas utilizando tus propias Llaves API, sin necesidad de acceder ni utilizar las llaves API de esas cuentas.
\nEsto se debe hacer a través del UI de Recurrente. Sigue las intrucciones aquí.
\nA través de Webhooks, recibirás eventos con los parámetros connected: true y account_id: ac_123456 con lo que podrás identificar el evento y la cuenta que lo generó.
Para ver la versión más actualizada de esta guía, visita el repo: https://github.com/recurrente/recurrente-checkout
\nRecurrente Checkout es una librería JavaScript que te permite insertar un checkout responsivo y seguro en tu propia página web. Funciona mostrando un iframe con tu sesión de pago y maneja callbacks para eventos clave como éxito, fallo o pagos en proceso.
\nPara ver un video de cómo funciona: https://youtu.be/OUIYVcrnPr0
\nAntes de comenzar: Para usar esta biblioteca, necesitas crear un checkout en Recurrente. Consulta la documentación de creación de checkouts para obtener tu URL de checkout.
\nnpm install recurrente-checkout\n\n⚠️ En producción, recomendamos usar una versión específica (por ejemplo, @0.0.4) en lugar de @latest, para evitar romper integraciones al actualizar automáticamente.
\n<script src=\"https://unpkg.com/recurrente-checkout@latest/recurrente-checkout.js\"></script>\n\n<script src=\"https://cdn.jsdelivr.net/npm/recurrente-checkout@latest/recurrente-checkout.js\"></script>\n\n¿Dónde aparece el checkout?
\nEl checkout de Recurrente se renderiza como un iframe que se inserta automáticamente en el elemento HTML con el ID recurrente-checkout-container. Asegúrate de tener este elemento en tu página:
<div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' id=\"recurrente-checkout-container\"></div>\n\nEl iframe se ajustará automáticamente al tamaño del contenedor y será responsive. Puedes personalizar la apariencia aplicando estilos CSS al contenedor.
\nimport RecurrenteCheckout from 'recurrente-checkout';\nRecurrenteCheckout.load({\n url: \"https://app.recurrente.com/checkout-session/ch_1234\",\n onSuccess: function(paymentData) {\n console.log('Pago exitoso:', paymentData);\n // Manejar pago exitoso\n // ej., redirigir a página de éxito, actualizar UI, etc.\n },\n onFailure: function(error) {\n console.log('Pago fallido:', error);\n // Manejar pago fallido\n // ej., mostrar mensaje de error, opción de reintentar, etc.\n },\n onPaymentInProgress: function() {\n console.log('Pago con transferencia bancaria en proceso');\n // Este callback se ejecuta solo para transferencias bancarias\n // El pago puede tomar hasta 24 horas en procesarse\n // ej., mostrar mensaje informativo, enviar email de confirmación, etc.\n }\n});\n\nimport { loadRecurrenteCheckout } from 'recurrente-checkout';\nloadRecurrenteCheckout({\n url: \"https://app.recurrente.com/checkout-session/ch_1234\",\n onSuccess: function(paymentData) {\n console.log('Pago exitoso:', paymentData);\n },\n onFailure: function(error) {\n console.log('Pago fallido:', error);\n },\n onPaymentInProgress: function() {\n console.log('Pago con transferencia bancaria en proceso');\n // Solo para transferencias bancarias (puede tomar hasta 24h)\n }\n});\n\nconst RecurrenteCheckout = require('recurrente-checkout');\nRecurrenteCheckout.load({\n url: \"https://app.recurrente.com/checkout-session/ch_1234\",\n onSuccess: function(paymentData) {\n console.log('Pago exitoso:', paymentData);\n },\n onFailure: function(error) {\n console.log('Pago fallido:', error);\n },\n onPaymentInProgress: function() {\n console.log('Pago con transferencia bancaria en proceso');\n // Solo para transferencias bancarias (puede tomar hasta 24h)\n }\n});\n\n<script src=\"https://unpkg.com/recurrente-checkout@latest/recurrente-checkout.js\"></script>\n<script>\n RecurrenteCheckout.load({\n url: \"https://app.recurrente.com/s/your-checkout-url\",\n onSuccess: function(paymentData) {\n console.log('Pago exitoso:', paymentData);\n },\n onFailure: function(error) {\n console.log('Pago fallido:', error);\n },\n onPaymentInProgress: function() {\n console.log('Pago con transferencia bancaria en proceso');\n // Solo para transferencias bancarias (puede tomar hasta 24h)\n }\n });\n</script>\n\nElige uno de los métodos de instalación anteriores.
\nElige uno de los dos métodos de integración:
\nRecurrenteCheckout.load({\n url: \"https://app.recurrente.com/checkout-session/ch_1234\",\n onSuccess: function(paymentData) {\n console.log('Pago exitoso:', paymentData.checkoutId);\n // Manejar pago exitoso\n // ej., redirigir a página de éxito, actualizar UI, etc.\n },\n onFailure: function(data) {\n console.log('Pago fallido:', data.error);\n // Manejar pago fallido\n // ej., mostrar mensaje de error, opción de reintentar, etc.\n },\n onPaymentInProgress: function() {\n console.log('Pago con transferencia bancaria en proceso');\n // Este callback se ejecuta solo para transferencias bancarias\n // El pago puede tomar hasta 24 horas en procesarse\n // ej., mostrar mensaje informativo, enviar email de confirmación, etc.\n }\n});\n\nTambién puedes usar una URL de producto con el formato https://app.recurrente.com/s/{organization}/{product-slug}:
RecurrenteCheckout.load({\n url: \"https://app.recurrente.com/s/mi-cuenta/mi-producto\",\n onSuccess: function(paymentData) {\n console.log('Pago exitoso:', paymentData);\n // Manejar pago exitoso\n // ej., redirigir a página de éxito, actualizar UI, etc.\n },\n onFailure: function(error) {\n console.log('Pago fallido:', error);\n // Manejar pago fallido\n // ej., mostrar mensaje de error, opción de reintentar, etc.\n },\n onPaymentInProgress: function() {\n console.log('Pago con transferencia bancaria en proceso');\n // Este callback se ejecuta solo para transferencias bancarias\n // El pago puede tomar hasta 24 horas en procesarse\n // ej., mostrar mensaje informativo, enviar email de confirmación, etc.\n }\n});\n\nNota: Reemplaza mi-cuenta con tu slug de organización y mi-producto con tu slug de producto.
Encuentra este valor en el payload de un webhook exitoso, o al hacer GET /checkout en un checkout exitoso
\n","type":"text","uuid":"344160b7-43da-4b42-a964-b0e1e58dda35"},{"key":"items[][currency]","value":"GTQ","type":"text","description":"La moneda a cobrar.
\nPosibles valores son:
\nMonto a cobrar en centavos.
\n"},{"key":"items[][name]","value":"One Ripe Banana","type":"text","description":"(Opcional) El nombre del producto.
\n"},{"key":"items[][image_url]","value":"https://source.unsplash.com/400x400/?banana","type":"text","description":"(Opcional) URL de la imagen del producto.
\n"},{"key":"items[][quantity]","value":"1","type":"text","description":"(Opcional) Cantidad.
\nSi no incluyes una, el default es 1.
\nEl valor mínimo es 1 y el valor máximo es 9.
\n"}]},"url":"https://app.recurrente.com/api/one_time_payments/","urlObject":{"protocol":"https","path":["api","one_time_payments",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"7927d730-8978-424b-860d-ad429bcebe13","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"items\": [\n {\n \"name\": \"One Ripe Banana\",\n \"currency\": \"GTQ\",\n \"amount_in_cents\": 3000,\n \"image_url\": \"https://source.unsplash.com/400x400/?banana\",\n \"quantity\": 1\n }\n ],\n \"success_url\": \"https://www.google.com\",\n \"cancel_url\": \"https://www.amazon.com\",\n \"user_id\": \"us_123456\",\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/one_time_payments"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"on_123456789\",\n \"status\": \"paid\"\n}"}],"_postman_id":"2325c9d4-a0e3-40fe-8d62-2f69e5f66513"},{"name":"Create a one time payment (Product ID)","id":"a04c9349-2253-422b-86d7-439fd5f33aa0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"payment_method_id","value":"pay_m_l1aqgfoq","type":"text","description":"Encuentra este valor en el payload de un webhook exitoso, o al hacer GET /checkout en un checkout exitoso
\n"},{"key":"items[][product_id]","value":"prod_1234567","type":"text","description":"Crea un producto primero, y luego utiliza el ID del producto.
\n"},{"key":"items[][quantity]","value":"1","description":"(Opcional) Cantidad. \nSi no incluyes una, el default es 1.\nEl valor mínimo es 1
\n","type":"text","uuid":"37cbceb3-d6af-4acd-9d93-a9a37d5f298e"}]},"url":"https://app.recurrente.com/api/checkouts/","urlObject":{"protocol":"https","path":["api","checkouts",""],"host":["app","recurrente","com"],"query":[],"variable":[]}},"response":[{"id":"36fbd0d8-2c78-406b-b231-8c72a87126ae","name":"Respuesta exitosa","originalRequest":{"method":"POST","header":[{"key":"X-PUBLIC-KEY","value":"{{recurrente_public_key}}","type":"text"},{"key":"X-SECRET-KEY","value":"{{recurrente_private_key}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"items\": [\n {\n \"product_id\": \"prod_123456\"\n }\n ],\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://app.recurrente.com/api/one_time_payments"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"on_123456789\",\n \"status\": \"paid\"\n}"}],"_postman_id":"a04c9349-2253-422b-86d7-439fd5f33aa0"}],"id":"c6846c83-48f7-4b86-8200-24628b99ea10","description":"Si quieres hacer un cobro a un cliente existente, usa tokenized payments.
\n","_postman_id":"c6846c83-48f7-4b86-8200-24628b99ea10"}],"event":[{"listen":"prerequest","script":{"id":"d9dee7a4-287f-4f4e-b1b6-d5a5676e771d","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7ef0db4f-6e90-440a-9599-239e78f88089","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://app.recurrente.com/api"},{"key":"checkoutId","value":"ch_eegw9j5zgqoae3ms","disabled":true},{"key":"productId","value":"prod_9lstwgbr","disabled":true},{"key":"priceId","value":"price_mirvwr9y","disabled":true}]}