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. |
Stripe mantiene claves separadas para el modo de Prueba y Activo (pk_test_ / sk_test_ versus pk_live_ / sk_live_), cada una con su propio secreto de firma de webhook. Coin Moebius sostiene ambas en las pestanas de Activo y Prueba, por lo que puedes verificar con claves de prueba y agregar claves activas mas tarde sin reescribir 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 nuevo en Coin Moebius: Anade proveedor → Stripe
En tu proyecto, abre la pestaña Providers y haz clic en Add provider. Elige Connect a service, luego elige Stripe (escribe "Stripe" en el cuadro de busqueda si no lo ves).
Coin Moebius → Providers → Add provider - Pega tus claves y secreto, luego Guarda
En el formulario Connect Stripe, establece tu Success URL y Cancel URL (donde aterrizan los compradores despues de pagar o retroceder). En la pestaña Live, pega tu clave Publishable, clave Secret y el secreto de firma de webhook que copiaste anteriormente, luego haz clic en Save. Primero, verificas las claves de prueba. Pegalas en la pestaña Test, luego anade las claves activas mas tarde desde Edit.
Coin Moebius → Add provider → Stripe - 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
Ejecuta un pago de prueba antes de activar:
- Con el proveedor conectado usando tus claves de prueba, cada pago es un pago de prueba.
- 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.
Luego edita el proveedor, cambia tus claves activas y estaras aceptando pagos reales.
Resolucion de problemas
Comienza con Verify. En el panel de control, haz clic en Verify en el proveedor. Verifica tus claves contra Stripe y devuelve un mensaje especifico si algo esta mal.
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
Rotating keys. Genera una nueva clave secreta o secreto de webhook en cualquier momento, luego pega el valor nuevo. Los campos secretos permanecen en blanco al editar para que puedas dejar 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