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):

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)  No AN 2 OK
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,...
No AN 2 NO
AAVMAIL Procedimientos de autenticación para direcciones de correo electrónico. Aplicable únicamente a transacciones con American Express. No AN 2 OK,KO
AAVNAME Procedimientos de autenticación para nombres de titulares de tarjetas. Aplicable únicamente a transacciones con American Express. No AN 2 OK,KO
AAVPHONE Procedimientos de autenticación para números de teléfono. Aplicable únicamente a transacciones con American Express. No AN 2 OK,KO
AAVZIP Indica el resultado AAV para el código postal (véase también AAVCHECK) No AN 2 KO
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.
No AN 16 04306B
ACCEPTURL URL de la página web para mostrar al cliente cuando se autoriza el pago. No AN 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. No AN 30 MyPSPID123
ADDMATCH Indica si se consideran las direcciones de facturación y envío idénticas

1=sí
0=no
No AN 1 1
ADDRMATCH véase ADDMATCH No AN 1 1
AIACTIONNUMBER Número de acción No AN 17
AIAGIATA Número de agencia IATA No AN 8
AIAIRNAME Número de línea aérea No AN 20 Brussels Airlines
AIAIRTAX Tasas de aeropuerto No AN 11
AIBOOKIND*XX* Indicador de reserva No AN 2
AICARRIER*XX* Código de operador No AN 4 SN
AICHDET Detalles del cargo No AN 49
AICLASS*XX* Clase aérea No AN 15
AICONJTI Billete de conexión No AN 3
AIDEPTCODE Código de departamento de campo DBI No AN 17
AIDESTCITY*XX* Aeropuerto de llegada (corto) No AN 5 BLQ
AIDESTCITYL*XX* Aeropuerto de llegada (largo) No AN 20 Guglielmo Marconi
AIEXTRAPASNAME*XX* Nombre adicional del pasajero No AN 49
AIEYCD Código de área de destino No AN 3
AIFLDATE*XX* Fecha de vuelo No YYYYMMDD 20 20120504
AIFLNUM*XX* Número de vuelo No AN 4 1234
AIGLNUM Número de cuenta de campo DBI No AN 17
AIINVOICE Número de nota de entrega/factura No AN 17
AIIRST Tipo de código de área de destino No AN 1
AIORCITY*XX* Aeropuerto de salida (corto) No AN 5 BRU
AIORCITYL*XX* Aeropuerto de salida (largo) No AN 20 Brussels
AIPASNAME Nombre del pasajero No AN 49
AIPROJNUM Número de proyecto de campo DBI No AN 17
AISTOPOV*XX* Escala No AN 1
AITIDATE Fecha de emisión de billete No Date/Time 20 15/04/2012 13:14:56
AITINUM Número de billete No AN 16 123
AITINUML*XX* Número de billete No AN 16 123
AITYPCH Tipo de cargo No AN 2
AIVATAMNT Importe del IVA No AN 11
AIVATAPPL IVA aplicable No AN 1
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.
AN 50 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.
No AN 30 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.
No AN 40 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.
No AN 1 Y or N
ALIASOPERATION Indica quién ha determinado/seleccionado el alias, el comerciante o nuestro sistema.

Valores posibles: BYMERCHANT o BYPSP
No AN 10 BYPSP
ALIASPERSISTEDAFTERUSE 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.
No 1 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. No AN 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.
N 15 Sent: 12995 Returned: 129.95
AUTHORIZATION CODE (* 100 para evitar decimales). No AN 10 A437956
AUTHORIZATION DATE

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

No MM/DD/YY HH:MM:SS 17 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
No AN 3 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. No AN 200 http://www.myshop.com/selectPM.html
BGCOLOR Color de fondo de la página de pago. No AN N/A Blue #0000FF
BIC Código de identificación de banco (utilizado para operaciones de adeudo directo) 11 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. No N 6 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.

