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:- Selecciona Add payment provider.
- Elige Stripe o dLocal.
- Ingresa las credenciales del modo actual de la organización.
- Guarda la conexión. Commet valida las credenciales y las almacena encriptadas.
- Agrega los datos del emisor de recibos del proveedor antes de asignarle países o convertirlo en el predeterminado.
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 clavessk_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 comostripe, 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.