App personalizada de Shopify

Modelo de integración

La integración Shopify usa el flujo de app del Shopify V2 Dev Dashboard. El merchant proporciona una vez un token de Shopify Partner CLI para que MakeCrypto pueda crear la app fija MakePay en Shopify Dev Dashboard con Shopify CLI. MakeCrypto lee automáticamente el Client ID generado. Shopify sigue mostrando el Client secret solo dentro del Dev Dashboard, así que el merchant copia ese secreto en MakeCrypto antes del despliegue.

Después de desplegar e instalar la app, Shopify inicia MakeCrypto con un token de sesión firmado. MakeCrypto valida ese token con el Client secret y lo intercambia por un token offline de Admin API. Ese token se cifra en reposo y se usa para el mismo flujo de pedidos MakePay: sincronización de pedidos, enlaces de pago alojados, notas/tags, webhooks y automatización opcional de mark-paid.

La configuración legacy con Admin API access token ya no está soportada para nuevas conexiones Shopify. Las tiendas existentes conectadas con ese flujo anterior deben reconectar mediante la configuración V2.

App Shopify Dev Dashboard

MakeCrypto crea automáticamente la app Dev Dashboard desde el token Partner CLI. El nombre de la app siempre es MakePay. Después de crearla, abre los ajustes de la app MakePay en Dev Dashboard y copia el Client secret a MakeCrypto.

Scopes Admin API requeridos:

• read_customers
• write_customers
• read_products
• write_products
• read_orders
• write_orders
• read_draft_orders
• write_draft_orders
• read_themes
• write_themes

El nombre de la app Shopify desplegada siempre es MakePay.

Configuración de MakeCrypto

Abre MakeCrypto, elige la empresa y luego ve a E-commerce > Shopify. Agrega una tienda con:

• Slug de la tienda Shopify, que es la parte antes de .myshopify.com
• Token de un solo uso de Shopify Partner CLI
• Shopify Client secret, copiado después de que MakeCrypto crea la app
• Nombre del método de pago manual

El token Partner CLI se cifra hasta que MakeCrypto crea, despliega e instala la app, luego se borra. Durante la creación de la app, MakeCrypto también detecta el ID de organización Shopify Dev Dashboard desde el token. El Client secret y el token offline de Admin API se cifran en reposo.

Para generar un token Partner CLI, abre los ajustes del portal Shopify Partner, baja hasta CLI Token, gestiona tokens y genera uno nuevo. Puede revocarse después de que la instalación de la app MakePay termine correctamente.

Instalación y bloques de checkout

Cuando el despliegue aparezca como deployed, abre el portal Shopify Partner, selecciona la app, ve a Distribution > Custom distribution e instala la app en la tienda. Shopify redirige de vuelta a MakeCrypto tras la instalación.

Luego abre Shopify admin y ve a Settings > Checkout > Customize. Agrega el bloque MakePay a la página Thank You y a la página Order Status, y guarda.

El bloque MakePay verifica el token de sesión de Shopify, solicita a MakeCrypto el enlace de pago correspondiente y muestra un botón Pay now. Si el webhook de pedido todavía se está procesando, el bloque espera brevemente mientras MakePay prepara el enlace.

Método de pago manual

En Shopify admin, abre Settings > Payments > Manual payment methods y crea un método de pago personalizado. Su nombre debe coincidir exactamente con el nombre del método de pago de la conexión MakeCrypto. Las conexiones MakePay nuevas usan por defecto:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Cuando los clientes eligen ese método, Shopify crea el pedido como impago. La sincronización MakePay adjunta la URL de checkout alojado a la nota del pedido y puede enviar un email de solicitud de pago MakePay cuando está habilitado.

Webhooks y sincronización

MakeCrypto registra webhooks de creación/actualización de pedidos y desinstalación de app después de completar la instalación V2. Una sincronización programada también revisa tiendas conectadas recientemente, por lo que los pedidos se recogen aunque la entrega de webhooks Shopify se retrase.

Las firmas de webhooks entrantes de Shopify se verifican antes de aceptar el payload. Los logs de solicitudes y webhooks se conservan en la página de conexión para troubleshooting.

Mapeo de estados

Cuando un pedido Shopify está pendiente mediante el método de pago manual MakePay, MakePay crea o reutiliza un enlace de pago MakePay para el total del pedido y el email del cliente.

Cuando el pago MakePay llega a complete, MakePay agrega una nota/tag de pagado y usa orderMarkAsPaid de Shopify Admin API cuando auto-mark-paid está habilitado.

Cuando un pago MakePay llega a failed, expired o cancelled, MakePay agrega una nota de estado y deja el pedido Shopify impago para revisión del merchant.

Solución de problemas

Si la creación o despliegue de la app falla, confirma que el token Partner CLI empiece con atkn_ y no haya sido revocado antes de iniciar el job, luego reintenta desde MakeCrypto.

Si la instalación falla, confirma que la app Shopify fue creada por la misma configuración MakeCrypto y que la URL de app generada por MakeCrypto está configurada por el deploy.

Si Test connection falla, verifica que la app tenga todos los scopes requeridos y reinstala o redespliega la app.

Si el bloque Pay now se queda preparando, confirma que el bloque MakePay esté instalado en ambas páginas de checkout y que el pedido Shopify use exactamente el nombre del método de pago manual.