Manual operativo
v1.0 · 02/Jun/2026
Play! Board Game Store

Configurar pasarelas de pago

Activar Izipay (cuenta existente) + Mercado Pago en paralelo en el checkout.

Lo esencial en 3 puntos

Antes de empezar

Decide según el escenario:

Si tu situación es…Empieza por la parte
"Quiero cobrar HOY con mi cuenta Izipay existente"Parte 1 — Izipay (5 min con las 2 credenciales)
"Mercado Pago me rechaza pagos por antifraude"Parte 2 — Mercado Pago (KYC + soporte (01) 705-5555)
"Comparar pasarelas antes de elegir"Anexo — Tabla comparativa
Lo bueno de Shopify Puedes tener Izipay + Mercado Pago activos al mismo tiempo. El comprador ve la lista en el checkout y elige la que prefiere. Si una falla, la otra sigue funcionando. Cada una solo cobra comisión por las transacciones que procesa ella.

Parte 1 · Izipay (pasarela principal)

Izipay es la pasarela peruana más conocida del país. Plugin oficial en Shopify verificado a junio 2026. Cubre:

Como Raúl ya usa Izipay en su WordPress anterior, la cuenta ya está aprobada · no hay KYC nuevo · no hay espera de 24-72h.

Estado actual del plugin en Play! El plugin "Izipay" ya está instalado en tu Shopify Admin → Apps (instalado 2026-06-02). Visible y esperando las 2 credenciales para activarse. Cero impacto en el checkout actual hasta que se active en Settings → Payments.

1.1 · Obtener las 2 credenciales del Back Office Izipay (Raúl, 5 min)

  1. Entra al Back Office Izipay.

    El portal donde Raúl maneja las ventas físicas Izipay. Si no tiene el link a mano, lo encuentra en los emails iniciales de Izipay o pide recuperación al soporte (01) 411-3000.

  2. Identificador de la tienda (Shop ID, 8 dígitos).

    En el Back Office: Configuración → Tiendas → Configuración. Arriba del formulario aparece el ID de la tienda. Ejemplo: 12345678.

    [SCREENSHOT PENDIENTE: Back Office Izipay · Tiendas → Configuración con el ID resaltado]
  3. Clave de firma (signature key).

    En el Back Office: Configuración → Tiendas → Claves. Hay dos versiones:

    Lo ideal: mandar las 2 a Mateo. Empezamos validando con la de TEST (sin riesgo), después cambiamos a PRODUCCIÓN cuando confirmemos que todo funciona.

    Seguridad La Clave de producción es sensible (como una API key). Compartir solo por WhatsApp directo con Mateo · nunca por email ni grupos. Si en algún momento sospechas compromiso, en el Back Office puedes regenerarla.
  4. Alternativa · "Yo configuro el plugin desde mi admin Shopify"

    Si prefieres no compartir la Clave de firma: entra a Shopify Admin → Apps → Izipay → ahí ves el formulario con los 2 campos (Identificador + Clave de firma) · pegas tú mismo · guardas · avisas. Mateo te guía por WhatsApp si tienes dudas.

1.2 · Configurar el plugin en Shopify (Mateo, 10 min)

  1. Abrir el plugin desde Shopify Admin.

    Shopify Admin → Apps → Izipay. Se abre el panel de configuración servido por Izipay/Lyra (URL secure.micuentaweb.pe/vads-cms/shopify/config/view/...).

  2. Pegar Shop ID + Clave de firma de TEST.

    En el panel del plugin:

    Click Guardar.

    [SCREENSHOT PENDIENTE: panel Izipay en Shopify · campos Shop ID + Clave de firma + Tipos de tarjeta]
  3. Activar la pasarela en checkout.

    Shopify Admin → Settings → Payments → "Izipay" → toggle ON. Izipay aparece como opción de pago en el checkout (modo test).

  4. Probar con tarjeta de prueba Izipay.

    Izipay entrega tarjetas de prueba en su documentación oficial (secure.micuentaweb.pe/doc). Hacer compra ficticia S/1 → confirmar que la orden aparezca como "Paid" en Shopify · monto figura en el Back Office Izipay.

    Importante para Play! NO hacer tests con tarjetas reales en modo producción. Cada rechazo "quema" el perfil del comprador. Usa siempre tarjetas de test mientras estás validando.
  5. Cambiar a producción.

    Cuando los tests sandbox pasen: en el panel del plugin · reemplazar la Clave de firma de TEST por la de PRODUCCIÓN · click Guardar. Ya cobras real.

  6. Primer cobro real.

    Compra real S/49.90 desde un comprador NUEVO (Raúl o familiar con tarjeta de uso frecuente · jamás Mateo · su perfil está marcado por los rebotes de MP). Si pasa → ya estás vivo · pasamos a DNS.

Parte 2 · Mercado Pago (paralelo · respaldo)

MP ya está instalado en Play!. Cubre tarjetas + Yape + PagoEfectivo (lo que Izipay no tiene). Motor antifraude más agresivo con cuentas merchant nuevas · bloqueó los primeros 5 tests con S/5, S/79 (x3) y S/25 entre 12-may y 01-jun.

Recomendación: dejarlo activo en paralelo con Izipay. Si MP funciona, el comprador puede elegirlo (especialmente quien quiere pagar con Yape). Si rechaza, tiene a Izipay como alternativa visible en el mismo checkout.