AN 25 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
No AN 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
No AN 2 1
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). No A 5 TRUE
browserLanguage Value representing the browser language as defined in IETF BCP47. Returned from navigator language property. No AN 8 en
browserScreenHeight Total height of the Cardholder’s screen in pixels. Value is returned from the screen height property. Between 0 and 999999 No AN 6 1024
browserScreenWidth Total width of the cardholder’s screen in pixels. Value is returned from the screen width property Between 0 and 999999 No AN 6 1024
browserTimeZone Time difference between UTC time and the Cardholder browser local time, in minutes between -840 and 720 No AN 3 -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.
No AN 2048
BUTTONBGCOLOR Color de fondo del botón en la página de pago. No AN N/A Black #000000
BUTTONTXTCOLOR Color del texto del botón en la página de pago. No AN N/A White #FFFFFF
CANCELURL URL de la página web para mostrar al cliente cuando cancela el pago. No AN 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.
No AN 25 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

No AN 26 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.
AN 21 XXXXXXXXXXXX1111
CATALOGURL URL del catálogo del comerciante No AN 200 http://www.myshop.com/shop.html
CAVV_3D conforme a respuesta de ACS No AN 300
CAVVALGORITHM_3D conforme a respuesta de ACS No N 1 5
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.
No AN 2 US
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
No AN 128 Please contact your bank for further information.
CIVILITY Tratamiento del cliente (Sr., Sra., D., Dª, etc.) No AN 5 Mr.
CN 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.
AN 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
No 3 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
No 7 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

No 5 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.
No AN 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.
AN 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)

No N 3 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.

No AN 50 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).
AN 3 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).
No N 5 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,...
No AN 2 OK
DATATYPE El valor es VIAJE si usted proporciona datos de un viaje a nuestro sistema y es un campo obligatorio No AN 6 TRAVEL
DATEIN fecha de llegada No dd/MM/yyyy 10 40658
DATEOUT fecha de salida No dd/MM/yyyy 10 40659
DCC_COMMPERCENTAGE porcentaje de comisión eDCC No N
DCC_CONVAMOUNT importe convertido eDCC No N
DCC_CONVCCY divisa de destino eDCC No AN 3 EUR
DCC_EXCHRATE tipo de cambio eDCC No N
DCC_EXCHRATESOURCE fuente del tipo de conversión eDCC No N 50
DCC_EXCHRATETS sello de tiempo del tipo de conversión eDCC No N
DCC_INDICATOR indicador eDCC No N
DCC_MARGINPERCENTAGE porcentaje de margen eDCC No N
DCC_VALIDHOURS validez eDCC (en horas) del tipo de conversión, a partir de la hora/fecha definida en DCC_EXCHRATETS No N
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). No AN 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 No AN 6 mobile
DIGESTCARDNO resumen SHA del número de tarjeta utilizado durante la transacción No AN 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.
No N 2 4
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

No N 2 5
ECOM_BILLTO_POSTAL_CITY Localidad de facturación No AN 25 Brussels
ECOM_BILLTO_POSTAL_COUNTRYCODE País de facturación No AN 2 BE
ECOM_BILLTO_POSTAL_COUNTY Invoicing county No AN 25 South Yorkshire (UK)
ECOM_BILLTO_POSTAL_NAME_FIRST Nombre del cliente facturado No AN 35 Bill
ECOM_BILLTO_POSTAL_NAME_LAST Apellidos del cliente facturado No AN 35 Smith
ECOM_BILLTO_POSTAL_POSTALCODE Código postal de facturación No AN 10 1200
ECOM_BILLTO_POSTAL_STREET_LINE1

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

No AN 60 Billing Street
ECOM_BILLTO_POSTAL_STREET_LINE2

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

