Parameter Cookbook

Whenever you send a request to our platform, you need to provide specific information by using parameters. This accounts for any scenario, such as (just to name a few):

New transactions via one of our integration modes
Maintenance operations
Transaction status request

The same principle also applies to our platform sending information to you, i.e. for

To ensure our platform processes your requests correctly, you need to

Get all mandatory/recommended/optional parameters from the respective guide
Consult this Parameter Cookbook to assign correct values to them

Learn here how to read the individual columns:

Field name: Name of the parameter
Details: A detailed description about the parameter's purpose in a request
Input: Can you send the parameter in a request to our platform? If sent anyway, our platform ignores it
Output: Is the parameter included in notifications sent from our platform?
Format: Data type
Max Length: Maximum amount of characters
Example: A typical value to give you an idea of the expected value, allowed format and maximum length

Nombre de campo

Detalles

Entrada

Salida

Formato

Longitud máx.

Ejemplo

AAVADDRESS

Indica el resultado AAV para la dirección (véase también AAVCHECK)

Sí

AAVCHECK

Resultado de una verificación de dirección automática. Esta verificación no es compatible con todas las entidades adquirentes.

Valores posibles:
KO: la dirección ha sido enviada pero la entidad adquirente ha respondido negativamente a la comprobación de dirección, es decir, la dirección es incorrecta.
OK: la dirección ha sido enviada y la entidad adquirente ha respondido positivamente a la comprobación de dirección, es decir, la dirección es correcta O
La entidad adquirente envió un código de autorización pero no una respuesta específica para la comprobación de dirección.
NO: cualquier otro caso. Por ejemplo, no se ha transmitido la dirección, la entidad adquirente ha respondido que no era posible realizar la comprobación de dirección; la entidad adquirente rechaza la autorización pero no proporciona un resultado específico para la comprobación de dirección,...

Sí

AAVMAIL

Procedimientos de autenticación para direcciones de correo electrónico. Aplicable únicamente a transacciones con American Express.

Sí

OK,KO

AAVNAME

Procedimientos de autenticación para nombres de titulares de tarjetas. Aplicable únicamente a transacciones con American Express.

Sí

OK,KO

AAVPHONE

Procedimientos de autenticación para números de teléfono. Aplicable únicamente a transacciones con American Express.

Sí

OK,KO

AAVZIP

Indica el resultado AAV para el código postal (véase también AAVCHECK)

Sí

ACCEPTANCE

Código de aceptación (autorización) de la entidad adquirente.

La entidad adquirente devuelve este código para confirmar que el importe de la transacción ha sido bloqueado en la tarjeta del cliente. El código de aceptación no es único.

Sí

04306B

ACCEPTURL

URL de la página web para mostrar al cliente cuando se autoriza el pago.

Sí

200

http://www.myshop.com/accept.html

Account.PSPID

Su nombre de afiliación en nuestro sistema, seleccionado por usted mismo al abrir una cuenta con nosotros. Se trata de un identificador único y no puede cambiar nunca.

Sí

MyPSPID123

ADDMATCH

Indica si se consideran las direcciones de facturación y envío idénticas

1=sí
0=no

Sí

ADDRMATCH

véase ADDMATCH

Sí

AIACTIONNUMBER

Número de acción

Sí

AIAGIATA

Número de agencia IATA

Sí

AIAIRNAME

Número de línea aérea

Sí

Brussels Airlines

AIAIRTAX

Tasas de aeropuerto

Sí

AIBOOKIND*XX*

Indicador de reserva

Sí

AICARRIER*XX*

Código de operador

Sí

AICHDET

Detalles del cargo

Sí

AICLASS*XX*

Clase aérea

Sí

AICONJTI

Billete de conexión

Sí

AIDEPTCODE

Código de departamento de campo DBI

Sí

AIDESTCITY*XX*

Aeropuerto de llegada (corto)

Sí

BLQ

AIDESTCITYL*XX*

Aeropuerto de llegada (largo)

Sí

Guglielmo Marconi

AIEXTRAPASNAME*XX*

Nombre adicional del pasajero

Sí

AIEYCD

Código de área de destino

Sí

AIFLDATE*XX*

Fecha de vuelo

Sí

YYYYMMDD

20120504

AIFLNUM*XX*

Número de vuelo

Sí

1234

AIGLNUM

Número de cuenta de campo DBI

Sí

AIINVOICE

Número de nota de entrega/factura

Sí

AIIRST

Tipo de código de área de destino

Sí

AIORCITY*XX*

Aeropuerto de salida (corto)

Sí

BRU

AIORCITYL*XX*

Aeropuerto de salida (largo)

Sí

Brussels

AIPASNAME

Nombre del pasajero

Sí

AIPROJNUM

Número de proyecto de campo DBI

Sí

AISTOPOV*XX*

Escala

Sí

AITIDATE

Fecha de emisión de billete

Sí

Date/Time

15/04/2012 13:14:56

AITINUM

Número de billete

Sí

123

AITINUML*XX*

Número de billete

Sí

123

AITYPCH

Tipo de cargo

Sí

AIVATAMNT

Importe del IVA

Sí

AIVATAPPL

IVA aplicable

Sí

ALIAS

Alias. Una vez creado el alias, puede utilizarlo en lugar del número de tarjeta en las solicitudes de transacciones.

No utilice espacios ni caracteres especiales en el alias.

Sí

9897B5BB-4981-4633-BF46-40DCD6DFAB1F

Alias.AliasId

Alias. Una vez creado el alias, puede utilizarlo en lugar del número de tarjeta en las solicitudes de transacciones.

No utilice espacios ni caracteres especiales en el alias.

Sí

9897B5BB-4981-4633-BF46-40DCD6DFAB1F

Alias.OrderId

Su número de pedido (referencia del comerciante).

Por lo general, esta referencia es utilizada por el comerciante para buscar su transacción en el área de administración.
En el modo en línea, modo a tres niveles, el sistema utiliza esta referencia también para comprobar si se ha solicitado un pago dos veces para el mismo pedido. A petición del comerciante, el periodo de esta comprobación se puede acortar o deshabilitar.

Si la entidad adquirente es técnicamente capaz de procesar la transacción, y la cuenta no tiene una configuración especial, este orderID se enviará a la entidad adquirente como referencia (ref2) de la transacción. En este caso, el comerciante recibirá este campo ref2 en sus extractos de cuenta, lo que el ayudará a reconciliar sus transacciones.
Aunque nuestro sistema puede aceptar hasta treinta caracteres, por lo general la mayoría de las entidades adquirentes aceptan diez o doce. El formato exacto aceptado de validación de datos depende de la entidad adquirente o banco. Si el orderID no cumple las reglas de ref2 configuradas por la entidad adquirente, en lugar de ref2 enviaremos nuestro PAYID a la entidad adquirente.

No utilice espacios ni caracteres especiales en el orderID.

Sí

Order_789

Alias.StorePermanently

Indicate whether you want to store an alias temporarily or indefinitely.

The possible values are:

N: the alias will be deleted after 2 hours

Y: the alias will be stored indefinitely for future use

This parameter can only be used when Alias Gateway and Alias Manager are used together.

Sí

Y or N

ALIASOPERATION

Indica quién ha determinado/seleccionado el alias, el comerciante o nuestro sistema.

Valores posibles: BYMERCHANT o BYPSP

Sí

BYPSP

ALIASPERSISTEDAFTERUSE

Sí

Y or N

ALIASUSAGE

