Ultima actualización 19/11/2015

3. Solicitud de nuevo pedido

3.1 URL de solicitud

  • La URL de solicitud en el entorno de PRUEBA es https://ogone.test.v-psp.com/ncol/test/orderdirect.asp.
  • La URL de solicitud en el entorno de PRODUCCIÓN es https://secure.ogone.com/ncol/prod/orderdirect.asp.

Cambiar "test" a "prod"

Sustituya “test” por “prod” en la URL de solicitud cuando cambie a la cuenta de producción. Si olvida cambiar la URL de solicitud una vez que inicia la producción con pedidos reales, las transacciones se enviarán al entorno de prueba y no serán procesadas por las entidades adquirientes/los bancos, por lo que no recibirá el pago.

3.2 Parámetros de solicitud

La siguiente tabla contiene los parámetros de solicitud para enviar una nueva solicitud de pedido:

Formato: AN= Alfanumérico/N=Numérico, cantidad máxima de caracteres permitida
Campo Descripción Formato Obligatorio
PSPID
Su nombre de afiliación en nuestro sistema.
AN, 30

ORDERID
Su número de pedido único (referencia del comerciante).
AN, 40
USERID
Nombre de su usuario de aplicación (API). Consulte la documentación del Administrador de usuarios para obtener información sobre cómo crear un usuario API.
AN, 20 (mín. 2)
PSWD
Contraseña del usuario API (USERID).
AN
AMOUNT
Importe a pagar MULTIPLICADO POR 100, ya que el formato del importe no debe contener decimales u otros separadores.
N, 15
CURRENCY
Código de divisa de pedido alfa ISO, por ejemplo: EUR, USD, GBP, CHF, etc.
AN, 3
CARDNO
Número de tarjeta/cuenta.
AN, 21
ED
Fecha de caducidad.
MM/AA o MMAA
COM
Descripción del pedido.
AN, 100
No
CN
Nombre del cliente.
AN, 35
No
EMAIL
Dirección de correo electrónico del cliente.
AN, 50
No
SHASIGN
Firma (cadena con hash) para autenticar los datos (consulte Firma SHA-IN).
AN, 128
CVC
Código de verificación de la tarjeta. Dependiendo de la marca de la tarjeta, el código de verificación tendrá 3 o 4 dígitos en la parte delantera o posterior de la tarjeta, una fecha de inicio o una fecha de nacimiento.
N, 5
ECOM_PAYMENT_
CARD_VERIFICATION
Alternativa a CVC: fecha de nacimiento/número de problema/etc. (dependiendo del país/banco)
N, 5
No
OWNERADDRESS
Número y nombre de la calle del cliente.
AN, 50
No
OWNERZIP
Código postal del cliente.
AN, 10
No
OWNERTOWN
Nombre de la localidad del cliente.
AN, 40
No
OWNERCTY
País del cliente, por ejemplo, BE, NL, FR, etc.
AN, 2 No
OWNERTELNO
Número de teléfono del cliente.
AN, 30
No
OPERATION

Define el tipo de transacción solicitado.

Puede configurar una operación predeterminada (procedimiento de pago) en la pestaña "Parámetros de transacción globales", en la sección "Valor de ECI predeterminado" de la página Información técnica. Cuando envíe un valor de operación en la solicitud, este sobrescribirá el valor predeterminado.

Valores posibles:
  • RES: solicitud de autorización
  • SAL: solicitud de venta directa
  • RFD: reembolso, no vinculado con un pago anterior. Por ejemplo, una operación de que no es de mantenimiento en una transacción existente (no se puede utilizar esta operación sin permiso específico de su entidad adquirente).

Opcional:

  • PAU: Solicitud de preautorización:
      De acuerdo con la entidad adquiriente puede utilizar este código de operación para reservar fondos de forma temporal en la tarjeta de un cliente. Se trata de una práctica común en el sector de viajes y alquiler.
      En estos momentos, PAU/preautorización solo se puede utilizar en transacciones de MasterCard y es compatible con entidades adquirientes seleccionadas. Este código de operación no se puede definir como valor predeterminado en su cuenta de Ingenico ePayments.
      En el caso de que utilice PAU en transacciones a través de entidades adquirientes o con marcas de tarjetas que no admiten preautorización, estas transacciones no se bloquearán, sino que se procesarán como autorizaciones (RES) normales.
A, 3
WITHROOT
Añade un elemento raíz a nuestra respuesta XML. Valores posibles: ‘Y’ o vacío.
Y o <vacío.>
No
REMOTE_ADDR
Dirección IP del cliente (solo para el módulo de detección de fraude). Si no es necesario realizar una comprobación de país en la dirección IP, envíe "NONE".
AN
No
RTIMEOUT

Tiempo de espera de solicitud para la transacción (en segundos, valor entre 30 y 90)

Importante: El valor definido aquí debe ser inferior al valor de tiempo de espera de su sistema (!)

 

N, 2
No
ECI

Indicador de comercio electrónico.

Puede configurar un valor ECI predeterminado en la página Información técnica de su cuenta, pestaña "Parámetros de transacción globales", sección "Valor ECI predeterminado". Cuando envíe un valor ECI en la solicitud, este sobrescribirá el valor ECI predeterminado.

