Saltar al contenido principal
Commet puede procesar pagos a través de su propio rail o de una cuenta de payment service provider (PSP) que conectes. La API de billing y el checkout siguen siendo los mismos; la conexión determina dónde se procesa el pago y qué identidad de merchant aplica.

Conectar un proveedor desde el dashboard

Abre Settings → Payments en tu dashboard de Commet. La página muestra los proveedores conectados a tu organización, los países asignados a cada uno y el proveedor predeterminado. Para conectar tu propia cuenta:
  1. Selecciona Add payment provider.
  2. Elige Stripe o dLocal.
  3. Ingresa las credenciales del modo actual de la organización.
  4. Guarda la conexión. Commet valida las credenciales y las almacena encriptadas.
  5. Agrega los datos del emisor de recibos del proveedor antes de asignarle países o convertirlo en el predeterminado.
Commet registra y consume los webhooks del proveedor necesarios para mantener sincronizados pagos, reembolsos, disputas y eventos de configuración. No necesitas crear una segunda integración de billing para la cuenta conectada.

Conectar varias cuentas del mismo proveedor

Una organización puede conectar más de una cuenta de Stripe o de dLocal, por ejemplo una cuenta de dLocal para Argentina y otra para Brasil y México. Cada cuenta adicional empieza sin países y no es la predeterminada. Ponle una etiqueta a cada cuenta con Edit alias en su menú y luego asigna sus países en Payment routing. Cuando tienes varias cuentas del mismo proveedor, Payment routing muestra el ID de cada conexión (pcon_...) para copiarlo. Para fijar el primer checkout de una suscripción a una cuenta, envía su ID de conexión como provider al crear la suscripción. provider: "stripe" o "dlocal" usa la cuenta conectada más antigua de ese proveedor.

Credenciales de Stripe

Ingresa la secret key y la publishable key de la cuenta de Stripe que te pertenece. En sandbox, usa claves sk_test_... y pk_test_.... En live, usa claves sk_live_... y pk_live_.... Commet rechaza claves de un modo incorrecto.

Credenciales de dLocal

Ingresa las credenciales emitidas para el entorno correspondiente de dLocal: X-Login, X-Trans-Key, Secret Key y la API key (dlocal.js). Commet valida la cuenta antes de guardar la conexión.

Elegir métodos de pago por conexión

Las conexiones de Stripe y Commet aceptan tarjetas. Una conexión de dLocal también puede ofrecer métodos locales; cada uno aplica solo a esa conexión. Abre Settings → Payments, abre el menú de la conexión y elige Payment methods. Habilita un método en tu cuenta de dLocal antes de activarlo en Commet. Un método de un país aparece en Not available for this connection hasta que ese país se asigna a la conexión. Google Pay pide el dLocal gateway merchant ID, el Google merchant ID (opcional en sandbox) y el Business name que ven los compradores. El paymentMethod de cada transacción indica el método usado: card, google_pay, mercado_pago, oxxo o smartpix.

Mercado Pago

El cliente autoriza Mercado Pago una sola vez en el checkout. Commet cobra el primer pago cuando la autorización está activa y cobra las renovaciones con ella automáticamente. Si el cliente revoca la autorización en Mercado Pago, la suscripción termina al final de su período, o pasa al plan predeterminado del grupo de planes cuando tiene uno. Para mantener el plan, el cliente vuelve a autorizar Mercado Pago desde el Portal del Cliente.

OXXO

OXXO es un voucher para pagar en efectivo. El checkout lo muestra en la misma página con el monto, la fecha de vencimiento, el código de barras y la referencia, que el cliente puede copiar o guardar. La suscripción se activa cuando dLocal confirma el pago. El efectivo no puede renovarse. Una suscripción pagada con OXXO y sin otro método de pago guardado termina después de sus períodos pagados salvo que el cliente agregue una tarjeta. Combina OXXO con Pagar por adelantado para vender varios períodos con un solo voucher.

Credenciales sandbox y live

Las credenciales sandbox y live pertenecen a entornos de pago distintos. Mantén las credenciales de prueba en la organización sandbox de Commet y las credenciales reales en la organización live. Nunca copies un secret live en sandbox ni una clave de prueba en live. La cuenta del proveedor también forma parte de la conexión. Una cuenta Stripe sandbox y una cuenta Stripe live son destinos de pago distintos aunque pertenezcan al mismo equipo. Verifica el dashboard del proveedor y el modo de las claves antes de probar un checkout.

Un modelo unificado de transacciones

Commet usa el mismo modelo de billing y transacciones para todos los proveedores. En el dashboard, Transactions es la vista central para consultar el estado del pago, importe, cliente, recibo y eventos del ciclo de vida. La API y los webhooks exponen el proveedor que procesó el pago como stripe, commet o dlocal. Commet sigue gestionando el ciclo de billing alrededor del proveedor: recibos, estado de suscripciones, retries, recovery links, reembolsos y eventos de webhook normalizados. Los errores específicos del proveedor se conservan como códigos de falla, mientras que el estado del pago que ve el cliente se mantiene consistente. El registro de la transacción se centraliza en Commet, pero los fondos no se mezclan entre proveedores. La cuenta conectada de Stripe o dLocal mantiene sus propios cobros, comisiones, disputas y payouts. El rail de Commet mantiene los registros correspondientes a los cobros procesados por Commet.

Agregar o reemplazar un proveedor sin migrar billing

Agregar un proveedor no migra clientes, recibos, suscripciones ni métodos de pago. Conecta el proveedor, configura sus datos de emisor y asígnale países para la actividad nueva. Los cambios de routing aplican a los cobros nuevos. Una suscripción con un método de pago guardado sigue usando la conexión donde se guardó ese método y Commet no lo copia a otro proveedor. Así evitas cobrar a un cliente existente desde una cuenta inesperada. Si una conexión ya tiene historial de pagos, Commet no la elimina físicamente. Déjala conectada para conservar su historial y enruta países nuevos o clientes nuevos a otro proveedor. Para mover un cliente existente, usa un checkout nuevo o el Portal del Cliente para recopilar un método de pago en la nueva conexión; esto es una nueva configuración del método, no una migración de base de datos. Consulta Payment Orchestration para entender el routing por país, los valores predeterminados y los métodos de pago asociados a un proveedor.