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).
- 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: 840 para el dólar norteamericano (USD) vads_amount Monto del pago en su unidad monetaria más pequeña (el centavo para el para el dólar estadunidense) n..12 Ejemplo: 3000 para 30,00 USD 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: 20200101130025vads_trans_id Número de la transacción an6 Ejemplo : xrT15p vads_payment_config Tipo de pago enum SINGLE para un pago único vads_page_action Acción a realizar enum PAYMENT vads_ctx_mode Adquisición de los datos en la plataforma de pago enum TEST oPRODUCTION 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=
- 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
- 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 - Añade los otros campos opcionales en función de sus necesidades (consulte los siguientes capítulos).