Explicación breve para el cliente del motivo por el que usted sugiere la creación de un alias. El texto se mostrará al cliente en el modo de e-Commerce.

Sí

255

Monthly subscription to lf World.

AMOUNT

Importe de la transacción.

Cuando la cantidad se envía como entrada, debe multiplicarse por 100 para evitar problemas por separadores decimales.
En general, la entidad adquirente acepta hasta dos decimales, dependiendo de la divisa.

Sí

Sent: 12995 Returned: 129.95

AUTHORIZATION CODE

(* 100 para evitar decimales).

Sí

A437956

AUTHORIZATION DATE

Véase código de autorización. Fecha/Hora de recepción del código de autorización.

Sí

MM/DD/YY HH:MM:SS

03/15/08 16:07:12

AUTHORIZATION MODE

Véase código de autorización. Forma de recepción del código de autorización.

Valor posible:
TEL para teléfono

Sí

TEL

BACKURL

URL de la página web a mostrar al cliente cuando hace clic en el botón volver desde nuestra página de pago seguro.

Sí

200

http://www.myshop.com/selectPM.html

BGCOLOR

Color de fondo de la página de pago.

Sí

N/A

Blue #0000FF

BIC

Código de identificación de banco (utilizado para operaciones de adeudo directo)

Sí

GEBABEBB36A

BIN

Primeros seis dígitos de un número de tarjeta de crédito. Se pueden utilizar para identificar la marca y el banco emisor.

Sí

444444

BRAND

Marca de una tarjeta de crédito/débito/compra.

Puede consultar una lista de valores para MARCA en Asistencia > Manuales de integración y de usuario > Guías técnicas > Payment Methods Processing/Procedures.

Si envía el campo MARCA sin enviar un valor en el campo MÉTODO DE PAGO (tarjeta de crédito o tarjeta de compra), el valor MARCA no se tendrá en cuenta.

Sí

VISA

browserAcceptHeader

Exact content of the HTTP accept headers as sent to the merchant from the Cardholder’s browser.
If the total length of the accept header sent by the browser exceeds 2048 characters, the 3DS Server truncates the excess portion

Sí

2048

browserColorDepth

Value representing the bit depth of the color palette for displaying images, in bits per pixel. Obtained from Cardholder browser using the screen color Depth property.
Values accepted:
1 = 1 bit
4 = 4 bits
8 = 8 bits
15 = 15 bits
16 = 16 bits
24 = 24 bits
32 = 32 bits
48 = 48 bits

Sí

browserJavaEnabled

Boolean that represents the ability of the cardholder browser to execute Java. Value is returned from the navigator java Enabled property (possible values TRUE or FALSE).

Sí

TRUE

browserLanguage

Value representing the browser language as defined in IETF BCP47. Returned from navigator language property.

Sí

browserScreenHeight

Total height of the Cardholder’s screen in pixels. Value is returned from the screen height property. Between 0 and 999999

Sí

1024

browserScreenWidth

Total width of the cardholder’s screen in pixels. Value is returned from the screen width property Between 0 and 999999

Sí

1024

browserTimeZone

Time difference between UTC time and the Cardholder browser local time, in minutes between -840 and 720

Sí

-840

browserUserAgent

Exact content of the HTTP user-agent header.
Note: If the total length of the User- Agent sent by the browser exceeds 2048 characters, the 3DS Server truncates the excess portion.

Sí

2048

BUTTONBGCOLOR

Color de fondo del botón en la página de pago.

Sí

N/A

Black #000000

BUTTONTXTCOLOR

Color del texto del botón en la página de pago.

Sí

N/A

White #FFFFFF

CANCELURL

URL de la página web para mostrar al cliente cuando cancela el pago.

Sí

200

http://www.myshop.com/cancel.html

Card.Brand

Marca de una tarjeta de crédito/débito/compra.

Puede consultar una lista de valores para MARCA en @STARTURL@https://secure.ogone.com/NCol/$environment$/PM_process_procedure.asp?@TXTURL@Métodos de pago - Vista general de procesamiento/procedimiento@ENDURL@

Si envía el campo MARCA sin enviar un valor en el campo MÉTODO DE PAGO (tarjeta de crédito o tarjeta de compra), el valor MARCA no se tendrá en cuenta.

Sí

Visa

Card.PaymentMethod

Método de pago.

Puede consultar una lista de valores para el MÉTODO DE PAGO en Asistencia > Manuales de integración y de usuario > Guías técnicas > Payment Methods Processing/Procedures

Sí

CreditCard

CARDNO

Número de tarjeta o número de cuenta.

Las reglas que aplica nuestro sistema para ocultar números de tarjetas de crédito, en cualquier conjunto de datos de salida, pantalla, o correo electrónico, son determinadas por PCI.

Para VISA, VISA PC, MASTERCARD, MASTERCARD PC y MASTERCARD PC CM CIC se muestran los cuatro últimos dígitos.

Para el resto de marcas/métodos de pago, la parte no mostrada depende de la longitud del número de tarjeta o número de cuenta:

Si el número tiene más de quince dígitos: se muestran los seis primeros y los dos últimos, con xxxxxxxx (8 veces x) en el medio.
Si el número tiene entre doce y quince dígitos: se muestran los cuatro primeros y los dos últimos, con xxxxxx (6 veces x) en el medio.
Si el número tiene de ocho a once dígitos, se muestran los dos primeros y los dos últimos, con xxxx (4 veces x) en el medio.
Si el número tiene de cuatro a siete dígitos, se muestran el primer dígito y el último, con xx (2 veces x) en el medio.
Si el número tiene menos de cuatro dígitos se oculta el número entero.

El número de cuenta nunca será visible en transferencias bancarias sin conexión ni para pago en la entrega.

El número de cuenta para transacciones de domiciliación bancaria se ocultará cuando la transacción esté en el estado 4 - pedido almacenado, si el comprador tiene que enviar un fax firmado para confirmar el pago.

Sí

XXXXXXXXXXXX1111

CATALOGURL

URL del catálogo del comerciante

Sí

200

http://www.myshop.com/shop.html

CAVV_3D

conforme a respuesta de ACS

Sí

300

CAVVALGORITHM_3D

conforme a respuesta de ACS

Sí

CCCTY