No AN 60 Building 123
ECOM_BILLTO_POSTAL_STREET_NUMBER Número de vivienda en la dirección de facturación No AN 10 1
ECOM_CONSUMER_GENDER Sexo No AN (M or F) 1 F
ECOM_CONSUMERID Identificación del cliente en el sistema del comerciante. No AN 50 Customer1
ECOM_PAYMENT_CARD_VERIFICATION Véase CVC. No N 5 758
ECOM_SHIPMETHODDETAILS Identificación del punto de recogida No AN 50
ECOM_SHIPTO_COMPANY Delivery address: Company No AN 50 My Company
ECOM_SHIPTO_DOB

Fecha de nacimiento

No dd/MM/yyyy 10 01/01/2001
ECOM_SHIPTO_ONLINE_EMAIL Dirección de correo electrónico No AN 50 bill@smith.com
ECOM_SHIPTO_POSTAL_CITY Localidad de envío No AN 25 Brussels
ECOM_SHIPTO_POSTAL_COUNTRYCODE Código de país de envío No AN 2 BE
ECOM_SHIPTO_POSTAL_COUNTY Delivery county No AN 25 Bailey (US, TX)
ECOM_SHIPTO_POSTAL_NAME_FIRST Nombre del cliente destinatario del envío No AN 35 Bill
ECOM_SHIPTO_POSTAL_NAME_LAST Apellidos del cliente destinatario del envío No AN 35 Smith
ECOM_SHIPTO_POSTAL_NAME_PREFIX Prefijo del cliente destinatario del envío No AN 10 Mr.
ECOM_SHIPTO_POSTAL_POSTALCODE Código postal de envío No AN 10 1200
ECOM_SHIPTO_POSTAL_STATE Estado de entrega, código ISO No AN 2 CA (California)
ECOM_SHIPTO_POSTAL_STREET_LINE1 Dirección de envío, primera línea No AN 35 Ship street
ECOM_SHIPTO_POSTAL_STREET_LINE2 Dirección de envío, segunda línea No AN 35 Building 2
ECOM_SHIPTO_POSTAL_STREET_NUMBER Número de vivienda en la dirección de envío No AN 10 2
ECOM_SHIPTO_TELECOM_FAX_NUMBER Número de fax en la dirección de envío No AN 20 +32 2 123 4567
ECOM_SHIPTO_TELECOM_PHONE_NUMBER Número de teléfono en la dirección de envío No AN 20 +32 2 123 456
ED

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.

Input: MM/YY or MMYY Output: MMYY 7 1224
EMAIL 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. No AN 50 John.Doe@test.com
EXCEPTIONURL URL de la página web para mostrar al cliente cuando el resultado del pago es dudoso. No AN 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 No AN 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. No AN 1 Y
FONTTYPE Tipo/Familia de fuentes utilizadas en la página de pago. No AN 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. No AN 15 neworders15
HOMEURL URL del sitio web del comerciante No AN 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.
No AN 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. No AN 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. No AN 255 User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)
IP 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 AN 20 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.
No AN 2 UK
ISSUERID Para preseleccionar un banco para una transacción iDEAL que coincida con el BIC del banco. No N 10 ABNANL2A
ITEMATTRIBUTES*XX* Atributos del artículo
sustituya *XX* por un número para enviar varios artículos
No AN 50
ITEMCATEGORY*XX* Categoría del artículo
sustituya *XX* por un número para enviar varios artículos
No AN 50
ITEMCOMMENTS*XX* Comentarios del artículo
sustituya *XX* por un número para enviar varios artículos
No AN 255
ITEMDESC*XX* Descripción del artículo
sustituya *XX* por un número para enviar varios artículos
No AN 16
ITEMDISCOUNT*XX* Descuento del artículo
sustituya *XX* por un número para enviar varios artículos
No N
ITEMID*XX* Identificador del artículo
sustituya *XX* por un número para enviar varios artículos
No AN 15
ITEMNAME*XX* Nombre del artículo
sustituya *XX* por un número para enviar varios artículos
No AN 40
ITEMPRICE*XX* Precio del artículo
sustituya *XX* por un número para enviar varios artículos
No N
ITEMQUANT*XX* Cantidad del artículo
sustituya *XX* por un número para enviar varios artículos
No N
ITEMQUANTORIG*XX* Cantidad máxima por artículo No N
ITEMUNITOFMEASURE*XX* Unidad de medida del artículo (para utilizar en combinación con ITEMWEIGHT*XX*) No AN 50
ITEMVAT*XX* Importe del IVA del artículo No N
ITEMVATCODE*XX* Código de IVA del artículo No N
ITEMWEIGHT*XX* Peso del artículo No N
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)
No AN 5 fr_FR
Layout.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)
No AN 5 en_US
LOGO Logotipo a mostrar en la página de pago. No AN N/A myshoplo.gif or https://www.myshop.com/myshoplo.gif
MANDATEID Domiciliaciones bancarias DE/NL: Referencia de autorización única AN 35
Mpi. provisionAttemptsInTheLast24Hours

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

