Creación del formulario de pago

El servidor del vendedor recibe una solicitud de pago de la aplicación móvil y debe transmitirla a la plataforma de pago.

Para ello, el sitio del comerciante genera un formulario de pago HTML que luego enviará a la plataforma de pago.

La integridad de los datos intercambiados está protegida por un intercambio de firmas alfanuméricas entre la plataforma de pago y el sitio web del comerciante.

El servidor del comerciante transmitirá la firma alfanumérica en el formulario de pago (consulte el capítulo Calcular la firma).

IMPORTANTE

Todos los datos del formulario deben estar codificados en UTF-8.

De esta forma, los caracteres especiales (acentos, puntuación, etc.) serán interpretados correctamente por la plataforma de pago.

En el caso contrario, el cálculo de la firma será erróneo y el formulario será rechazado.

Para crear el formulario de pago:
  1. Utilice todos los campos presentes en el cuadro para crear la solicitud de pago.
    Nombre del campo Descripción Formato Valor
    vads_site_id Identificador de la tienda n8 Ejemplo: 12345678
    vads_currency Código numérico de la moneda que se utilizará para el pago, según la norma ISO 4217 (código numérico) n3 Ejemplo: 978 para el euro (EUR)
    vads_amount Monto del pago en su unidad monetaria más pequeña (el centavo para el euro) n..12 Ejemplo: 3000 para 30,00 euro
    vads_cust_email Dirección de correo electrónico del comprador ans..150 Ejemplo: abc@example.com
    vads_payment_cards Tipo de tarjeta. String Ejemplo: VISA

    (Consulte la Guía de implementación de la API de formularios para la lista de valores posibles).

    vads_order_id Número del pedido ans..64 Ejemplo: 2-XQ001
    vads_version Versión del protocolo de intercambio con la plataforma de pago enum V2
    vads_theme_config Permite aumentar el desempeño al desactivar elementos de la página de pago como el selector de idioma, los logotipos de la parte inferior de la página, etc. map

    SIMPLIFIED_DISPLAY=true

    vads_trans_date Fecha y hora del formulario de pago en el huso horario UTC n14

    Respete el formato AAAAMMDDHHMMSS

    Ejemplo: 20200101130025
    vads_trans_id Número de la transacción an6 Ejemplo : xrT15p
    vads_payment_config Tipo de pago enum SINGLE para un pago único

    MULTI para un pago en vencimientos

    vads_page_action Acción a realizar enum PAYMENT
    vads_ctx_mode Adquisición de los datos en la plataforma de pago enum TEST o PRODUCTION
    vads_action_mode Modo de adquisición de la información del medio de pago enum INTERACTIVE
    signature Firma que garantiza la integridad de las solicitudes intercambiadas entre el sitio web vendedor y la plataforma de pago. El cálculo de su valor se indica aquí: Calcular la firma. ans44 Ejemplo:

    NrHSHyBBBc+TtcauudspNHQ5cYcy4tS4IjvdC0ztFe8=

  2. Utilice los campos a continuación para gestionar el regreso a la aplicación móvil al final del pago.

    Un pago puede terminar en 4 estados diferentes:

    • Pago aceptado

    • Pago rechazado

    • Pago en error

    • Pago abandonado por el comprador

    Debe asociar una URL a cada estado:

    Nombre del campo Descripción Formato Valor
    vads_url_success

    URL donde se redirigirá al comprador si el pago es exitoso.

    ans..1024 Ejemplo:

    http://webview.success

    vads_url_refused

    URL donde se redirigirá al comprador si el pago es denegado.

    ans..1024 Ejemplo:

    http://webview.refused

    vads_url_cancel

    URL donde se redirigirá al comprador en caso de abandono o expiración (timeout).

    ans..1024 Ejemplo:

    http://webview.cancel

    vads_url_error

    URL donde se redirigirá al comprador en caso de error.

    ans..1024 Ejemplo:

    http://webview.error

  3. Utilice los campos a continuación para configurar los plazos de redirección a la aplicación móvil al final del pago.
    Nombre del campo Descripción Formato
    vads_redirect_success_timeout

    Define el plazo de espera antes del redirección, luego de un pago exitoso.

    Este plazo se expresa en segundos y debe estar entre 0 y 300 segundos.

    Asigne a este campo el valor “0” para no mostrar el recibo del pago y redirigir automáticamente al comprador a la aplicación móvil.

    n..3
    vads_redirect_error_timeout

    Define el plazo de espera antes del redirección, luego de un pago denegado.

    Este plazo se expresa en segundos y debe estar entre 0 y 300 segundos.

    Asigne a este campo el valor “0” para no mostrar la página de rechazo del pago y redirigir automáticamente al comprador a la aplicación móvil.

    n..3

  4. Añade los otros campos opcionales en función de sus necesidades (consulte los siguientes capítulos).