País de emisión de la tarjeta, valores del código ISO 3166-1-alpha-2 (http://www.iso.org/iso/country_codes/iso_3166_code_lists.htm). Si este parámetro no está disponible, se devolverá 99 en la respuesta.

Esta comprobación del país de la tarjeta de crédito se basa en listas obtenidas externamente, así que existe un ligero riesgo debido a que tenemos que fiarnos de la corrección de esta lista. La comprobación proporciona resultados positivos en el 94 % de los casos.

Sí

CH_AUTHENTICATION_INFO

3DSv2 feedback parameter.
Contains detailed information from your customers issuer when they reject your customers transactions.
Note that not all issuers share information about why they decline transactions. Therefore, in some cases, CH_AUTHENTICATION_INFO is empty

Sí

128

Please contact your bank for further information.

CIVILITY

Tratamiento del cliente (Sr., Sra., D., Dª, etc.)

Sí

Mr.

Nombre del titular de la tarjeta (cliente).

Se permiten caracteres especiales pero no las comillas. La mayoría de las entidades adquirentes no comprueban el nombre del cliente ya que los nombres se pueden escribir de diferentes formas.

Sí

Min. 2 - Max. 35

John Doe

COF_INITIATOR

Credential-on-file initiator
Valores posibles:
CIT: Transacción iniciada por el titular de la tarjetar.
MIT: Transacción iniciada por un comerciante.
Para obtener más información consulte las guías de e-Commerce y DirectLink.
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.
Ejemplos:
Se aplica cuando se utiliza o se crea un alias:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = UNSCHED
Se aplica cuando se utiliza o se crea un alias:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = SCHED
Se aplica a pagos recurrentes:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = UNSCHED
Se aplica a pagos de cuotas:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = SCHED

Sí

CIT,MIT

COF_SCHEDULE

Credential-on-file programada o no programada
Valores posibles:
SCHED: Transacción programada.
UNSCHED: Transacción no programada.
Para obtener más información consulte las guías de e-Commerce y DirectLink.
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.
Ejemplos:
Se aplica cuando se utiliza o se crea un alias:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = UNSCHED
Se aplica cuando se utiliza o se crea un alias:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = SCHED
Se aplica a pagos recurrentes:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = UNSCHED
Se aplica a pagos de cuotas:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = SCHED

Sí

SCHED,UNSCHED

COF_TRANSACTION

Credential-on-file transaction
Valores posibles:
FIRST: Primera serie de transacciones.
SUBSEQ: Siguientes series de transacciones.
Para obtener más información consulte las guías de e-Commerce y DirectLink.
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.
Ejemplos:
Se aplica cuando se utiliza o se crea un alias:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = UNSCHED
Se aplica cuando se utiliza o se crea un alias:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = SCHED
Se aplica a pagos recurrentes:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = UNSCHED
Se aplica a pagos de cuotas:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = SCHED

Sí

FIRST,SUBSEQ

COM

Descripción del pedido

En ocasiones se transmite a la entidad adquirente (dependiendo de la entidad adquirente) el campo com para mostrarlo en los extractos de cuenta del comerciante o del cliente.

Sí

100

Three telephone cards

COMPLUS

Campo para enviar un valor que desea recibir en la solicitud de venta por correo o en la respuesta.

COMPLUS es diferente de com en el sentido de que el campo COMPLUS es más largo. Sin embargo, la información de COMPLUS no se muestra en el área de administración.
Se puede utilizar para recuperar información de una sesión, contenido de un pedido o información del usuario después de la transacción.

Sí

1000

Three telephone cards

CREDITCODE

Code to indicate the payment modality of a payment method. This parameter is used only with specific payment methods (referenced in the dedicated guides)

Sí

001

CUID

El identificador único de cliente (CUI) es un identificador asignado al cliente por el comerciante. Puede ser un nombre, el número de cliente, una dirección de correo electrónico, etc.

Sí

2014101512366

CURRENCY

Divisa de la transacción.

Divisa del importe con el código ISO alfabético que se puede encontrar en http://www.currency-iso.org/iso_index/iso_tables/iso_tables_a1.htm

Las divisas posibles en nuestra plataforma son: AED, ANG, ARS, AUD, AWG, BGN, BRL, BYR, CAD, CHF, CNY, CZK, DKK, EEK, EGP, EUR, GBP, GEL, HKD, HRK, HUF, ILS, ISK, JPY, KRW, LTL, LVL, MAD, MXN, NOK, NZD, PLN, RON, RUB, SEK, SGD, KK, THB, TRY, UAH, USD, XAF, XOF, XPF y ZAR

Si un comerciante desea aceptar pagos en una divisa que no está en nuestra lista, puede solicitar la adición de esa divisa.

Las divisas en las que un comerciante puede aceptar pagos dependen del contrato con su entidad adquirente.

Si el comerciante desea aceptar una divisa que no es compatible con su entidad adquirente, podemos configurar una conversión de divisa dinámica en nuestro lado (esta opción es de pago).

Sí

EUR

CVC

Código de validación de la tarjeta. El código de verificación es un código de autenticación asociado de forma única al número de tarjeta, aunque no forma parte del número de la tarjeta. Este código se denomina de distinta forma dependiendo de la marca (CVC2 o código de validación de tarjeta para MasterCard, CVV2 o valor de verificación de tarjeta para VISA, CID o número de identificación de tarjeta para American Express). No obstante, el código se denomina generalmente CVC.
Dependiendo de la marca de la tarjeta, el código de verificación tendrá tres o cuatro dígitos en la parte delantera o posterior de la tarjeta, una fecha de inicio o una fecha de nacimiento:

VISA y MasterCard: código de tres dígitos en la parte posterior de la tarjeta sobre la banda de la firma (después del número de cuenta completo del cliente o después de los cuatro últimos dígitos del número de cuenta del cliente).

American Express: código de cuatro dígitos encima del número de cuenta en la parte delantera de la tarjeta.

Aurora, Aurore y Cofinoga: fecha de nacimiento (DD/MM/AAAA o DDMMAAAA).

Sí

758

CVCCHECK

Resultado de la comprobación del código de verificación de la tarjeta. Solo unas pocas entidades adquirentes devuelven resultados de comprobación de CVC específicos. La mayoría de las entidades adquirentes suponen que el CVC es correcto si la transacción se autoriza correctamente.

Valores posibles:

KO: el CVC ha sido enviado pero la entidad adquirente ha respondido negativamente a la comprobación del CVC, es decir, el CVC es incorrecto.
OK: el CVC ha sido enviado y la entidad adquirente ha respondido positivamente a la comprobación del CVC, es decir, el CVC es correcto O
La entidad adquirente envió un código de autorización pero no devolvió un resultado específico para la comprobación del CVC.
NO: cualquier otro caso. Por ejemplo, no se ha transmitido el CVC, la entidad adquirente ha respondido que no era posible realizar la comprobación del CVC, la entidad adquirente rechaza la autorización pero no proporciona un resultado específico para la comprobación del CVC,...

Sí

DATATYPE

El valor es VIAJE si usted proporciona datos de un viaje a nuestro sistema y es un campo obligatorio

Sí

TRAVEL

DATEIN

fecha de llegada

Sí

dd/MM/yyyy

40658

DATEOUT

fecha de salida

Sí

dd/MM/yyyy

40659

DCC_COMMPERCENTAGE

porcentaje de comisión eDCC

Sí

DCC_CONVAMOUNT

importe convertido eDCC

Sí

DCC_CONVCCY

divisa de destino eDCC

Sí

EUR

DCC_EXCHRATE

tipo de cambio eDCC

Sí

DCC_EXCHRATESOURCE

fuente del tipo de conversión eDCC

Sí

DCC_EXCHRATETS

sello de tiempo del tipo de conversión eDCC

Sí

DCC_INDICATOR

indicador eDCC

Sí

DCC_MARGINPERCENTAGE

porcentaje de margen eDCC

Sí

DCC_VALIDHOURS

validez eDCC (en horas) del tipo de conversión, a partir de la hora/fecha definida en DCC_EXCHRATETS

Sí

DECLINEURL

URL de la página web a mostrar al cliente cuando la entidad adquirente rechaza la autorización más de un número de veces máximo autorizado (diez de forma predeterminada, pero se puede modificar en la página de información técnica).

Sí

200

http://www.myshop.com/decline.html

DEVICE

Para visualizar una página de pago adaptada a dispositivos móviles, envíe el valor mobile solo funciona con los métodos de pago de Paypal/ Postfinance y Bancontact

Sí

mobile

DIGESTCARDNO

resumen SHA del número de tarjeta utilizado durante la transacción

Sí

128

68BFB396F35AF3876FC509665B3DC23A0930AAB1

ECI

Indicador de comercio electrónico. El ECI (indicador de comercio electrónico) indica el nivel de seguridad al que se procesa la información de pago entre el titular de la tarjeta y el comerciante.

Se puede seleccionar un valor predeterminado de ECI en la página de información técnica. El valor ECI configurado en la transacción sobrescribirá el valor ECI predeterminado.

Es responsabilidad del comerciante indicar un valor ECI correcto para las transacciones. Para e-Commerce, nuestro sistema selecciona un valor ECI de 5, 6 o 7, dependiendo del resultado de la autenticación 3-D Secure.

Valores posibles:

0 - Pasada por el lector

El comerciante pasó la tarjeta de crédito del cliente por una máquina que lee los datos de la banda magnética de la tarjeta.

1 - Introducción manual (MOTO) (tarjeta no presente)

El comerciante recibió los datos financieros del cliente por teléfono, fax o correo electrónico, pero no tiene la tarjeta del cliente en la mano.

2 - Recurrente (desde MOTO)

La primera transacción del cliente se realizó por correo electrónico o teléfono, es decir, el cliente proporcionó sus datos financieros por teléfono, correo electrónico o fax al comerciante. El comerciante almacenó los datos o los dejó almacenados en nuestro sistema utilizando un alias, y está realizando ahora otra transacción para el mismo cliente (transacción recurrente).

3 - Pagos a plazos

Pago parcial de bienes y servicios ya proporcionados, pero que se pagarán en varios plazos.

4 - Introducción manual, tarjeta presente

El cliente está físicamente presente frente al comerciante. El comerciante tiene la tarjeta del cliente en la mano. La información de la tarjeta se ha introducido manualmente, la tarjeta no se ha pasado por una máquina.

5 - Se ha identificado correctamente al titular de la tarjeta

La identificación 3-D Secure del titular de la tarjeta se ha realizado correctamente, es decir, la autenticación ha sido completa. (Pulgar hacia arriba)

6 - El comerciante acepta la identificación pero sin titular de la tarjeta. El comerciante tiene un contrato 3-D Secure, pero la tarjeta del titular no es 3-D Secure o es 3-D Secure pero el titular de la tarjeta todavía no tiene el PIN (pulgar medio levantado). Se aplican las reglas de garantía condicional del pago.

7 - Comercio electrónico con encriptado SSL

El comerciante recibió los datos financieros del cliente a través de un sitio web (el sitio web del comerciante o nuestra plataforma segura) seguro (encriptado SSL).

9 - Recurrente (mediante comercio electrónico)

La primera transacción del cliente se realizó mediante e-Commerce, es decir, el cliente introdujo sus datos financieros en un sitio web seguro (el sitio web del comerciante o nuestra plataforma segura). El comerciante almacenó los datos o los dejó almacenados en nuestro sistema utilizando un alias, y está realizando ahora otra transacción para el mismo cliente (transacción recurrente), utilizando la información del alias.

Sí

ECI_3D

5: identificación del titular de la tarjeta correcta

6: prueba de intento de autenticación
12: emisor no registrado
91: La identificación del titular de la tarjeta ha fallado. La transacción se ha rechazado (estado 2)
92: página ACS temporalmente no disponible, pero continuar de todas formas

Sí

ECOM_BILLTO_POSTAL_CITY

Localidad de facturación

Sí

Brussels

ECOM_BILLTO_POSTAL_COUNTRYCODE

País de facturación

Sí

ECOM_BILLTO_POSTAL_COUNTY

Invoicing county

Sí

South Yorkshire (UK)

ECOM_BILLTO_POSTAL_NAME_FIRST

Nombre del cliente facturado

Sí

Bill

ECOM_BILLTO_POSTAL_NAME_LAST

Apellidos del cliente facturado

Sí

Smith

ECOM_BILLTO_POSTAL_POSTALCODE

Código postal de facturación

Sí

1200

ECOM_BILLTO_POSTAL_STREET_LINE1

Dirección de facturación, primera línea

Sí

Billing Street

ECOM_BILLTO_POSTAL_STREET_LINE2

Dirección de facturación, segunda línea

Sí

Building 123

ECOM_BILLTO_POSTAL_STREET_NUMBER

Número de vivienda en la dirección de facturación

Sí

ECOM_CONSUMER_GENDER

Sexo

Sí

AN (M or F)

ECOM_CONSUMERID

Identificación del cliente en el sistema del comerciante.

Sí

Customer1

ECOM_PAYMENT_CARD_VERIFICATION

Véase CVC.

Sí

758

ECOM_SHIPMETHODDETAILS

Identificación del punto de recogida

Sí

ECOM_SHIPTO_COMPANY

Delivery address: Company

Sí

My Company

ECOM_SHIPTO_DOB

Fecha de nacimiento

Sí

dd/MM/yyyy

01/01/2001

ECOM_SHIPTO_ONLINE_EMAIL

Dirección de correo electrónico

Sí

bill@smith.com

ECOM_SHIPTO_POSTAL_CITY

Localidad de envío

Sí

Brussels

ECOM_SHIPTO_POSTAL_COUNTRYCODE

Código de país de envío

Sí

ECOM_SHIPTO_POSTAL_COUNTY

Delivery county

Sí

Bailey (US, TX)

ECOM_SHIPTO_POSTAL_NAME_FIRST

Nombre del cliente destinatario del envío

Sí

Bill

ECOM_SHIPTO_POSTAL_NAME_LAST

Apellidos del cliente destinatario del envío

Sí

Smith

ECOM_SHIPTO_POSTAL_NAME_PREFIX

Prefijo del cliente destinatario del envío

Sí

Mr.

ECOM_SHIPTO_POSTAL_POSTALCODE

Código postal de envío

Sí

1200

ECOM_SHIPTO_POSTAL_STATE

Estado de entrega, código ISO

Sí

CA (California)

ECOM_SHIPTO_POSTAL_STREET_LINE1

Dirección de envío, primera línea

Sí

Ship street

ECOM_SHIPTO_POSTAL_STREET_LINE2

Dirección de envío, segunda línea

Sí

Building 2

ECOM_SHIPTO_POSTAL_STREET_NUMBER

Número de vivienda en la dirección de envío

Sí

ECOM_SHIPTO_TELECOM_FAX_NUMBER

Número de fax en la dirección de envío

Sí

+32 2 123 4567

ECOM_SHIPTO_TELECOM_PHONE_NUMBER

Número de teléfono en la dirección de envío

Sí

+32 2 123 456

Fecha de expiración. Esta fecha no debe ser anterior a la fecha de procesamiento de la transacción en nuestro sistema.

Cuando no hay fecha de expiración disponible (p. ej. transferencias bancarias) se utiliza el valor 9999.

Sí

Input: MM/YY or MMYY Output: MMYY

1224

Dirección de correo electrónico del cliente. Si estás realizando una petición 3DSv2.1, asegúrate por favor de que el formato del e-mail remitido es válido. De lo contrario, la autenticación de la transacción pasará a ser 3DS 1.0.

Sí

John.Doe@test.com

EXCEPTIONURL

URL de la página web para mostrar al cliente cuando el resultado del pago es dudoso.

Sí

200

http://www.myshop.com/exception.html

EXCLPMLIST

Lista de métodos de pago que NO se debe mostrar en la página de pago

Sí

500

VISA;MasterCard;American Express

FLAG3D

Valor fijo: Y indica a nuestro sistema que lleve a cabo una identificación 3-D Secure si es necesario.

Sí

FONTTYPE

Tipo/Familia de fuentes utilizadas en la página de pago.

Sí

N/A

Arial

GLOBORDERID

Una referencia de pedido global agrupa varios pedidos y le permite solicitar más tarde una operación de mantenimiento sobre estas transacciones de forma combinada.

Sí

neworders15

HOMEURL

URL del sitio web del comerciante

Sí

200

http://www.myshop.com

HTML_ANSWER

Se puede añadir código HTML codificado con BASE64 en la página HTML devuelta al cliente.
Esta etiqueta se añade como hija de la etiqueta global XML @ncresponse@. El campo HTML_ANSWER contiene código HTML que debe ser añadido a la página HTML devuelta al cliente del navegador.
Este código cargará automáticamente la página de identificación del banco emisor en una ventana emergente en la ventana principal, dependiendo del valor del parámetro WIN3-D Secure.
Para evitar cualquier interferencia entre las etiquetas HTML incluidas en el contenido de la etiqueta XML HTML_ANSWER con el resto del XML devuelto como respuesta a la solicitud de DirectLink, el contenido de HTML_ANSWER es codificado mediante BASE64 por nuestro sistema antes de enviar la respuesta. En consecuencia, se debe descodificar mediante BASE64 antes de incluirlo en la página HTML enviada al titular de la tarjeta.

Sí

N/A

HTTP_ACCEPT

El campo Aceptar de la cabecera de la solicitud en el navegador del titular de la tarjeta se utiliza para especificar determinados tipos de medios aceptables para la respuesta. Este valor es utilizado por el emisor para comprobar si el navegador del titular de la tarjeta es compatible con el sistema de identificación del emisor.

Sí

500

Accept: */*

HTTP_USER_AGENT

El campo Agente del usuario de la cabecera de la solicitud en el navegador del titular de la tarjeta contiene información sobre el agente del usuario que originó la solicitud. Este valor es utilizado por el emisor para comprobar si el navegador del titular de la tarjeta es compatible con el sistema de identificación del emisor.

Sí

255

User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)

La dirección IP del cliente, según la haya detectado nuestro sistema en una integración de nivel 3, o que nos haya sido enviada por el comerciante en una integración de nivel 2

Sí

192.168.1.1

IPCTY

País de origen de la dirección IP en valores del código ISO 3166-1-alpha-2 (http://www.iso.org/iso/country_codes/iso_3166_code_lists.htm). Si este parámetro no está disponible, se devolverá 99 en la respuesta.

Hay cuatro códigos IP específicos que se refieren a direcciones IP para las que el país de origen es dudoso:

A1: proxy anónimo. Los proxies anónimos son proveedores de acceso a Internet que permiten a los usuarios ocultar sus direcciones IP.
AP: región Asia-Pacífico
EU: red europea
A2: proveedores de satélite

La comprobación de la IP se basa en listas de IP obtenidas externamente, así que existe un ligero riesgo debido a que tenemos que fiarnos de la corrección de esta lista. La comprobación proporciona resultados positivos en el 94 % de los casos.

Sí

ISSUERID

Para preseleccionar un banco para una transacción iDEAL que coincida con el BIC del banco.

Sí

ABNANL2A

ITEMATTRIBUTES*XX*

Atributos del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMCATEGORY*XX*

Categoría del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMCOMMENTS*XX*

Comentarios del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

255

ITEMDESC*XX*

Descripción del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMDISCOUNT*XX*

Descuento del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMID*XX*

Identificador del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMNAME*XX*

Nombre del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMPRICE*XX*

Precio del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMQUANT*XX*

Cantidad del artículo
sustituya *XX* por un número para enviar varios artículos

Sí

ITEMQUANTORIG*XX*

Cantidad máxima por artículo

Sí

ITEMUNITOFMEASURE*XX*

Unidad de medida del artículo (para utilizar en combinación con ITEMWEIGHT*XX*)

Sí

ITEMVAT*XX*

Importe del IVA del artículo

Sí

ITEMVATCODE*XX*

Código de IVA del artículo

Sí

ITEMWEIGHT*XX*

Peso del artículo

Sí

LANGUAGE

Los idiomas actualmente disponibles para la página de pago ofrecidos al comprador (titular de la tarjeta/titular de la cuenta)

El formato es idioma_país.
El valor del idioma se basa en ISO 639-1.
El país del idioma se basa en ISO 3166-1.

El idioma predeterminado se utiliza si no se envía un valor de idioma o este valor no es válido:
en_US (inglés)

Otros idiomas disponibles:
ar_AR (árabe)
cs_CZ (checo)
da_DK (danés)
de_DE (alemán)
el_GR (griego)
es_ES (español)
fi_FI (finés)
fr_FR (francés)
he_IL (hebreo)
hu_HU (húngaro)
it_IT (italiano)
ja_JP (japonés)
ko_KR (coreano)
nl_BE (flamenco)
nl_NL (neerlandés)
no_NO (noruego)
pl_PL (polaco)
pt_PT (portugués)
ru_RU (ruso)
se_SE (sueco)
sk_SK (eslovaco)
tr_TR (turco)
zh_CN (chino simplificado)

Sí

fr_FR

Layout.Language

Sí

en_US

LOGO

Logotipo a mostrar en la página de pago.

Sí

N/A

myshoplo.gif or https://www.myshop.com/myshoplo.gif

MANDATEID

Domiciliaciones bancarias DE/NL: Referencia de autorización única

Sí

Mpi. provisionAttemptsInTheLast24Hours

Number of Add Card
attempts in the last 24 hours.
Between 0 and 999

Sí

Mpi.cardholderAccountAgeIndicator

Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account refers to the payment card number which is defined by ISO/IEC 7812.

Date that the cardholder opened the account with the merchant.

Date that the payment account was enrolled in the cardholder’s account with the merchant.

Length of time that the cardholder has had the account with the merchant.
01 = No account (guest check-out)
02 = Created during this transaction
03 = Less than 30 days
04 = 30−60 days
05 = More than 60 days

Sí

Mpi.cardholderAccountChange

Date that the cardholder's account with the merchant was last changed including Billing or Shipping address new payment account or new user(s) added.

Sí

YYYYMMDD

20190101

Mpi.cardholderAccountChangeIndicator

01 = Changed during this transaction
02 = Less than 30 days
03 = 30−60 days
04 = More than 60 days

Sí

Mpi.cardholderAccountDate

Date that the cardholder opened the account with the merchant.

Sí

YYYYMMDD

20190101

Mpi.cardholderAccountPasswordChangeIndicator

Indicates the length of time since the cardholder's account with the merchant had a password change or account reset.

Length: 2 characters Data Type: String Values accepted:
01 = No change
02 = Changed during this transaction
03 = Less than 30 days
04 = 30−60 days
05 = More than 60 days

Sí

Mpi.challengeWindowSize

Dimensions of the challenge window that has been displayed to the Cardholder. The ACS shall reply with content that is formatted to appropriately render in this window to provide the best possible user experience. Preconfigured sizes are width x height in pixels of the window displayed in the Cardholder browser window.
01 = 250 x 400
02 = 390 x 400
03 = 500 x 600
04 = 600 x 400
05 = Full screen

Sí

Mpi.deliveryEmailAddress

For Electronic delivery, the email address to which the merchandise was delivered.

Sí

254

example@example.com

Mpi.deliveryTimeframe

Indicates the merchandise delivery timeframe.
01 = Electronic Delivery
02 = Same day shipping
03 = Overnight shipping
04 = Two-day or more shipping

Sí

Mpi.giftCardAmount

For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in major units (for example, USD 123.45 is 123). Between 0 and 999999999999999

Sí

123

Mpi.giftCardCount

For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased. Between 0 and 99

Sí

Mpi.giftCardCurrency

For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217

Sí

USD

Mpi.HomePhone.countryCode

Country code of a home phone
ITU-E.164 country code

Sí

Mpi.HomePhone.subscriber

Home phone (without country code)

Sí

1234

Mpi.merchantFraudRate

Merchant Fraud Rate in the EEA (all EEA card fraud divided by all EEA card volumes) calculated as per PSD2 Regulatory Technical Standards (RTS).
Make sure to calculate the rate according to PSD2 RTS Article 19 regulation, as neither MasterCard nor we will validate the score.
Values accepted:
1 (represents fraud rate less than or equal to 1 basis point [bp], which is 0.01%)
2 (represents fraud rate between 1 bp + - and 6 bps)
3 (represents fraud rate between 6 bps + - and 13 bps)
4 (represents fraud rate between 13 bps + - and 25 bps)
5 (represents fraud rate greater than 25 bps)

Sí

Mpi.MobilePhone.countryCode

Country code of a mobile phone
ITU-E.164 country code

Sí

Mpi.MobilePhone.subscriber

Mobile phone (without country code)

Sí

1234

Mpi.numberOfPurchaseWithAccountInTheLastSixMonths

Number of purchases with this cardholder account during the previous six months. Between 0 and 9999

Sí

Mpi.paymentAccountAge

Date that the payment account was enrolled in the cardholder’s account with the merchant.

Sí

YYYYMMDD

20190101

Mpi.paymentAccountAgeIndicator

Indicates the length of time that the payment account was enrolled in the cardholder's account with the merchant.
01 = No account (guest check-out)
02 = During this transaction
03 = Less than 30 days
04 = 30−60 days
05 = More than 60 days

Sí

Mpi.preOrderDate

For a pre-ordered purchase, the expected date that the merchandise will be available.

Sí

YYYYMMDD

20190101

Mpi.preOrderPurchaseIndicator

Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.
01 = Merchandise available
02 = Future availability

Sí

Mpi.reorderItemsIndicator

Indicates whether the cardholder is reordering previously purchased merchandise.
01 = First time ordered
02 = Reordered

Sí

Mpi.secureCorporatePayment

Secure Corporate Payment
Indicates that dedicated payment processes and procedures were used and that potential secure corporate payment exemption applies.
Send this field only with Y if the acquirer exemption field is blank, as acquirer exemption and secure payment are mutually exclusive.
However, the directory server (DS) will not validate the conditions in the extension. The DS will pass data as sent.
You can optionally indicate if they apply to the dedicated processes and protocols as per PSD2 RTS Article 17, which would potentially allow the issuer to claim the secure corporate payment exemption.
Value accepted: Y / N

Sí

Mpi.shippingAddressUsage

Date when the shipping address used for this transaction was first used with the merchant.

Sí

20190101

Mpi.shippingAddressWasFirstUsed

Indicates when the shipping address used for this transaction was first used with the merchant.
01 = This transaction
02 = Less than 30 days
03 = 30−60 days
04 = More than 60 days

Sí

Mpi.shippingIndicator

Indicates shipping method chosen for the transaction. Merchants must choose the Shipping Indicator code that most accurately describes the cardholder’s specific transaction, not their general business.
If one or more items are included in the sale, use the Shipping Indicator code for the physical goods, or if all digital goods, use the Shipping Indicator code that describes the most expensive item.
01 = Ship to cardholder’s billing address
02 = Ship to another verified address on file with merchant
03 = Ship to address that is different than the cardholder’s billing address
04 = Ship to Store” / Pick-up at local store (Store address shall be populated in shipping address fields)
05 = Digital goods (includes online
06 = Travel and Event tickets not shipped
07 = Other (for example Gaming/digital services not shipped/ emedia subscriptions etc.)

Sí

Mpi.shippingNameAndCardholderNameAreIdentical

Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction (possible values TRUE or FALSE).

Sí

TRUE

Mpi.suspiciousAccountActivityDetected

Indicates whether the merchant has experienced suspicious activity (including previous fraud) on the cardholder account (possible values TRUE or FALSE).

Sí

TRUE

Mpi.threeDSRequestorAuthenticationData

Data that documents and supports a specific authentication process. In the current version of the specification, this data element is not defined in detail; however the intention is that for each merchant Authentication Method, this field carries data that the ACS can use to verify the authentication process. For example, for method:
02—field can carry generic merchant authentication information
03—data element can carry information about the provider of the federated ID and related information
04—data element can carry the FIDO attestation data (including the signature)
In future versions of the specification, these details are expected to be included

Sí

2048

Mpi.threeDSRequestorAuthenticationMethod

Mechanism used by the Cardholder to authenticate to the merchant.
occurred (i.e. cardholder logged in” as guest)
02 = Login to the cardholder account at the merchant system using merchant’s own credentials
03 = Login to the cardholder account at the merchant system using federated ID
04 = Login to the cardholder account at the merchant system using issuer credentials
05 = Login to the cardholder account at the merchant system using third- party authentication
06 = Login to the cardholder account at the merchant system using FIDO Authenticator
07–79 = Reserved for EMVCo future use (values invalid until defined by EMVCo)
80–99 = Reserved for DS use"

Sí

Mpi.threeDSRequestorAuthenticationTimestamp

Date and time in UTC of the cardholder authentication (format YYYYMMDDHHMMSS).

Sí

Date/Time

20190101235959

Mpi.threeDSRequestorChallengeIndicator

Indicates whether a challenge is requested for this transaction. For example:
For 01-PA, a merchant may have concerns about the transaction, and request a challenge.
For 02-NPA, a challenge may
be necessary when adding a new card to a wallet.
For local/regional mandates or other variables.
• 01 = No preference
• 02 = No challenge requested
• 03 = Challenge requested: merchant Preference
• 04 = Challenge requested: Mandate
• 05–79 = Reserved for EMVCo future use (values invalid until defined by EMVCo)
• 80-99 = Reserved for DS use
Note: If the element is not provided, the expected action is that the ACS would interpret as 01 = No preference.

Sí

Mpi.threeDSRequestorPriorAuthenticationData

Sí

2048

Mpi.threeDSRequestorPriorAuthenticationMethod

Mechanism used by the Cardholder to previously authenticate to the merchant.
01 = Frictionless authentication occurred by ACS
02 = Cardholder challenge occurred by ACS
03 = AVS verified
04 = Other issuer methods
05–79 = Reserved for EMVCo future use (values invalid until defined by EMVCo)
80–99 = Reserved for DS use

Sí

Mpi.threeDSRequestorPriorAuthenticationTimestamp

Date and time in UTC of the prior cardholder authentication (format YYYYMMDDHHMMSS).

Sí

Date/Time

20190101235959

Mpi.threeDSRequestorPriorReference

This data element provides additional information to the ACS to determine the best approach for handing a request.
This data element contains an ACS Transaction ID for a prior authenticated transaction (for example, the first recurring transaction that was authenticated with the cardholder).

Sí

Mpi.transactionActivityInTheLast24Hours

Number of transactions (successful and abandoned) for this cardholder account with the merchant across all payment accounts in the previous 24 hours.
Between 0 and 999

Sí

Mpi.transactionActivityLastYear

Number of transactions (successful and abandoned) for this cardholder account with the merchant across all payment accounts in the previous year.
Between 0 and 999

Sí

Mpi.transactionType

Identifies the type of transaction being authenticated.
01 = Goods/ Service Purchase
03 = Check Acceptance
10 = Account Funding
11 = Quasi-Cash Transaction
28 = Prepaid Activation and Load

Sí

Mpi.WorkPhone.countryCode

Country code of a work phone ITU-E.164 country code

Sí

Mpi.WorkPhone.subscriber

Phone used for work purposes (without country code)

Sí

1234

NCERROR

Código de error.

Hay disponible una lista de códigos de error via Asistencia > Manuales de integración y de usuario > Guías del usuario > Lista de estados de pago y códigos de error
El valor de este parámetro es 0 o vacío si no es aplicable.

Sí

30141001

NCERRORPLUS

Descripción de error del código NCERROR.

Hay disponible una lista de descripciones via Asistencia > Manuales de integración y de usuario > Guías del usuario > Lista de estados de pago y códigos de error
El valor de este parámetro es 0 o vacío si no es aplicable.

Sí

255

Invalid card number

NCSTATUS

Estado del error. En general, este es el primer dígito de NCERROR.

Sí

OPERATION

La operación define el tipo de transacción solicitado. El procedimiento de pago configurado en la página de información técnica definirá la operación de transacción predeterminada para un pedido nuevo. El valor de operación enviado en la transacción sobrescribirá el valor predeterminado.

Valores posibles para pedidos nuevos:

RES: solicitud de autorización.
SAL: solicitud de venta directa (pago), es decir, una autorización seguida automáticamente por un pago.
RFD: reembolso, no asociado a un pago previo, por lo que no es una operación de mantenimiento en una transacción existente. (no puede utilizar esta operación sin permiso específico de su entidad adquirente)

Los valores posibles para operaciones de mantenimiento son:

REN: renovación de autorización, si la autorización original ya no es válida.
DEL: eliminar autorización, dejando la transacción abierta para posibles operaciones adicionales de mantenimiento.
DES: eliminar autorización, cerrando la transacción después de esta operación.
SAL: captura de datos parcial (pago), dejando la transacción abierta para otra posible captura de datos.
SAS: captura (final) de datos parcial o completa (pago), cerrando la transacción (para capturas de datos adicionales) después de esta captura de datos.
RFD: reembolso parcial (de un pedido pagado), dejando la transacción abierta para otro posible reembolso.
RFS: reembolso (final) parcial o completo (para un pedido pagado), cerrando la transacción después de este reembolso.

Las operaciones finales (o individuales) cambian el estado global de la transacción mientras que las operaciones parciales no lo hacen.

Sí

RFD

ORDERID

Sí

AB5456CB896

ORDERSHIPCOST

Sí

ORDERSHIPTAXCODE

Sí

OWNERADDRESS

Dirección del cliente

Sí

102 First Avenue

OWNERCTY

País del cliente

El país según el código ISO 3166-1-alpha-2 que se puede encontrar en https://www.iban.com/country-codes

Sí

OWNERTELNO

Número de teléfono del cliente.

En este campo se permiten caracteres especiales (por ejemplo, + o /). Es conveniente utilizar un formato consistente para enviar números de teléfono.

Sí

30 Batch:20

3222869611

OWNERTOWN

Localidad del cliente.

Sí

Brussels

OWNERZIP

Código postal del cliente.

Sí

1000

Parameters.AcceptUrl

URL de la página web para mostrar al cliente cuando se autoriza el pago.

Sí

255

http://www.myshop.com/accept.html

Parameters.ExceptionUrl

URL de la página web para mostrar al cliente cuando el resultado del pago es dudoso.

Sí

255

http://www.myshop.com/exception.html

Parameters.ExcludedPaymentMethods

Lista de métodos de pago que NO se debe mostrar en la página de pago

Sí

Diners;American Express

Parameters.ParamPlus

Campo para enviar algunos parámetros y sus valores que desea recibir en la solicitud de venta por correo ordinario o en el redireccionamiento final. Cfr. Advanced e-Commerce

Estructura:
paramname=paramvalue&paramname=paramvalue&…

Sí

1000

SessionID=126548354&ShopperID=73541312

PARAMPLUS

Sí

1000

SessionID=126548354&ShopperID=73541312

PARAMVAR

La parte variable a incluir en la URL se utilizada para la venta por correo ordinario o para solicitudes de cancelación/denegación. PARAMVAR 2 diferencia mayúsculas y minúsculas y requiere al menos dos caracteres.

Sí

webshop1

PAYID

La referencia de transacción única de nuestro sistema.

El PAYID está formado actualmente por diez dígitos, pero este número va en aumento.
En el entorno de prueba, el PAYID almacena actualmente ocho dígitos.

Sí

N/A

3126514264

PAYIDSUB

Número de historial de la operación en el PAYID. Puede realizar varias operaciones financieras (autorización, pago, reembolso, etc.) en el mismo pedido (PAYID). Cada una de las operaciones financieras se identificada mediante el PAYID/PAYIDSUB.

Sí

N/A

PAYMENTOCCURRENCE

Code to indicate the number of payment occurrences. This parameter is used only with specific payment methods (referenced in the dedicated guides).

Sí

Método de pago.

Puede consultar una lista de valores para el MÉTODO DE PAGO en Asistencia > Manuales de integración y de usuario > Guías técnicas > Payment Methods Processing/Procedures

Sí

CreditCard

PMLIST

Lista de métodos de pago seleccionados o marcas de tarjetas para mostrar en la página de pago. Separados por un punto y coma.

Puede consultar una lista de valores para MÉTODO DE PAGO y MARCA en Asistencia > Manuales de integración y de usuario > Guías técnicas > Payment Methods Processing/Procedures

Sí

200

VISA;MasterCard;American Express

PMLISTTYPE

Forma de presentar los iconos de métodos de pago en la página de pago.

Sí

N/A

PSPID

Su nombre de afiliación en nuestro sistema, seleccionado por usted mismo al abrir una cuenta con nosotros. Se trata de un identificador único y no puede cambiar nunca.

Sí

JDoeSHOP

PSWD

Contraseña para el PSPID (usuario predeterminado) o un UserID específico.

Sí

N/A

BluEPr1nT8?

RECIPIENTACCOUNTNUMBER

Minoristas de MCC 6012: Datos de autorización adicionales de Visa/MasterCard Número de cuenta del destinatario O número de tarjeta de crédito con una máscara parcial

Sí

12345ABCDZ6789

RECIPIENTDOB

Minoristas de MCC 6012: Datos de autorización adicionales de Visa/MasterCard Fecha de nacimiento del destinatario

Sí

dd/MM/yyyy

2/3/1982

RECIPIENTLASTNAME

Minoristas de MCC 6012: Datos de autorización adicionales de Visa/MasterCard Apellidos del destinatario

Sí

RECIPIENTZIP

Minoristas de MCC 6012: Datos de autorización adicionales de Visa/MasterCard Código postal del destinatario

Sí

W1A 1AA

REF_CUSTOMERID

tareas pendientes

Sí

Abc-1234_5/2

REMOTE_ADDR

Dirección IP del cliente (solo para Módulo de detección de fraude) Para interfaces en las que nuestro sistema gestiona la interacción con el cliente (p. ej. e-Commerce) el REMOTE_ADDR es capturado directamente por nosotros. Para otras interfaces, el comerciante debe enviar la dirección IP del cliente junto con los detalles de la transacción.

Si no es necesaria la comprobación del país de la dirección IP, envíe el valor NONE (ninguno).

Sí

N/A

212.23.45.96

RTIMEOUT

Tiempo de espera de solicitud de una transacción, en segundos. El valor debe estar entre 30 y 90. El valor predeterminado es 90.

Cuando se utilicen componentes HTTP para interfaces como DirectLink, el comerciante debe asegurarse de que el tiempo de espera del componente HTTP es mayor que el valor que ha seleccionado como RTIMEOUT para la transacción.

Sí

SCO_CATERY

Categorías de puntuación. Consulte el módulo de detección de fraude avanzado: documentación sobre puntuación.

Valores posibles: G (verde), O (naranja), R (rojo).

Sí

SCORING

Puntuación final de una transacción. Consulte el módulo de detección de fraude avanzado: documentación sobre puntuación.

Sí

SEQUENCETYPE

Valores posibles para indicar el tipo de transacción de adeudo directo (NL):

- FRST: primer grupo de una serie de órdenes de adeudo directo

- RCUR: orden de adeudo directo en las que se utiliza la autorización del deudor para transacciones de adeudo directo normales iniciadas por el acreedor

- FNAL: grupo final de una serie de órdenes de adeudo directo (posteriormente no se puede volver a utilizar el mismo ID de orden)

- OOFF: orden de adeudo directo en la que se utiliza la autorización del deudor para iniciar una única transacción de adeudo directo

Sí

FRST

SHASIGN

Cadena a partir de la que se ha generado un hash mediante el algoritmo de hash seguro.

El SHASIGN en los campos ocultos es para la firma SHA-in (comprobación de datos antes del pago).
El comerciante obtiene un SHASIGN como respuesta en caso de que utilice una firma SHA-out (comprobación de origen de la respuesta).

Sí

128

172386BFF99BC8F899035E356497D4334958F2D4

ShaSignature.ShaSign

Sí

128

172386BFF99BC8F899035E356497D4334958F2D4

SIGNDATE

Domiciliaciones bancarias NL: Fecha en la que el comprador firmó la autorización.

Sí

YYYYMMDD

20140131

STATUS

Estado del pago.

0	Incompleto o no válido
1	Cancelado por el cliente
2	Autorización denegada
4	Pedido almacenado
41	Esperando pago del cliente
5	Autorizado
51	Esperando autorización
52	Autorización desconocida
59	Obtener autor. manualmente
6	Autorizado y cancelado
61	Esperando eliminación de autor.
62	Eliminación de autor. dudosa
63	Eliminación de autor. rechazada
7	Pago eliminado
71	Eliminación de pago pendiente
72	Eliminación de pago dudosa
73	Eliminación de pago rechazada
74	Pago eliminado (no aceptado)
75	Eliminación procesada por el comerciante
8	Reembolso
81	Reembolso pendiente
82	Reembolso dudoso
83	Reembolso rechazado
84	Pago denegado por la entidad adquirente (se cargará en cuenta)
85	Reembolso procesado por el comerciante
9	Pago solicitado
91	Pago procesado
92	Pago dudoso
93	Pago rechazado
94	Reembolso rechazado por la entidad adquirente
95	Pago procesado por el comerciante
97-99	Está siendo procesado (estado técnico intermedio)

La tabla anterior muestra los posibles estados de los pagos.

Los estados de 1 dígito son estados normales:

0 significa que el pago no es válido (p. ej. error de validación de datos) o que no se ha completado el procesamiento, porque todavía está en curso o porque se ha interrumpido la transacción. Si la causa es un error de validación, un código de error adicional (*) (NCERROR) identifica este error.
1 significa que el cliente ha cancelado la transacción.
2 significa que la entidad adquirente

Sí

STATUS_3D

N: fallo en la identificación
Y: identificación correcta
A: prueba de intento de autenticación
U: servidor de directorios no disponible

Sí

SUB_AM

Importe de la suscripción

Sí

N/A

100

SUB_AMOUNT

Importe de la suscripción

Sí

N/A

100

SUB_COM

descripción del pedido

Sí

100

One telephone card

SUB_COMMENT

comentario de la suscripción

Sí

200

Monthly subscription to lf World.

SUB_CUR

divisa de la suscripción

Sí

EUR

SUB_ENDDATE

fecha de fin de la suscripción

Sí

yyyy-MM-dd

2021-01-01

SUB_ORDERID

ID de pedido de la suscripción

Sí

order 123

SUB_PERIOD_MOMENT

momento del pago de una suscripción, dependiendo de sub_period_unit

Sí

N/A

SUB_PERIOD_NUMBER

intervalo entre eventos de pago de suscripción

Sí

N/A

SUB_PERIOD_UNIT

unidad del intervalo entre eventos de pago de suscripción

Sí

SUB_STARTDATE

fecha de inicio de una suscripción

Sí

yyyy-MM-dd

2021-01-01

SUB_STATUS

estado de una suscripción

Sí

SUBBRAND

Se devuelve este campo si se utiliza la submarca de una marca principal. Las submarcas pueden ser, por ejemplo, versiones prepagadas de tarjetas de crédito Visa/MasterCard Prepaid, etc.), tarjetas corporativas o tarjetas con privilegios especiales (MasterCard Platinum, Visa Infinite, etc.).

Para que se devuelva este campo, es necesario agregarlo a los parámetros de Comercio electrónico dinámico de la pestaña Respuesta de transacción de la página Información técnica.

Sí

VISA VPAY; CIRRUS

SUBSCRIPTION_ID

Identificador único de una suscripción.

Sí

subscription1

TAXINCLUDED

Sí

TBLBGCOLOR

Color de fondo de la tabla en la página de pago.

Sí

N/A

LightYellow #FFFFE0

TBLTXTCOLOR

Color del texto de la tabla en la página de pago.

Sí

N/A

Blue #0000FF

TITLE

Título de la página de pago.

Sí

N/A

John's bait shop

URL de plantilla (incluido http(s)://)/nombre.

Cuando propusimos alojar la plantilla del comerciante en nuestro servidor, el comerciante solo tiene que introducir su nombre de archivo en el campo tp en lugar de toda la URL, de esta forma la URL del comerciante se convertirá en una URL estática en nuestro sistema.

Sí

N/A

http://www.myshop.com/template.html

TRXDATE

Fecha de la transacción.

Sí

MM/DD/YY

N/A

12/25/2010

TXTCOLOR

Color del texto en la página de pago.

Sí

N/A

DarkGreen #006400

USERID

Nombre de usuario tal como se ha especificado en la página de administración del usuario de la cuenta.

El UserID predeterminado para una cuenta es igual al PSPID de la cuenta. Si el campo UserID se deja vacío al solicitar un pago a través de e-Commerce o al iniciar una sesión, tomaremos el campo PSPID como valor del UserID.

No utilice espacios ni caracteres especiales en el USERID.

Sí

Min. 5 and Max. 30

JohnD

Tipo de tarjeta virtual. Por lo general, las tarjetas virtuales son números de tarjeta de crédito virtuales de un único uso que solo se pueden utilizar en una tienda en línea predefinida.

Sí

WIN3DS

Forma de mostrar al cliente la página de identificación para 3-D Secure o para los botones de pago de KBC, CBC, Dexia e ING.

Valores posibles: MAINW, POPUP, POPIX (solo DirectLink)

Sí

MAINW

Empezar

Soluciones de integración

Métodos de pago

Rendimiento de pago

Seguridad

Noticias

Parameter Cookbook