No AN 3 10
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

No AN 2 01
Mpi.cardholderAccountChange

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's account with the merchant was last changed including Billing or Shipping address new payment account or new user(s) added.

No YYYYMMDD 8 20190101
Mpi.cardholderAccountChangeIndicator

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.

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

No AN 2 1
Mpi.cardholderAccountDate

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.

No YYYYMMDD 8 20190101
Mpi.cardholderAccountPasswordChangeIndicator

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.

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

No AN 2 1
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

No AN 2 01
Mpi.deliveryEmailAddress For Electronic delivery, the email address to which the merchandise was delivered. No AN 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

No AN 2 01
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 No AN 15 123
Mpi.giftCardCount For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased. Between 0 and 99 No AN 2 10
Mpi.giftCardCurrency For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217 No AN 3 USD
Mpi.HomePhone.countryCode Country code of a home phone
ITU-E.164 country code
No AN 3 55
Mpi.HomePhone.subscriber Home phone (without country code) No AN 15 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)
No AN 2 1
Mpi.MobilePhone.countryCode Country code of a mobile phone
ITU-E.164 country code
No AN 3 55
Mpi.MobilePhone.subscriber Mobile phone (without country code) No AN 15 1234
Mpi.numberOfPurchaseWithAccountInTheLastSixMonths

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.

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

No AN 4 10
Mpi.paymentAccountAge

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 payment account was enrolled in the cardholder’s account with the merchant.

No YYYYMMDD 8 20190101
Mpi.paymentAccountAgeIndicator

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.

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

No AN 2 1
Mpi.preOrderDate For a pre-ordered purchase, the expected date that the merchandise will be available. No YYYYMMDD 8 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

No AN 2 01
Mpi.reorderItemsIndicator

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

No AN 2 01
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
No 1 Y
Mpi.shippingAddressUsage

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

No AN 8 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

No AN 2 01
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.)
No AN 2 1
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). No A 5 TRUE
Mpi.suspiciousAccountActivityDetected Indicates whether the merchant has experienced suspicious activity (including previous fraud) on the cardholder account (possible values TRUE or FALSE). No A 5 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
No AN 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"

No AN 2 02
Mpi.threeDSRequestorAuthenticationTimestamp

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

No Date/Time 14 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.

No AN 2 02
Mpi.threeDSRequestorPriorAuthenticationData 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,these fields carry data that the ACS can use to verify the authentication process. No AN 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

No AN 2 02
Mpi.threeDSRequestorPriorAuthenticationTimestamp

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

No Date/Time 14 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).
No AN 36
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
No AN 3 10
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
No AN 3 10
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

No AN 2 01
Mpi.WorkPhone.countryCode Country code of a work phone ITU-E.164 country code No AN 3 55
Mpi.WorkPhone.subscriber Phone used for work purposes (without country code) No AN 15 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.

No AN 10 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.