Posibles valores (numéricos):
0 - Pasada por el lector
1 - Introducción manual (MOTO) (tarjeta no presente)
2 - Periódico (desde MOTO)
3 - Pagos a plazo
4 - Introducción manual, tarjeta presente
7 - Comercio electrónico con cifrado SSL
9 - Periódico (desde comercio electrónico)
N, 2
No

La lista de posibles parámetros que enviar puede ser más larga para comerciantes que hayan activado determinadas funcionalidades/opciones en sus cuentas. Consulte la documentación de la opción correspondiente para obtener más información acerca de los parámetros adicionales vinculados a la opción.

Los siguientes parámetros de solicitud son obligatorios en los pedidos nuevos:

  • PSPID y USERID
  • PSWD
  • ORDERID
  • AMOUNT (x 100)
  • CURRENCY
  • CARDNO
  • ED
  • CVC
  • OPERATION 

3.3 Página de prueba

Nuestra página de prueba para enviar solicitudes de pedido en DirectLink está disponible aquí: https://ogone.test.v-psp.com/ncol/test/testodl.asp.

3.4 Excluding specific payment methods

If there are payment methods you don't want a customer to be able to pay with, you can use a parameter to do so.
This is particularly useful for sub-brands, when you want to accept a brand (e.g. MasterCard) but not one of its sub-brands (e.g. Maestro).

The parameter is the following:

Field Usage
EXCLPMLIST
List of payment methods and/or credit card brands that should NOT be used, separated by a “;” (semicolon).

If a customer tries paying with a card linked to a payment method and/or (sub)brand you've excluded using the EXCLPMLIST parameter, the error message “Card number incorrect or incompatible” will be returned with the NCERRORPLUS return field.


3.5 Solicitud de pedido mediante 3-D Secure

Nuestro sistema admite el uso de 3-D Secure con DirectLink.

Importante

  • Si desea utilizar 3-D Secure con DirectLink, es necesario que tenga la opción D3D activada en su cuenta.
  • Algunos bancos adquirentes requieren el uso de 3-D Secure. Consulte con su entidad adquirente si este es su caso.

 

3.6 Dividir tarjetas de crédito/débito

La funcionalidad para dividir VISA y MasterCard en un método de pago de débito y de crédito le permite ofrecérselo a sus clientes como dos métodos de pago distintos (p. ej. VISA Débito y VISA Crédito) o puede decidir aceptar solo una de las dos marcas divididas.

Para utilizar la división de tarjetas de crédito y débito a través de DirectLink, tiene que incluir el parámetro CREDITDEBIT en los campos ocultos que envía a la página orderdirect.asp (y por tanto también se incluyen en el cálculo de SHA-IN).

Campo Formato
CREDITDEBIT "C": tarjeta de crédito
"D": tarjeta de débito

Error relacionado: Cuando el comprador selecciona el método de tarjeta de crédito, pero introduce a continuación un número de tarjeta de crédito, se devuelve un código de error: ‘Se ha elegido una marca/método de pago incorrecto’.

Si el pago se ha procesado de forma correcta con el parámetro CREDITDEBIT, se devolverá el mismo parámetro en la respuesta XML o podrá solicitarse con una consulta directa. No obstante, mientras que los valores enviados sean C o D, los valores devueltos son "CREDIT" o "DEBIT".

También encontrará estos valores devueltos en la descripción general de la transacción a través de "Ver transacciones" e "Historial financiero", así como en informes que puede descargar más adelante.

Configuración en su cuenta

La funcionalidad de división también se puede activar y configurar según el método de pago en su cuenta de Ingenico ePayments. Acceda a Dividir tarjetas de crédito/débito para obtener más información.

Este sitio web utiliza cookies para poder darle la mejor experiencia de usuario. Si usted no desea aceptar estas cookies, permitimos que cambie la configuración de cookies. Haga clic en "Aceptar" para permitir todas las cookies de este sitio web.

Ajustes de cookies

Introducción

Funcional

Cookies funcionales son necesarios para el sitio web funcione correctamente. Estas cookies no se pueden desactivar.

Optimizado

Cookies de optimización nos permiten analizar el uso del sitio para que podamos medir y mejorar nuestro sitio web.
Este es el nivel predeterminado.

Personalizado

Cookies de personalización se utilizan para los medios sociales y la personalización antelación. Ellos nos permiten mostrarle información relacionada con su empresa. 


Ejemplo de funcionalidad permitida

  • Tienda preferencia país
  • Tienda preferencia de idioma

Ejemplo de funcionalidad no permitido

  • Guardar los datos personales
  • Seguimiento anónimo a través de Google Analytics
  • Seguimiento para fines de marketing

Ejemplo de funcionalidad permitida

  • Tienda preferencia país
  • Tienda preferencia de idioma
  • Seguimiento anónimo a través de Google Analytics

Ejemplo de funcionalidad no permitido

  • Guardar los datos personale
  • Seguimiento para fines de marketing

Ejemplo de funcionalidad permitida

  • Tienda preferencia país
  • Tienda preferencia de idioma
  • Seguimiento anónimo a través de Google Analytics
  • Servir contenido relevante a sus intereses
  • Servir anuncios relevantes para sus intereses
  • Seguimiento para fines de marketing

Ejemplo de funcionalidad no permitido

  • Guardar los datos personale