• Francia
Back Office Vendedor
asistencia
FAQcontacte el soporte tecnico
Buscar
Categoria
Tags
Perú
Perú
Página principal
Casos de uso
Crear un pago
Crear un pago en cuotas
Crear un pago por token
Crear un enlace de pago
Crear una suscripción
Gestione sus suscripciones
Gestione sus transacciones
Analizar los diarios
Docs API
Formulario incrustado
API REST
API REST PCI-DSS
Formulario en redirección
Pago móvil
Intercambio de ficheros
Ejemplo de código
Módulos de pago
Guías
Back Office Vendedor
Guías funcionales

Calcular la firma

Para poder calcular la firma debe disponer:
  • de los campos cuyos nombres comienzan con vads_
  • del tipo de algoritmo elegido al configurar la tienda
  • de la clave

El valor de la clave está disponible en el Back Office Vendedor en el menú Configuración > Tienda > pestaña Claves.

El tipo de algoritmo se define en su Back Office Vendedor en el menú Configuración > Tienda > pestaña Configuración.

Para calcular la firma:

  1. Ordene los campos cuyos nombres comienzan convads_por orden alfabético.
  2. Todos los campos deben estar codificados en UTF-8.
  3. Concatene los valores de estos campos separándolos con el carácter “+".
  4. Concatene el resultado a la clavede prueba o de producción separándolos con el carácter "+".
  5. Calcule y codifique en formato Base64 la firma usando el algoritmo HMAC-SHA-256 con los siguientes parámetros:
    • la función de hash SHA-256,
    • la clave de test o de producción (según el valor del campovads_ctx_mode) como clave compartida,
    • el resultado de la etapa anterior como mensaje para autentificar.
  6. Guarde el resultado del paso anterior en el camposignature.
Ejemplo de parámetros enviados a la plataforma de pago:
<form method="POST" action="https://secure.micuentaweb.pe/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="5124" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="840" />					
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="SINGLE" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20170129130025" />
<input type="hidden" name="vads_trans_id" value="123456" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="92dec271594ddef9842a33340ffc8532ac5a3a44"/>					
<input type="submit" name="payer" value="Payer"/>
</form>

Este ejemplo de formulario se desglosa de la siguiente manera:

  1. Los campos con nombres que comienzan convads_ se organizan en orden alfabético:
    • vads_action_mode
    • vads_amount
    • vads_ctx_mode
    • vads_currency
    • vads_page_action
    • vads_payment_config
    • vads_site_id
    • vads_trans_date
    • vads_trans_id
    • vads_version
  2. El valor de estos campos se concatena con el símbolo "+":
    INTERACTIVE+5124+TEST+840+PAYMENT+SINGLE+12345678+20170129130025+123456+V2
  3. Se agrega el valor de la clave de test al final de la cadena, separado por el símbolo "+". En este ejemplo, la clave de test es 1122334455667788
    INTERACTIVE+5124+TEST+840+PAYMENT+SINGLE+12345678+20170129130025+123456+V2+1122334455667788
  4. Calcule y codifique en formato Base64 la firma del mensaje usando el algoritmo HMAC-SHA-256 con los siguientes parámetros:
    • la función de hash SHA-256,
    • la clave de test o de producción (según el valor del campovads_ctx_mode) como clave compartida,
    • el resultado de la etapa anterior como mensaje para autentificar.

    El resultado que se debe transmitir en el campo signature es:

    EKrcj4e8N38LGCP/xkJMaHUajUfvsRG50mDwYLNBsMU=

  • Ejemplo de implementación en JAVA
  • Ejemplo de implementación en PHP
© 2025 Todos los derechos reservados de Izipay
25.17-1.11