Guía
Cómo integrar DexaPay y cobrar por Yappy desde tu web
Conecta una vez las credenciales de Yappy en el Portal DexaPay. Después pegas un script y un botón en tu web: al tocarlo, tu cliente paga en la página segura de DEXA. Si tienes servidor, también puedes crear el pago por API.
El flujo del botón
- Pegas una vez el script dexapay.js con tu clave pública (dxa_pub_…).
- Cada botón lleva el total del carrito en data-amount y tu referencia en data-reference.
- Al tocarlo, DexaPay abre su checkout seguro; solo funciona desde tus dominios autorizados.
- El cliente autoriza en su Yappy y vuelve a tu web con ?dexapay=…: el monto, la referencia y el estado, firmados con tu clave de verificación.
El total del botón sale del navegador. Verifica la confirmación firmada, o el pago en tu portal, antes de despachar.
Qué necesitas
- Yappy Comercial activo y sus credenciales cargadas una sola vez en el Portal DexaPay.
- La clave pública del botón, que generas en el portal. No es secreta: solo abre pagos desde tus dominios.
- Saldo de comisión: recargas con Yappy desde B/. 5 o con tarjeta desde B/. 20.
- Contrato para comercios aceptado y aprobación de DEXA. Completar 3/3 no enciende cobros reales; la activación queda separada.
Con servidor: la API
Si tienes quien programe, tu servidor puede crear el pago con POST /api/dexapay/v1/sessions y una clave secreta (dxa_live_…). Así el total sale de tu base de datos y nadie lo puede cambiar en el navegador. DexaPay devuelve checkoutUrl y tu servidor consulta la sesión antes de marcar pagado.
Qué recibe tu sistema
Cada operación conserva tu reference, un orderId de DEXA y, cuando Yappy lo entrega, un transactionId. Guarda los tres: la referencia conecta con tu pedido, el orderId con nuestro registro y el transactionId con la conciliación del proveedor.
| Dato | Para qué sirve |
|---|---|
| sessionId | Identifica la sesión hospedada. |
| orderId | Identificador de la orden DexaPay. |
| reference | Tu referencia idempotente. |
| transactionId | Número de transacción reportado por Yappy. |
Confirmación básica y opción avanzada
Para empezar, tu servidor consulta la sesión con su API key y verifica el estado antes de marcar el pedido pagado. No hace falta configurar un webhook.
- Como mejora opcional, recibe el webhook firmado en una ruta de servidor.
- Valida el HMAC y el timestamp sobre el cuerpo crudo, en tiempo constante.
- Deduplica cada evento antes de ejecutar efectos.
- Si el aviso no llega, vuelve a consultar la sesión autenticada.
- Nunca marques una venta pagada por la redirección del navegador.
Preguntas frecuentes
¿DexaPay recibe el dinero de mis ventas?
No. DEXA opera la capa técnica del checkout y la integración. El comercio mantiene la relación con sus clientes y el flujo de fondos corresponde a su afiliación con Yappy/Banco General.
¿Puedo usar Yappy personal?
No para esta integración. Necesitas Yappy Comercial activo y las credenciales que Banco General entrega para el comercio.
¿Necesito un servidor?
No. Con el botón pegas un script y un elemento con el total. La API con servidor es opcional, para quien quiere fijar el monto desde su base de datos.
¿Quieres empezar?
Comienza el alta de DexaPay y llega al primer botón de cobro con acompañamiento paso a paso.
Ver la integración