Crear una solicitud de pago
- Utilice todos los campos siguientes para crear su formulario de pago:
Nombre del campo Descripción Formato Valor vads_payment_cards Permite forzar el tipo de tarjeta utilizada. Se recomienda ofrecer un botón de pago distinto por cada medio de pago disponible en el sitio web comercial.
No se recomienda dejar el campo vacío.
enum PSE para llamar directamente al botón de pago PSE. vads_order_id Número único del pedido. Si el campo no se transmite, la plataforma de pago genera un valor único.
ans..64 2-XQ001 vads_order_description Descripción del pedido. Cadena de caracteres visible en el ticket de pago y en el e-mail de confirmación de pago enviado al comprador.
ans..65 vads_amount Monto del pago en su fracción monetaria más pequeña (el centavo para el dólar estadunidense). n..12 Ejemplo: 4525 para 45,25 USD vads_currency Código numérico de la moneda utilizada para el pago, según la norma ISO 4217. n3 Valor posible: - 170 (COP)
vads_cust_email Dirección de e-mail del comprador ans..150 Ej.: abc@example.com vads_acquirer_transient_data El código bancario PSE json vads_acquirer_transient_data ={"financialInstitutionCode": ["1725",”1625”]}
vads_proof_of_id_type Tipo del documento de identidad enum Valores posibles: - CC : Cédula de ciudadanía
- CE : Cédula de extranjería
- TI : Tarjeta de identidad
- TE : Tarjeta de extranjería
- DE : Documento de identificación extranjero
- PS : Pasaporte
- RN : Registro civil de nacimiento
- NI : Número de Identificación Tributaria
vads_cust_national_id Número de identificación Tributaria ans..255 Ejemplo: NIT, Número de identificación fiscal / 01-93-N9l6477D vads_cust_first_name Nombre ans..63 Ejemplo: Pedro vads_cust_last_name Apellido ans..63 Ejemplo: González vads_cust_phone Número de teléfono an..32 Ejemplo: (01) 660-0200 (en Perú) / (11) 4500-7000 (en Argentina) / (+57)1 346 2000 (en Colombia) vads_cust_address Dirección postal ans..255 Ejemplo: Avenida de la paz vads_cust_city Ciudad an..128 Ej: Bogotá vads_cust_zip Código postal an..64 110221 vads_ctx_mode Modo de comunicación con la plataforma de pago enum TEST oPRODUCTION vads_page_action Acción requerida enum PAYMENT vads_action_mode Modo de adquisición de los datos del medio de pago enum INTERACTIVE vads_payment_config Tipo de pago enum SINGLE vads_site_id ID de la tienda n8 Ejemplo: 12345678 vads_trans_date Fecha y hora del formulario de pago en el huso horario UTC. n14 Conserve el formato AAAAMMDDHHMMSS
Ejemplo: 20200101130025vads_trans_id Número de la transacción. El número de transacción debe ser único en un mismo día (de 00:00:00 a 23:59:59 UTC).
an6 Ejemplo: xrT15p vads_version Versión del protocolo de intercambio con la plataforma de pago enum V2 - Agregue campos opcionales en función de sus necesidades (ver capítulo: "Utilizar funciones complementarias" de Guía de implementación API Formulario).
- Calcule el valor del campo signature utilizando todos los campos de su formulario, cuyo número comienza por vads_ (ver: Calcular la firma del Guía de implementación API Formulario disponible en nuestro sitio documental).