No AN 255 Invalid card number
NCSTATUS Estado del error. En general, este es el primer dígito de NCERROR. No AN 4 3
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.
No A 3 RFD
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.
40 AB5456CB896
ORDERSHIPCOST ! No AN 10
ORDERSHIPTAXCODE ! No AN 10
OWNERADDRESS Dirección del cliente No AN 35 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 
No AN 2 BE
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.  
No AN 30 Batch:20 3222869611
OWNERTOWN Localidad del cliente. No AN 25 Brussels
OWNERZIP Código postal del cliente. No AN 10 1000
Parameters.AcceptUrl URL de la página web para mostrar al cliente cuando se autoriza el pago. No AN 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. No AN 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 No AN 50 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&…
No AN 1000 SessionID=126548354&ShopperID=73541312
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&…
AN 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. No AN 50 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.

N 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. N N/A 1
PAYMENTOCCURRENCE Code to indicate the number of payment occurrences. This parameter is used only with specific payment methods (referenced in the dedicated guides). No N 2 42
PM

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

AN 25 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
 

No AN 200 VISA;MasterCard;American Express
PMLISTTYPE Forma de presentar los iconos de métodos de pago en la página de pago. No N N/A 2
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. No AN 30 JDoeSHOP
PSWD Contraseña para el PSPID (usuario predeterminado) o un UserID específico. No AN 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

No AN 10 12345ABCDZ6789
RECIPIENTDOB

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

No dd/MM/yyyy 10 2/3/1982
RECIPIENTLASTNAME

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

No AN 6
RECIPIENTZIP

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

No AN 6 W1A 1AA
REF_CUSTOMERID tareas pendientes No AN 20 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).
No AN 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.
No N 2 45
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).
No AN 1 G
SCORING Puntuación final de una transacción. Consulte el módulo de detección de fraude avanzado: documentación sobre puntuación. No N 4 17
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
AN 4 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).
AN 128 172386BFF99BC8F899035E356497D4334958F2D4
ShaSignature.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).
No AN 128 172386BFF99BC8F899035E356497D4334958F2D4
SIGNDATE Domiciliaciones bancarias NL: Fecha en la que el comprador firmó la autorización. YYYYMMDD 8 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
No N 2 9
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
No AN 1 N
SUB_AM Importe de la suscripción No N N/A 100
SUB_AMOUNT Importe de la suscripción No N N/A 100
SUB_COM descripción del pedido No AN 100 One telephone card
SUB_COMMENT comentario de la suscripción No AN 200 Monthly subscription to lf World.
SUB_CUR divisa de la suscripción No AN 3 EUR
SUB_ENDDATE

fecha de fin de la suscripción

No yyyy-MM-dd 10 2021-01-01
SUB_ORDERID ID de pedido de la suscripción No AN 40 order 123
SUB_PERIOD_MOMENT momento del pago de una suscripción, dependiendo de sub_period_unit No N N/A 1
SUB_PERIOD_NUMBER intervalo entre eventos de pago de suscripción No N N/A 15
SUB_PERIOD_UNIT unidad del intervalo entre eventos de pago de suscripción No AN 2 d
SUB_STARTDATE

fecha de inicio de una suscripción

No yyyy-MM-dd 10 2021-01-01
SUB_STATUS estado de una suscripción No AN 1 0
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.
No AN 25 VISA VPAY; CIRRUS
SUBSCRIPTION_ID Identificador único de una suscripción. AN 50 subscription1
TAXINCLUDED ! No AN 1 1
TBLBGCOLOR Color de fondo de la tabla en la página de pago. No AN N/A LightYellow #FFFFE0
TBLTXTCOLOR Color del texto de la tabla en la página de pago. No AN N/A Blue #0000FF
TITLE Título de la página de pago. No AN N/A John's bait shop
TP 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.
No AN N/A http://www.myshop.com/template.html
TRXDATE Fecha de la transacción. No MM/DD/YY N/A 12/25/2010
TXTCOLOR Color del texto en la página de pago. No AN 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.
No AN Min. 5 and Max. 30 JohnD
VC 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. No AN 3 NO
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)
No AN 6 MAINW