Wepago Developers

Appearance

SDK — Widget iframe ​

El modo más rápido de integrar Wepago. El usuario paga en un modal flotante sin salir de tu sitio.

1. Incluir el script ​

html
<script src="https://checkout.wepago.com/sdk.js"></script>

2. Crear un token de pago ​

Llama a tu backend, que llama a la API de Wepago para generar el token:

bash
POST https://merchant.api.wepago.com/merchants/subscription-link
Authorization: Bearer {api_key}:{api_secret}
Content-Type: application/json

{
  "customer": { "phone": "+573001234567", "email": "juan@ejemplo.com" },
  "plan": { "externalReference": "orden-123", "description": "Suscripción mensual", "amount": 49900 }
}

Respuesta:

json
{ "token": "V1StGXR8Z5", "url": "https://checkout.wepago.com/pay/V1StGXR8Z5", "expiresAt": "..." }

3. Abrir el checkout ​

javascript
WepagoPay.open({
  token: 'V1StGXR8Z5',
  onSuccess(data) {
    console.log('Pago exitoso:', data.transactionId)
    // Actualiza el estado de tu orden
  },
  onError(err) {
    console.error('Error:', err.code)
    // INVALID_TOKEN | EXPIRED | DECLINED | CANCELLED
  },
  onClose() {
    // Usuario cerró el modal sin completar
  }
})

Registro de dominio ​

Para que el iframe funcione en tu sitio debes registrar tu dominio en comercios.wepago.com → Configuración → Dominios permitidos.

Ejemplo: tienda.com, app.tienda.com