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

COF_INITIATOR           Credential-on-file initiator
Valores posibles:
  • CIT: Transacción iniciada por el titular de la tarjeta
  • MIT: Transacción iniciada por un comerciante                                                                                                                  
AN          No             
COF_SCHEDULE  Credential-on-files programada (o no programada)
Valores posibles:
  • SCHED: Transacción programada
  • UNSCHED: Transacción no programada
AN No
COF_TRANSACTION Credential-on-file transaction
Valores posibles:
  • FIRST: Primera serie de transacciones
  • SUBEQ: Siguientes series de transacciones 
AN 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.

3.7 Procesamiento de transacciones con credenciales guardadas

La transacción de credencial en archivo (COF) utiliza los detalles de la tarjeta que ya están almacenados por los comerciantes para procesar el pago. Antes de iniciar una transacción de credencial en archivo (COF), el titular de la tarjeta primero deberá autorizar al comerciante a almacenar los detalles de la tarjeta. La transacción de credencial en archivo (COF) se aplica principalmente a los pagos recurrentes y establece si es el titular de la tarjeta o el comerciante quien inicia el pago.

Hay dos tipos de transacciones de credenciales en archivo (COF): transacción iniciada por el titular de la tarjeta (CIT) o transacción iniciada por el comerciante (MIT). La transacción iniciada por el titular de la tarjeta (CIT) siempre deberá realizarse antes de la transacción iniciada por el comerciante (MIT).

Una transacción iniciada por el titular de la tarjeta (CIT) es una transacción en la que el titular de la tarjeta participa en la transacción y autentica personalmente la transacción mediante una firma, un dispositivo 3D-Secure o la presentación de documentos identificativos.

Ejemplo de una transacción iniciada por el titular de la tarjeta (CIT):

El titular de una tarjeta compra un billete de tren en línea y realiza un pago. Realiza el pago con su tarjeta de crédito y se le pide que autentique y autorice el pago. Al mismo tiempo, se pregunta al titular de la tarjeta si desea guardar la información de la tarjeta de crédito relacionada con este pago. Si el titular de la tarjeta está de acuerdo, esta información se puede reutilizar en futuras transacciones iniciadas por el comerciante.

Una transacción iniciada por el comerciante (MIT) es una transacción iniciada por un comerciante que supervisa una transacción iniciada por el titular de la tarjeta (CIT) y por un pedido permanente previamente acordado de bienes y servicios comprados por el titular de la tarjeta. El titular de la tarjeta no tiene por qué estar involucrado en la transacción.

Ejemplo de una transacción iniciada por un comerciante (MIT):

Un comerciante puede iniciar automáticamente una transacción para cumplir con el pago del titular de la tarjeta en una suscripción mensual a una revista.

De acuerdo con las regulaciones establecidas por Visa y MasterCard para la transacción de credencial en archivo (COF), se deben enviar nuevos parámetros para determinar la transacción COF. 

Esto le afecta si:

  • Utiliza un alias
  • Planea iniciar transacciones recurrentes (programadas o no) después de iniciar por primera vez una transacción iniciada por el titular de la tarjeta (CIT)

Acción necesaria:

De forma predeterminada, estos parámetros se utilizan en una transacción de DirectLink Server-to-Server:

Parámetros

Descripción

CIT-FIRST- UNSCHEDULED
Se aplica cuando se utiliza o se crea un alias
CIT-FIRST- SCHEDULED

Se aplica a un pago/suscripción programados

MIT-SUBSEQUENT-UNSCHEDULED
Se aplica a pagos recurrentes
MIT-SUBSEQUENT-SCHEDULED
Se aplica a pagos de cuotas

Los valores predeterminados se marcan si no se añade ningún parámetro. Sin embargo, si desea cambiarlos, puede sobrescribir estos valores predeterminados enviando los nuevos parámetros. No olvide recalcular también la firma SHA (haga clic aquí para obtener más información sobre la firma SHA.)

Parámetros

Valores

Descriptíon

COF_INITIATOR CIT Transacción iniciada por el titular de la tarjetar
  MIT Transacción iniciada por un comerciante
COF_SCHEDULE
SCHED Transacción programada
  UNSCHED Transacción no programada
COF_TRANSACTION
FIRST Primera serie de transacciones

SUBEQ

Siguientes series de transacciones

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