2.1 · Destrabar MP (Raúl, 30 min · en paralelo · no bloqueante)

  1. Completar KYC merchant.

    Raúl entra a MP admin → completa banner "Valida tu identidad y mantén tu cuenta segura". Toma 15-30 min. DNI ambos lados + ficha SUNAT + selfie. Aprobación 4-24h.

  2. Llamar soporte MP con los 5 N° rechazados.

    Tel: (01) 705-5555. Datos a tener a mano:

    Pide: "necesito que revisen el score de riesgo del MID y desbloqueen el perfil del comprador que está marcado por test legítimos durante la implementación".

  3. NO testear MP con tarjetas reales adicionales.

    Cada rechazo nuevo agrava el problema. Si necesitas validar MP, usar modo sandbox (Settings → Payments → MP → "Test mode") + tarjetas dummy oficiales.

  4. Cuando MP esté sano · mantenerlo activo en paralelo con Izipay.

    Le da al comprador la opción "Mercado Pago" en checkout (especialmente útil para quien prefiere pagar con Yape). Si lo eligen y funciona, cobras. Si rechaza, ven Izipay en la misma pantalla.

Por qué no eliminamos MP MP es el único que cubre Yape + PagoEfectivo nativos en plugin oficial Shopify. Muchos compradores peruanos prefieren pagar con Yape. Mantenerlo activo (cuando se destrabe) amplía opciones para el cliente sin costo fijo (solo cobra comisión cuando procesa).

Otra opción disponible · Culqi (backup futuro)

El plugin Culqi también está instalado en tu Shopify Admin (Apps → Culqi Payment), como backup futuro. Por ahora queda invisible en el checkout (sin activar en Settings → Payments).

Cuándo activarlo: si quisieras una pasarela adicional que cubra Cuotéalo BCP (cuotas sin interés con tarjeta de crédito BCP), Culqi es la única que lo tiene nativo en su plugin oficial. Requiere abrir cuenta en culqi.com + KYC 24-72h. El plugin está listo a recibir login email/pass cuando lo decidas.

No es prioridad ahora Con Izipay (tarjetas) + MP destrabado (Yape + PagoEfectivo) ya cubrimos los métodos de pago principales del mercado peruano. Culqi queda como referencia para más adelante si en el roadmap aparece una necesidad clara de Cuotéalo BCP.

Anexo · Tabla comparativa

Pasarela Tarjetas Yape PagoEfectivo Setup Comisión
Izipay (principal) ✓ Visa/MC/Amex/Diners Cuenta existente · 5 min con 2 credenciales Según contrato Izipay
Mercado Pago (paralelo) ✓ Visa/MC/Amex/Diners ✓ Nativo ✓ Nativo Self-service + KYC pendiente + antifraude ~4-5% + IGV
Culqi (opcional · backup) ✓ + Cuotéalo BCP ✓ Nativo ✓ Nativo Cuenta nueva + KYC 24-72h (plugin ya instalado) ~3.99% + IGV

Errores comunes y cómo resolverlos

ErrorCausa probableSolución
"Izipay no aparece en mi checkout" Toggle no activado en Settings → Payments Settings → Payments → buscar Izipay → activar toggle ON
"Izipay rechaza con error de firma" Clave de firma incorrecta o se está usando la de TEST en modo producción (o viceversa) Verificar que la clave en el plugin corresponda al modo activo. Producción → clave de producción. Test → clave de test.
"Cobré con Izipay pero la orden en Shopify quedó en 'pending'" El comprador no completó la redirección de vuelta a la tienda después del pago Verificar primero el cobro real en el Back Office Izipay · si está cobrado, marcar la orden manual como "Paid" en Shopify · si se repite, contactar soporte Izipay (01) 411-3000
"MP rechaza con 'Te protegimos de un pago sospechoso'" Motor antifraude MP bloqueó el perfil Cambiar a Izipay para esa compra (queda visible en el checkout en paralelo) · llamar (01) 705-5555 para destrabar perfil MP
"Izipay cobra pero Bsale no emite boleta" Webhook Bsale desconectado de la orden Shopify Bsale Admin → revisar integración Shopify activa

Tests y validación antes de ir a producción

Regla de oro Cada test fallido con tarjeta real "quema" el perfil del comprador en el motor antifraude (especialmente en MP). Usa SIEMPRE tarjetas de sandbox primero · primero Izipay con Clave de TEST · después cambia a PRODUCCIÓN.

Checklist pre-launch

  1. Sandbox Izipay: compra S/1 con tarjeta de prueba Izipay (de su doc oficial) → orden marcada Paid en Shopify → monto figura en Back Office Izipay
  2. Bsale conectado: el sandbox de Izipay debe emitir boleta automática Bsale al marcar Paid
  3. Klaviyo conectado: el comprador de prueba debería recibir email de confirmación Klaviyo (verificar en Klaviyo → Customer Events)
  4. Producción Izipay: primera compra real S/49.90 desde un comprador NUEVO (Raúl o familiar, NO Mateo) con tarjeta de uso frecuente. Si pasa → ya estás vivo · pasamos a coordinar DNS switch.
  5. MP en paralelo (no bloqueante para go-live): cuando MP destrabe el perfil → compra S/1 con tarjetas de prueba MP → orden marcada Paid → MP queda como pasarela secundaria activa