La manera más fácil: inicia sesión con Stripe
No hay llaves que buscar, nada que pegar. Inicia sesión en Stripe, aprueba Coin Moebius y regresa en aproximadamente un minuto. Coin Moebius conserva solo su ID de cuenta Stripe, nunca sus claves, y Stripe nos informa en el momento en que cambia algo relacionado con su cuenta.
- Abra Proveedores y haga clic en Connect a provider
En el panel Coin Moebius, elija Proveedores en el menú de la izquierda, luego haga clic en Connect a provider en la parte superior derecha.
Coin Moebius → Proveedores → Connect a provider - Elige Stripe
Escriba Stripe en el cuadro de búsqueda, o desplácese hacia abajo y haga clic en él.
Connect a provider → Stripe - Nómbrelo, agregue sus dos páginas y guárdelo.
Dale un apodo a la conexión. Ingrese su URL de éxito (la página que ve un comprador después de pagar) y su URL de cancelación (la página que ve si se retira). Permanezca en la primera pestaña y luego haga clic en Save and connect with Stripe.
Apodo, URL de éxito, URL de cancelación → Save and connect with Stripe Ambas direcciones deben comenzar con https://. Son las únicas cosas que escribes en esta pantalla.
- Aprobar el Stripe
Se abre Stripe. Inicie sesión en su cuenta Stripe, o cree una allí mismo si aún no tiene una, luego apruebe Coin Moebius. Stripe muestra qué cuenta estás a punto de usar, para que puedas verificarla antes de decir que sí.
Stripe → iniciar sesión o crear una cuenta → aprobar Coin Moebius - Estás de vuelta y conectado.
Stripe te envía directamente de regreso a Coin Moebius. Un cheque verde significa que los pagos con tarjeta están listos y la tarjeta Stripe ahora se encuentra en su página de Proveedores marcada como Verificada y Activa.
De vuelta en Coin Moebius: cuenta Stripe conectada Proveedores → tu tarjeta Stripe: verificada, en vivo ¿Viste "Acción requerida" en lugar del cheque verde? Stripe no ha terminado de limpiar tu cuenta para pagos con tarjeta. Termina lo que Stripe te pide, regresa y haz clic en Verify en la tarjeta Stripe.
Al revés: pega tus propias claves
Todo desde aquí hacia abajo es el camino manual. Configura un webhook en su panel Stripe, recopila tres valores allí y los pega en Coin Moebius. Planifique unos diez minutos. Si inició sesión arriba, ya ha terminado y puede omitir todo esto.
Lo que necesitas
| Campo | Que hace |
|---|---|
| Publishable key (pk_…) | Clave publica que abre el Checkout en el navegador del comprador. No es secreta. |
| Secret key (sk_…) | Nos permite crear la sesion de Checkout para que el cargo se ejecute a traves de tu cuenta. Secreta. |
| Webhook signing secret (whsec_…) | Confirma que un webhook realmente proviene de Stripe. Secreta. |
| Success URL / Cancel URL | Donde aterriza el comprador despues de pagar o retroceder. |
Sólo la ruta clave los necesita. Si inició sesión con Stripe arriba, no hay nada que cobrar. Stripe mantiene claves separadas para el modo de prueba y en vivo (pk_test_ / sk_test_ versus pk_live_ / sk_live_), cada una con su propio secreto de firma de webhook. Coin Moebius se mantiene en las pestañas En vivo y Prueba, por lo que puedes verificar las claves de prueba y agregar claves en vivo más tarde sin tener que volver a ingresar todo.
Por que pedimos cada campo
Publishable key
Identifica tu cuenta cuando el checkout se abre en el navegador del comprador. Publica por diseno.
Secret key
La mitad privada que autoriza crear el cargo, por lo que el pago se ejecuta a traves de tu cuenta.
Webhook signing secret
Prueba que un webhook entrante es genuinamente de Stripe, por lo que nadie puede falsificar un evento "pagado". Es un valor separado de la clave secreta.
Success and Cancel URL
Configuracion simple: donde aterriza el comprador despues de pagar o retroceder. No es secreta.
Configurar
- Comienza en Coin Moebius: copia tu URL de webhook
Abre tu proyecto en el panel de control de Coin Moebius. Tu ID de Proyecto se encuentra justo debajo del nombre del proyecto; haz clic en el icono de copiar junto a el. Tu URL de webhook de Stripe es ese ID insertado en la direccion de abajo. Mantenlo a mano, lo pegars en Stripe en un momento.
https://api.coinmoebius.com/webhook/stripe/<your project id>Coin Moebius → tu proyecto → Project ID Configuramos el webhook primero a proposito. Stripe solo revela el secreto de firma de webhook despues de que exista el webhook, y crear ese webhook requiere esta URL (con tu ID de proyecto). Entonces el orden es: construye el webhook, copia su secreto, luego obtén tus claves de API.
- En Stripe, abre Webhooks
Inicia sesion en dashboard.stripe.com. Ruta mas rapida: escribe "webhooks" en la barra de busqueda en la parte superior y elige Webhooks bajo Workbench. (También puedes alcanzarlo desde el engranaje → Developers → Webhooks.)
Stripe → busca "webhooks" → Webhooks - Anade un destino
En la pantalla de Webhooks, haz clic en Add destination. Esto abre el asistente "Create an event destination" de Stripe, una secuencia de tres pantallas cortas.
Stripe → Webhooks → Add destination - Selecciona los eventos a enviar
Deja el alcance del evento en Your account. En el cuadro de busqueda de Eventos, encuentra y marca los eventos que Coin Moebius escucha, luego haz clic en Continue. Como minimo, anade checkout.session.completed.
- Pagos puntuales: checkout.session.completed, charge.refunded, charge.dispute.created.
- Suscripciones (solo si las vendes): customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed.
Stripe → Create an event destination → Select events Los eventos extra son inofensivos, ignoramos cualquier cosa que no usemos.
- Elige "Webhook endpoint"
Para el tipo de destino, elige Webhook endpoint (no Amazon EventBridge ni Azure Event Grid), luego haz clic en Continue.
Stripe → Choose destination type → Webhook endpoint - Pega tu URL de webhook de Coin Moebius
Dale al destino un nombre que reconoceras, como "Coin Moebius Webhook." En el campo Endpoint URL, pega la URL de webhook del paso 1 (tu direccion con tu ID de proyecto). Luego haz clic en Create destination.
https://api.coinmoebius.com/webhook/stripe/<your project id>Stripe → Configure destination → Endpoint URL - Copia el secreto de firma (whsec_…)
Stripe crea el destino y abre su pagina de detalles. A la derecha, bajo Signing secret, haz clic en el icono de revelacion (ojo) y copia el valor whsec_…. Apartalo junto con tu URL de webhook.
Stripe → tu destino → Signing secret Este es el valor que no podias obtener hasta ahora, solo existe una vez que se crea el webhook. Por eso el webhook vino primero.
- Ahora encuentra tus claves de API
Con el webhook listo, recopila tus dos claves. En Stripe, haz clic en el engranaje (Settings) en la esquina superior derecha, abre Developers bajo Personal settings, luego haz clic en Manage API keys.
1. Stripe → gear (Settings), esquina superior derecha 2. Settings → Developers 3. Developers → Manage API keys - Copia la clave Publishable y la clave Secret
Bajo Standard keys, copia la clave Publishable (pk_…) y la clave Secret (sk_…). Una clave secreta se muestra en su totalidad solo cuando se crea por primera vez, por lo que si la tuya esta oculta, genera una nueva y copiala de inmediato. Ignora la seccion Restricted keys.
Stripe → Developers → API keys → Standard keys Las claves activas comienzan con pk_live_ / sk_live_; las claves del modo de prueba comienzan con pk_test_ / sk_test_. Copia el conjunto que coincida con el modo que estas configurando.
- De vuelta en Coin Moebius: Connect a provider → Stripe
Abra Proveedores en el menú de la izquierda y haga clic en Connect a provider. Escriba Stripe en el cuadro de búsqueda, o desplácese hacia abajo y haga clic en él.
Coin Moebius → Proveedores → Connect a provider → Stripe - Pega tus claves y secreto, luego Guarda
Asigne un apodo a la conexión y cambie a la pestaña Enter keys manually. En la pestaña En vivo, pegue su clave publicable, su clave secreta y el secreto de firma del Webhook que copió anteriormente. Establezca su URL de éxito y URL de cancelación (donde llegan los compradores después de pagar o retirarse), luego haga clic en Guardar. ¿Verificar primero las claves de prueba? Péguelos en la pestaña Prueba y luego agregue claves activas más tarde desde Edit.
Coin Moebius → Connect a provider → Stripe → Enter keys manually - Estas conectado
Stripe ahora aparece en tu pestaña Providers con la fecha en que se conecto. La tarjeta muestra la misma URL de webhook que pegaste en Stripe (util si alguna vez necesitas reescribirla), mas opciones de Edit y Disconnect.
Coin Moebius → Providers → Stripe (connected) - Prueba antes de activar
Para verificar sin mover dinero real, cambia Stripe al modo de Prueba (o un sandbox) desde el menu de cuenta en la esquina superior izquierda, y conecta usando tus claves de prueba y un webhook del modo de prueba. Las tarjetas de prueba nunca cobran una tarjeta real: usa cualquier fecha de vencimiento futura, cualquier CVC, cualquier codigo postal.
Result Card Succeeds 4242 4242 4242 4242 Needs authentication 4000 0025 0000 3155 Declined 4000 0000 0000 9995 Stripe → account menu → Switch to sandbox / Test mode
Despues que conectes
Realice un pago antes de comenzar a funcionar:
- ¿Has iniciado sesión con Stripe? Su cuenta está activa, así que compre un producto de un dólar con su propia tarjeta y luego reembolselo desde Stripe. ¿Claves de prueba pegadas? Cada pago es un pago de prueba, así que utilice una tarjeta de prueba de arriba.
- Crea un producto y coloca el boton de compra en una pagina (funciona un archivo HTML local) apuntando a tu proyecto.
- Compra con una tarjeta de prueba de arriba.
- Abre la pestaña Transactions. Cuando el estado de la nueva fila alcanza succeeded, tus claves y webhook estan funcionando de extremo a extremo.
Si utilizó claves de prueba, edite el proveedor, intercambie sus claves reales y recibirá pagos reales.
Resolucion de problemas
Comience con Verify. En el panel, haga clic en Verify en la tarjeta Stripe. Le pregunta a Stripe sobre su cuenta, o verifica sus claves y devuelve un mensaje específico si algo no funciona.
Inicié sesión con Stripe y apareció "Cuenta conectada. Se requiere acción".
Su cuenta Stripe está conectada pero Stripe aún no la ha autorizado para pagos con tarjeta. Abra Stripe, complete lo que solicita (generalmente detalles comerciales o una cuenta bancaria), luego haga clic en Verify en la tarjeta Stripe en Coin Moebius.
La tarjeta Stripe dice Desconectado.
Coin Moebius fue eliminado de su cuenta Stripe, generalmente desde la página de Aplicaciones autorizadas en Stripe. Abra la tarjeta, elija Edit y haga clic en Reconnect para aprobarla nuevamente.
Verify dice que el formato de la clave es incorrecto.
Las claves secretas comienzan con sk_test_ o sk_live_ (las claves restringidas comienzan con rk_). El secreto de firma de webhook comienza con whsec_. Vuelve a copiar el valor correcto en el campo correcto.
Verify dice que Stripe rechazo la clave.
Vuelve a copiar la clave secreta de Developers → API keys, y asegurate de que no estes emparejando una clave de prueba con un secreto de webhook activo o al reves.
El pago se completa pero el pedido permanece pendiente.
El webhook no llega. Confirma que la URL del punto final coincida exactamente, que hayas seleccionado checkout.session.completed y que un pago de prueba este llegando a tu punto final del modo de prueba (el modo de prueba y activo son puntos finales separados).
Signature verification fails.
Cada punto final de Stripe tiene su propio secreto de firma. Copia el whsec_ de la configuracion de este punto final, no de otro punto final.
Confirm it end to end.
Stripe no tiene un boton de simulacion. En el Panel de control de Stripe, reenvía un evento reciente a tu punto final o crea un PaymentIntent de prueba, luego observa la actualizacion del pedido.
Bueno saber
Inicia sesión con Stripe. No hay claves ni secretos de webhooks para copiar, almacenar o rotar. Stripe le avisa a Coin Moebius cuando cambia su cuenta. Para cortar el enlace, haga clic en Disconnect en la tarjeta Stripe o elimine Coin Moebius en Aplicaciones autorizadas en Stripe.
Rotating keys. ¿Pegaste tus propias llaves? Utilice la clave secreta o el webhook secreto en cualquier momento y luego pegue el nuevo valor. Los campos secretos permanecen en blanco al editarlos para que pueda ingresar una clave rotada.
Activation. Las claves activas funcionan solo una vez que tu cuenta este activada para pagos. Las claves de prueba funcionan inmediatamente.
Preguntas Join our Discord