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, tu servidor lee el pedido, solicita una sesión y abre la página segura de pago de DEXA.
El flujo del botón
- El servidor de tu tienda verifica quién compra, consulta su pedido y obtiene el total real.
- Tu servidor envía amount, reference y concept a POST /api/dexapay/v1/sessions con su clave técnica.
- DexaPay devuelve checkoutUrl y el navegador abre esa dirección.
- DexaPay confirma el resultado. Tu servidor consulta la sesión y guarda sessionId, orderId, reference y transactionId.
El navegador nunca es la fuente de verdad. Una redirección no marca el pedido como pagado.
Qué necesitas
- Yappy Comercial activo y sus credenciales cargadas una sola vez en el Portal DexaPay.
- Una clave técnica en el servidor de tu tienda. El botón no contiene claves.
- Acceso a los pedidos de tu tienda para que su servidor calcule el total y evite que el comprador lo cambie.
- Contrato DexaPay aceptado y aprobación de DEXA. Completar 3/3 no enciende cobros reales; la activación queda separada.
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.
¿La promesa de una hora aplica siempre?
Aplica cuando ya tienes Yappy Comercial activo, credenciales válidas, dominio configurado y contrato aceptado. La aprobación bancaria y los datos incompletos quedan fuera de ese plazo.
¿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