PARÁMETROS DE ENTRADA
Los parámetros para realizar la integración pueden consultarse en los siguientes enlaces:
PARÁMETROS DE ENTRADA
PARÁMETROS DE SALIDA
Los parámetros para realizar la integración pueden consultarse en los siguientes enlaces:
PARÁMETROS DE ENTRADA
PARÁMETROS DE SALIDA
Parámetros de Entrada
| DATO | Long. / Tipo | TIPO OPERACIÓN |
REDIRECCION |
REST/SOAP |
COMENTARIOS | |
|---|---|---|---|---|---|---|
| Importe | DS_MERCHANT_AMOUNT | 12/N | 0,1,2,3,7,8,9,11,15,17,34,37,45,46,47,48 | OBLIGATORIO | OBLIGATORIO | Las últimas posiciones hacen referencia a los decimales de la moneda.Ejemplo: En el caso del EURO 43,45 Euros habría que indicar 4345. |
| Código de Autorización | DS_MERCHANT_AUTHORISATIONCODE | 6/AN | 3 | OPCIONAL | OPCIONAL | Representa el código de autorización necesario para identificar de manera inequivoca la transacción original sobre la que se desea realizar la devolución. No se trata de un valor único por transacción, se puede repetir. Este parámetro tiene sentido en aquellos comercios que permiten repetir el número de pedido. |
| Indicador de transacción COF | DS_MERCHANT_COF_INI | 1/AN | 0,1,7,15 | OPCIONAL | OPCIONAL | Obligatorio para operativa COF Visa y MC. Valores
posibles:
|
| Identificador de transacción COF | DS_MERCHANT_COF_TXNID | 15/AN | 0,1,7 | OPCIONAL | OPCIONAL | Opcional. Este identificador es devuelto en la
respuesta de la primera operación COF (almacenamiento de
credenciales), y deberá enviarse en transacciones sucesivas
realizadas con las credenciales que generaron este mismo
Id_txn. |
| Tipo de transacción COF | DS_MERCHANT_COF_TYPE | 1 / AN | 0,1,7,15 | OPCIONAL | OPCIONAL | Opcional para COF Visa y MC. Valores posibles:
|
| Idioma del titular | DS_MERCHANT_CONSUMERLANGUAGE | 3/N. | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | Los valores posibles se incluyen en la tabla de idiomas | |
| Moneda | DS_MERCHANT_CURRENCY | 3/N | 0,1,2,3,7,8,9,11,15,17,34,37,45,46,47,48 | OBLIGATORIO | OBLIGATORIO | Se debe enviar el código numérico de la moneda según el ISO-4217, ver tabla de monedas. |
| CVV2 | DS_MERCHANT_CVV2 | 3-4/N | 0,1,7,17,34,37 | CONDICIONAL | CONDICIONAL | Código CVV2 de la tarjeta. |
| Indicador de pago sin autenticación | DS_MERCHANT_DIRECTPAYMENT | 4/N | 0,1,7,15,17,37 | OPCIONAL | OPCIONAL | Valores posibles:
|
| JSON con la información de la autenticación | DS_MERCHANT_EMV3DS | Variable/JSON Object | 0,1,7,17 | OPCIONAL | OPCIONAL | Este campo contiene toda la información necesaria para
autenticación EMV3DS (V1 o V2).
***Con el fin de mejorar la experiencia del usuario en el proceso de autenticación, se recomienda añadir en la petición de pago los siguientes parámetros definidos en la versión EMV 3DS v2 (Email, homePhone, shipAddrLine1 y dentro de acctInfo: chAccChange, chAccDate y txnActivityYear), que aportan datos adicionales del titular de la tarjeta y del dispositivo que se está utilizando . Ver tabla DS_MERCHANT_EMV3DS |
| Caducidad | DS_MERCHANT_EXPIRYDATE | 4/N | 0,1,7,17,34,37 | CONDICIONAL | CONDICIONAL | Caducidad de la tarjeta. Su formato es AAMM, siendo AA los dos últimos dígitos del año y MM los dos dígitos del mes. |
| Código de grupo | DS_MERCHANT_GROUP | 9/N | 0,1,7,15,17,37 | CONDICIONAL | CONDICIONAL | Identificador del código de grupo asociado a la referencia |
| Referencia | DS_MERCHANT_IDENTIFIER | 40/N | 0,1,7,15,17,38 | OPCIONAL | OBLIGATORIO | Este parámetro indica la referencia de la tarjeta a
utilizar, o la solicitud de generar una referencia. Para generar una nueva referencia enviar "REQUIRED" en el caso de REST/SOAP el parámetro DS_MERCHANT_PAN es Obligatorio. |
| Identificador de la operación de INSITE | DS_MERCHANT_IDOPER | 40/A-N | 0,1,7,17,37 | OPCIONAL | OPCIONAL | Identificador de la operación de INSITE. |
| Identificación de comercio: código FUC | DS_MERCHANT_MERCHANTCODE | 9/N. | 0,1,2,3,7,8,9,11,15,17,34,37,45,46,47,48 | OBLIGATORIO | OBLIGATORIO | Código FUC asignado al comercio.(Nº de comercio) |
| Datos del comercio | DS_MERCHANT_MERCHANTDATA | 1024 /A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | OPCIONAL | Cadena de datos que no procesará el TPV-Virtual y se devolverán de la misma forma en la respuesta |
| Identificación de comercio: | DS_MERCHANT_MERCHANTNAME | 25/A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | OPCIONAL | Para la entrada de realizar pago esta información se mostrará al titular en la pantallas con las que este interaciona. En caso de no informarse aparecerá el nombre configurado en la administración del TPV- Virtual. |
| URL del comercio para la notificación "on-line" | DS_MERCHANT_MERCHANTURL | 250/A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | Si el comercio tiene configurada notificación online "HTTP" en el módulo de administración, se enviará una petición post con el resultado de la transacción a la URL especificada. | |
| Número de Pedido | DS_MERCHANT_ORDER | 12 / A-N. | 0,1,2,3,7,8,9,11,15,17,34,37,45,46,47,48 | OBLIGATORIO | OBLIGATORIO | Se recomienda, por posibles problemas en el proceso de
liquidación, que los 4 primeros dígitos sean numéricos. Para
los dígitos restantes solo utilizar los siguientes caracteres
ASCII:
|
| Tarjeta | DS_MERCHANT_PAN | 19/N | 0,1,7,17,34,37 | OPCIONAL | CONDICIONAL | Tarjeta. Su longitud depende del tipo de tarjeta. |
| Forma de pago aplicable | DS_MERCHANT_PAYMETHODS | 1/A | Ver tabla DS_MERCHANT_PAYMETHODS | OPCIONAL | Ver tabla DS_MERCHANT_PAYMETHODS | |
| Descripción del producto | DS_MERCHANT_PRODUCTDESCRIPTION | 125 / A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | OPCIONAL | La longitud máxima es 125. Para la entrada de realizar pago esta información se mostrará al titular en la pantallas con las que este interaciona. |
| Código del tributo a pagar | DS_MERCHANT_TAX_REFERENCE | 100/N | 0 | OPCIONAL | OPCIONAL | Operativa especial de pago de tributos. Código de barras del tributo en operativa especial de pago de tributos. Se requiere activación por parte de la entidad. |
| Número de terminal | DS_MERCHANT_TERMINAL | 3/N. | 0,1,2,3,7,8,9,11,15,17,34,37,45,46,47,48 | OBLIGATORIO | OBLIGATORIO | Número de terminal que le asignará su banco. |
| Nombre y apellidos del titular | DS_MERCHANT_TITULAR | 60/A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | OPCIONAL | Su longitud máxima es de 60 caracteres. Para la entrada de realizar pago esta información se mostrará al titular en la pantallas con las que este interaciona. En la pantalla de pago, el titular podrá modificar este valor. |
| Fecha de la operación | DS_MERCHANT_TRANSACTIONDATE | 10 / A-N | 3 | OPCIONAL | OPCIONAL | Formato yyyy-mm-dd. Representa la fecha de la operación sobre que la se realiza la devolución, este campo es necesario para identificar de manera inequivoca la transacción original sobre la que se desea realizar la devolución. Este parámetro tiene sentido en aquellos comercios que permiten repetir el número de pedido. |
| Tipo de transacción | DS_MERCHANT_TRANSACTIONTYPE | 1 / Num | 0,1,2,3,7,8,9,11,15,17,34,37,45,46,47,48 | OBLIGATORIO | OBLIGATORIO | Tipo de operación.Ver tabla DS_MERCHANT_TRANSACTTIONTYPE |
| URL KO | DS_MERCHANT_URLKO | 250/A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | URL en la que se enviará una petición HTTP get cuando el resultado de la transacción sea KO. Si este parámetro no viene informado se usará la configuración en el módulo de administración. | |
| URLOK | DS_MERCHANT_URLOK | 250/A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | URL en la que se enviará una petición HTTP get cuando el resultado de la transacción sea OK. Si este parámetro no viene informado se usará la configuración en el módulo de administración. | |
| Datos de XPAY | DS_XPAYDECODEDDATA | JSON | 0.1 | CONDICIONAL | Campo en el que se incluyen los datos descrifrados en referencia a los xPay ver tabla DS_XPAYDECODEDATA | |
| Datos de XPAY | DS_XPAYDATA | 10000 / A-N | 0.1 | CONDICIONAL | Campo en el que se incluyen los datos del enviados por el xPay en formato Hexadecimal. | |
| Origen XPAY | DS_XPAYORIGEN | 5 / A-N | 0.1 | CONDICIONAL | Origen de la petición. Los posibles valores son:
|
|
| Tipo de XPAY | DS_XPAYTYPE | 10 / A-N | 0.1 | CONDICIONAL | Tipo de xPay. Los posibles valores son:
|
|
| Indicador de obtención de datos de dirección de PayPal | DS_MERCHANT_SHIPPINGADDRESSPYP | 1 / N | 0,1,15 | OPCIONAL | Indica si entre los campos de respuesta al comercio se
incluye información relativa a la dirección de envío que tiene
el titular configurada en su cuenta PayPal. Los valores que se
pueden indicar en dicho campo son:
|
|
| Descriptor Flexible | DS_MERCHANT_MERCHANTDESCRIPTOR | 25 / A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | El valor de este parámetro es de 25 posiciones (caracteres). Si el comercio está configurado para poder enviar este parámetro y no envía ninguna información, o no está configurado, por defecto se enviará el nombre del comercio. Requiere activación por porte de la entidad. | |
| Código de personalización | DS_MERCHANT_PERSOCODE | 1 / N | 0,1,3,7,8,9,15,34,37 | OPCIONAL | Número de personalización que se desea utilizar en la
operación. Si no se informa dicho parámetro o el valor que se
informa no corresponde con un número de personalización activa
existente | |
| Matching data | DS_MERCHANT_MATCHINGDATA | 21/A-N | 17 | CONDICIONAL | No debe repetirse. Valor que enviará en la respuesta para identificar a la petición | |
| Identificador del que procesará la operación | DS_ACQUIRER_IDENTIFIER | 6/N | 17 | CONDICIONAL | Es el valor de la interfaz PUC, por dónde el comercio procesará la transacción de autorización. | |
| Parámetros para MPI External | DS_MERCHANT_MPIEXTERNAL | JSON | 0,1,7 | OPCIONAL | Ver tabla DS_MERCHANT_MPIEXTERNAL | |
| Telefóno del titular para PayGold | DS_MERCHANT_CUSTOMER_MOBILE | 19 /A-N | 15 | CONDICIONAL | Para informar el número de teléfono del titular para enviar el SMS con el enlace. | |
| Mail del titular para PayGold | DS_MERCHANT_CUSTOMER_MAIL | 100 /A-N | 15 | CONDICIONAL | Para informar la dirección de mail del titular para enviar el enlace. | |
| Fecha de caducidad enlace PayGold | DS_MERCHANT_P2F_EXPIRYDATE | 23/ A-N | 15 | CONDICIONAL | Permite especificar la fecha de caducidad del enlace siendo posible especificar la fecha de cada operación mediante este parámetro. El valor del campo podrá ser el número de minutos desde la operación o la fecha y hora exacta de caducidad con el siguiente formato: aaaa-mm-dd-HH:MM:ss.sss (por ejemplo 2014-08-06-16.31.35.318). | |
| Texto del SMS de PayGold | DS_MERCHANT_CUSTOMER_SMS_TEXT | 160/A-N | 15 | CONDICIONAL | Personalización de los mensajes SMS enviados al
usuario. Este campo contendrá una cadena de texto con los
campos relevantes entre arrobas, es obligatorio incluir siempre
la URL (@URL@). Los campos soportados son @COMERCIO@,
@IMPORTE@, @MONEDA@ y @URL@. Se sustituirán dichos campos por
los valores correspondientes. Es recomendable limitar la
longitud del texto (máximo 160 caracteres) para que se envíe en
un único SMS. Mensaje de ejemplo:
|
|
| Texto del Mail de PayGold | DS_MERCHANT_P2F_XMLDATA | 1000/A-N | 15 | CONDICIONAL | Personalización de los mensajes de correo enviados.
Dicho campo permite pasar TAGs para la personalización. Es
importante escapar los símbolos <>y / como < > y
/ así como dejarlos dentro del CDATA. Cualquier error aquí podría ocasionar que el XML no esté bien formado y que la petición falle por lo que es obligatorio escapar también los caracteres especiales como acentos etc. Los campos que incluye este parámetro son:
|
|
| Campo indicador para la solicitud de DCC y envio de información DCC | DS_MERCHANT_DCC | JSON | 0 | OPCIONAL | Enviar Y o N para la solicitud de iniciaPetición. Para mandar información de DCC ver tabla DS_MERCHANT_DCC. | |
| Exenciones para PDS2 | DS_MERCHANT_EXCEP_SCA | 3/A-N | 0.1 | OPCIONAL | OPCIONAL | Valores posibles: MIT , LWV, TRA, COR, ATD, NDF. Requiere activación por parte de la Entidad. |
| Exenciones para PDS2 | DS_MERCHANT_OTA | 1/N | 7 | OPCIONAL | OPCIONAL | Valor: S (petición inicial OTA SI).Petición de operación inicial de Autenticación de Viajes Online (OTA) |
| IP de cliente | DS_MERCHANT_CLIENTIP | 15/A-N | 0,1,2,3,7,8,9,15,17,34,37 | OPCIONAL | OPCIONAL | |
| Valor RTS para Devoluciones de confirmaciones parciales. | DS_MERCHANT_RTS | 24/N | 3 | OPCIONAL | OPCIONAL | Obligatorio para realizar una devolución de una confirmación parcial |
| DATO | Long. / Tipo | REALIZAR PAGO |
REST/SOAP |
COMENTARIOS | |
|---|---|---|---|---|---|
| Fecha | DS_DATE | dd/mm/yyyy | OBLIGATORIO | Fecha de la transacción | |
| Hora | DS_HOUR | HH:mm | OBLIGATORIO | Hora de la transacción | |
| Importe | DS_AMOUNT | 12 / Núm. | OBLIGATORIO | OBLIGATORIO | Mismo importe que se envió en la petición. |
| Moneda | DS_CURRENCY | 3 / Núm. | OBLIGATORIO | OBLIGATORIO | Misma moneda que se envió en la petición. Lo de la longitd ya viene en otra columna. |
| Número de pedido | DS_ORDER | 12 / A-N. | OBLIGATORIO | OBLIGATORIO | Mismo pedido que se envió en la petición. |
| Identificación de comercio: código FUC | DS_MERCHANTCODE | 9 / N. | OBLIGATORIO | OBLIGATORIO | Mismo código de comercio que se envió en la petición. |
| Terminal | DS_TERMINAL | 3 / Núm. | OBLIGATORIO | OBLIGATORIO | Mismo código de terminal que se envió en la petición |
| Código de respuesta | DS_RESPONSE | 4 / Núm. | OBLIGATORIO | OBLIGATORIO | Valor que indica el resultado de la operación. Indicará si ha sido autorizada o no. Ver tabla Ds_Response |
| Datos del comercio | DS_MERCHANTDATA | 1024 / A-N | OPCIONAL | OPCIONAL | Información opcional enviada por el comercio en el formulario de pago. |
| Pago Seguro | DS_SECUREPAYMENT | 1 / Núm. | OBLIGATORIO | OBLIGATORIO |
|
| Tipo de operación | DS_TRANSACTIONTYPE | 1 / A-N | OBLIGATORIO | OBLIGATORIO | Tipo de operación que se envió en el formulario de pago |
| País del titular | DS_CARD_COUNTRY | 3/Núm | OPCIONAL | OPCIONAL | País de emisión de la tarjeta con la que se ha intentado realizar el pago. En el siguiente enlace es posible consultar los códigos de país y su correspondencia: http://unstats.un.org/unsd/methods/m49/m49alpha.htm |
| Código de autorización | DS_AUTHORISATIONCODE | 6/ A-N | OPCIONAL | OPCIONAL | Código alfanumérico de autorización asignado a la aprobación de la transacción por la institución autorizadora. No se trata de un valor único por transacción, se puede repetir. |
| Idioma del titular | DS_CONSUMERLANGUAGE | 3 / Núm | OPCIONAL | El valor 0, indicará que no se ha determinado el idioma del cliente. | |
| Tipo de Tarjeta | DS_CARD_TYPE | 1 / A-N | OPCIONAL | OPCIONAL | Valores posibles:
|
| Marca de Tarjeta | DS_CARD_BRAND | 2 / Núm | OPCIONAL | OPCIONAL | "No se debe hacer una validación cerrada sobre estos
valores, pues pueden variar y/o añadise nuevos. Valores
posibles:
|
| Número de tarjeta | DS_CARD_NUMBER | 19/N | OPCIONAL | Tarjeta. Su longitud depende del tipo de tarjeta. | |
| Fecha caducidad de la tarjeta | DS_EXPIRYDATE | 4/N | OPCIONAL | Caducidad de la tarjeta. Su formato es AAMM, siendo AA los dos últimos dígitos del año y MM los dos dígitos del mes. | |
| Referencia de la tarjeta | DS_MERCHANT_IDENTIFIER | 8/N | OPCIONAL | Este parámetro indica la referencia de la tarjeta a utilizar | |
| Código de error | DS_ERRORCODE | 7/A-N | OPCIONAL | Código de error | |
| Código de error | ERRORCODE | 7/A-N | Código de error | ||
| Código de error | CODIGO | 7/A-N | Valores posibles:
|
||
| Enlace de pago Paygold | DS_URLPAGO2FASES | Max 80 /A-N | OPCIONAL | URL del enlace que se le envía al cliente para realizar el pago PayGold | |
| Firma | DS_SIGNATURE | 44 / A-N | OBLIGATORIO | Firma de la petición de respuesta | |
| Información sobre DCC | DS_DCC | Json | OPCIONAL | Información sobre DCC, ver tabla DS_DCC | |
| Información sobre pago seguro | DS_EMV3DS | Json | OPCIONAL | OPCIONAL | Información sobre EMV3DS, ver Tabla DS_EMV3DS |
| Tarjeta afectada por PSD2 | DS_CARD_PSD2 | Max 1/A-N | OBLIGATORIO | Parámetro de respuesta en iniciaPeticion. Valores posibles: Y (Si afectada) o N (no afectada) | |
| Excepciones permitidas | Ds_Excep_SCA | Max 40 /A-N | OPCIONAL | OPCIONAL | Parámetro de respuesta en iniciaPeticion. Valores posibles un subjunto de: LWV;TRA[30.0];COR;MIT;ATD;WHL |
| Identificador de transacción COF | Ds_ProcessedPayMethod | 3/N | OPCIONAL | OPCIONAL | Opcional. Informa sobre el método en el que se ha realizado la operación:, ver Tabla DS_ProcessedPayMethod |
| Identificador de transacción COF | Ds_Merchant_Cof_Txnid | Max 15 / AN | OPCIONAL | OPCIONAL | Este identificador es devuelto en la respuesta de la primera operación COF (almacenamiento de credenciales), y deberá enviarse en transacciones sucesivas realizadas con las credenciales que generaron este mismo Id_txn. |
| Importe en la moneda DCC | Ds_Amount_DCC | Max 12 / N | OPCIONAL | OPCIONAL | Solo aplica en operaciones DCC. |
| Contravalor en euros cuando la operación se realiza en moneda diferente de euro | Ds_Amount_Euro | Max 12 / N | OPCIONAL | OPCIONAL | Solo aplica en operaciones DCC. |
| Codigo de moneda DCC | Ds_Currency_DCC | Max 3 / N | OPCIONAL | OPCIONAL | Solo aplica en operaciones DCC. |
| Valor RTS en Confirmaciones Parciales | rts | Max 24 / N | OPCIONAL | OPCIONAL | Solo aplica en confirmaciones parciales TransactionType 48. Este valor se envía en la respuesta de la confirmación parcial para que en el caso de querer realizar una devolución de esa confirmación, se envíe en el parámetro de entrada DS_MERCHANT_RTS.L |
| Valor de control | Ds_Control_XXXXXXXXXXXXX | Max 13 / N | OPCIONAL | OPCIONAL | Se trata de un campo con valor aleatorio pensado para que el comercio esté preparado a recibir campos nuevos sin que esto afecte a su servicio, con esto se pretende que no se realice una validación restrictiva de los campos en la respuesta que se envía al comercio y que cuando se envíe uno nuevo no afecte al comercio |
| Método de pago | Valor |
|---|---|
| 1 | Visa Secure |
| 3 | Tradicional Mundial |
| 5 | Finanet |
| 11 | Capacidad FINANET |
| 13 | Capacidad Visa Secure |
| 14 | Tradicional UE |
| 22 | MasterCard Identity Check |
| 23 | Capacidad Identity Check |
| 24 | Pago AMEX |
| 25 | Pago MOTO |
| 28 | Pago JCB |
| 31 | Pago DINERS |
| 39 | JCB JSecure |
| 40 | Capacidad JSecure |
| 41 | Domiciliacion |
| 42 | Transferencia |
| 54 | PayPal |
| 57 | SafeKey |
| 58 | Capacidad SafeKey |
| 68 | Bizum |
| 70 | UPI ExpressPay |
| 71 | GooglePay |
| 72 | ApplePay |
| 73 | UPI SecurePlus |
| 74 | Capacidad Discover |
| 75 | Discover ProtectBuy |
| 76 | Discover |
| 77 | Amazon Pay |
| 78 | Challenge Visa |
| 79 | Challenge MasterCard |
| 80 | Frictionless Visa |
| 81 | Frictionless MasterCard |
| 82 | Attempt Visa |
| 83 | Attempt MasterCard |
| 85 | Challenge Amex |
| 86 | Challenge Discover |
| 87 | Frictionless Amex |
| 88 | Frictionless Discover |
| 89 | Attempt Amex |
| 90 | Attempt Discover |
| 92 | Pago DINERS ProtectBuy |
| 93 | Challenge Diners ProtectBuy |
| 94 | Frictionless Diners ProtectBuy |
| 95 | Pago Attempt Diners ProtectBuy |
| 96 | Challenge JCB |
| 97 | Frictionless JCB |
| 98 | Attempt JCB |
| 107 | Pago con cuenta |
| Moneda | |
|---|---|
| 840 | DOLAR U.S.A. USD |
| 826 | POUND STERLING GBP |
| 392 | YEN JPY |
| 32 | ARGENTINE AUSTRAL ARP |
| 36 | AUSTRALIAN DOLLAR AUD |
| 124 | CANADIAN DOLLAR CAD |
| 152 | CHILEAN PESO CLP |
| 170 | COLOMBIAN PESO COP |
| 188 | COSTA RICA COLON CRC |
| 356 | INDIAN RUPEE INR |
| 484 | MEXICAN PESO MXP |
| 604 | PERU INTI PEI |
| 756 | SWISS FRANC CHF |
| 858 | URUGUAYAN PESO UYP |
| 986 | BRAZILIAN REAL BRL |
| 949 | TURKISH LIRA TRY |
| 8 | LEK ALL |
| 12 | ALGERIAN DINAR DZD |
| 24 | ANGOLA KWANZA AOK |
| 30 | PROBANDO DESA MON |
| 31 | AZERBAIJANIAN MANAT AZM |
| 32 | ARGENTINE AUSTRAL ARP |
| 36 | AUSTRALIAN DOLLAR AUD |
| 44 | BAHAMIAN DOLLAR BSD |
| 48 | BAHRAINI DINAR BHD |
| 50 | TAKA BDT |
| 51 | ARMENIAN DRAM AMD |
| 52 | BARBADOS DOLLAR BBD |
| 60 | BERMUDAN DOLLAR BMD |
| 64 | NGULTRUM BTN |
| 68 | BOLIVIAN PESO BOP |
| 70 | DINAR BAD |
| 72 | PULA BWP |
| 76 | CRUZEIRO BRC |
| 84 | BELIZE DOLLAR 084 |
| 90 | SOLOMON ISLANDS DOLL SBD |
| 96 | BRUNEI DOLLAR BND |
| 100 | LEV BGL |
| 104 | KYAT BUK |
| 108 | BURUNDI FRANC BIF |
| 112 | BELARUSSIAN RUBLE BYB |
| 116 | RIEL KHR |
| 124 | CANADIAN DOLLAR CAD |
| 132 | CAPE VERDE ESCUDO CVE |
| 136 | CAYMAN ISLANDS DOLLA KYD |
| 144 | SRI LANKA RUPEE LKR |
| 152 | CHILEAN PESO CLP |
| 156 | YUAN RENMINBI CNY |
| 157 | CHINESE RENMIMBI CNH |
| 158 | CHINESE RENMINBI CNX |
| 170 | COLOMBIAN PESO COP |
| 174 | COMOROS FRANC KMF |
| 180 | ZAIRE ZRZ |
| 188 | COSTA RICA COLON CRC |
| 191 | CROATIAN KUNA HRK |
| 192 | CUBAN PESO CUP |
| 196 | CYPRUS POUND CYP |
| 200 | KORUNA CSK |
| 203 | CZECH KORUNA CZK |
| 208 | DANISH KRONE DKK |
| 214 | DOMINICAN PESO DOP |
| 218 | SUCRE ECS |
| 222 | EL SALVADOR COLON SVC |
| 226 | EKWELE GQE |
| 230 | ETHIOPIAN BIRR ETB |
| 232 | ERITREAN NAKTAN ERN |
| 233 | ESTONIAN KROON EEK |
| 238 | FALKLAND ISLANDS FKP |
| 242 | FIJI DOLLAR FJD |
| 262 | DJIBOUTI FRANC DJF |
| 268 | GEORGIAN LARI GEL |
| 270 | DALASI GMD |
| 278 | MARK DER DDR DDM |
| 288 | GHANA CEDI GHC |
| 292 | GIBRALTAR POUND GIP |
| 320 | QUETZAL GTQ |
| 324 | SYLI GNS |
| 328 | GUYANA DOLLAR GYD |
| 332 | GOURDE HTG |
| 340 | LEMPIRA HNL |
| 344 | HONG KONG DOLLAR HKD |
| 348 | FORINT HUF |
| 352 | ICELAND KRONA ISK |
| 356 | INDIAN RUPEE INR |
| 360 | RUPIAH IDR |
| 364 | IRANIAL RIAL IRR |
| 365 | IRANIAN AIRLINE RATE IRA |
| 368 | IRAQI DINAR IQD |
| 376 | ISRAEL SHEKEL ILS |
| 388 | JAMAICAN DOLLAR JMD |
| 392 | YEN JPY |
| 398 | TENGE KZT |
| 400 | JORDANIAN DINAR JOD |
| 404 | KENYAN SHILLING KES |
| 408 | NORTH KOREAN WON KPW |
| 410 | KOREAN WON KRW |
| 414 | KUWAITI DINAR KWD |
| 417 | KYRGYZSTAN SON KGS |
| 418 | KIP LAK |
| 422 | LEBANESE POUND LBP |
| 426 | LESOTHO LOTI LSM |
| 428 | LATVIAN LAT LVL |
| 430 | LIBERIAN DOLLAR LRD |
| 434 | LIBYAN DINAR LYD |
| 440 | LITHUANIAN LITAS LTL |
| 446 | PATACA MOP |
| 450 | MALAGASY FRANC MGF |
| 454 | MALAWI KWACHA MWK |
| 458 | MALASYAN RINGGIT MYR |
| 462 | MALDIVE RUPEE MVR |
| 466 | MALI MLF |
| 470 | MALTESE LIRA MTL |
| 478 | OUGUIYA MRO |
| 480 | MAURITIUS RUPEE MUR |
| 484 | MEXICAN PESO MXP |
| 496 | TUGRIK MNT |
| 498 | MOLDOVIAN LEU MDL |
| 504 | MORROCAN DIRHAM MAD |
| 508 | METICAL MZM |
| 512 | RIAL OMANI OMR |
| 516 | NAMIBIAN DOLLAR NAD |
| 524 | NEPALESE RUPEE NPR |
| 532 | NETHERLANDS ANTILLIA ANG |
| 533 | ARUBA AWG |
| 536 | YUGOSLAVIAN NEW DIAN NTZ |
| 548 | VANUATU VATU VUV |
| 554 | NEW ZEALAND DOLLAR NZD |
| 556 | NAIRA 566 |
| 558 | CORDOBA NIC |
| 566 | NAIRA NGN |
| 578 | NORWEGIAN KRONE NOK |
| 582 | PACIFIC ISLAND PCI |
| 586 | PAKISTAN RUPEE PKR |
| 590 | BALBOA PAB |
| 598 | KINA PGK |
| 600 | GUARANI PYG |
| 604 | PERU INTI PEI |
| 608 | PHILIPPINE PESO PHP |
| 616 | ZLOTY PLZ |
| 624 | GUINEA |
| 626 | TIMOR ESCUDO TPE |
| 634 | QATARI RIAL QAR |
| 642 | LEU ROL |
| 643 | RUSSIAN ROUBLE RUB |
| 646 | RWANDA FRANC RWF |
| 654 | ST.HELENA POUND SHP |
| 678 | DOBRA STD |
| 682 | SAUDI RIYAL SAR |
| 690 | SEYCHELLES RUPEE SCR |
| 694 | LEONE SLL |
| 702 | SINGAPORE DOLLAR SGD |
| 703 | SLOVAK KORUNA SKK |
| 704 | DONG VND |
| 705 | SLOVENIAN TOLAR SIT |
| 706 | SOMALI SHILLING SOS |
| 710 | RAND ZAR |
| 716 | ZIMBABWE DOLLAR ZWD |
| 720 | YEMENI DINAR YDD |
| 728 | SOUTH SUDANESE POUND SSP |
| 736 | SUDANESE POUND SDP |
| 737 | SUDAN AIRLINES SDA |
| 740 | SURINAM GUILDER SRG |
| 748 | LILANGENI SZL |
| 752 | SWEDISH KRONA SEK |
| 756 | SWISS FRANC CHF |
| 760 | SYRIAN POUND SYP |
| 762 | TAJIK RUBLE TJR |
| 764 | BAHT THB |
| 776 | PA'ANGA TOP |
| 780 | TRINIDAD Y TOBAGO DO TTD |
| 784 | UAE DIRHAM AED |
| 788 | TUNISIAN DINAR TND |
| 792 | TURKISH LIRA TRL |
| 793 | PSEUDO TURKISH LIRA PTL |
| 795 | MANAT TMM |
| 800 | UGANDA SHILLING UGS |
| 804 | KARBOVANET UAK |
| 807 | MACEDONIAN DENAR MKD |
| 810 | RUSSIAN ROUBLE RUR |
| 818 | EGYPTIAN POUND EGP |
| 826 | POUND STERLING GBP |
| 834 | TANZANIAN SHILLING TZS |
| 840 | DOLAR U.S.A. USD |
| 858 | URUGUAYAN PESO UYP |
| 860 | UZBEKISTAN SUM UZS |
| 862 | BOLIVAR VEB |
| 882 | TALA WST |
| 886 | YEMINI RIAL YER |
| 890 | NEW YUGOSLAVIAN DOLL YUD |
| 891 | NEW DINAR YUG |
| 894 | KWACHA ZMK |
| 901 | NEW TAIWAN DOLLAR TWD |
| 934 | NEW MANAT TMT |
| 936 | GHANA CEDI GHS |
| 941 | DINAR SERBIO RSD |
| 943 | MOZAMBIQUE METICAL MZN |
| 944 | AZERBAIJANIAN MANAT AZN |
| 946 | NEW LEU RON |
| 949 | TURKISH LIRA TRY |
| 950 | CFA FRANC BEAC XAF |
| 951 | EAST CARIBBEAN DOLLA XCD |
| 952 | CFA FRANC BCEAO XOF |
| 953 | CFP FRANC XPF |
| 954 | E.C.U. EUROPEAN CUR XEU |
| 967 | KWACHA ZMW |
| 968 | SURINAME DOLLAR SRD |
| 969 | ARIARY MGA |
| 971 | AFGHANISTAN AFGHANI AFN |
| 972 | TAJIKISTAN SOMONI TJS |
| 973 | KWANZA ANGOLA AOA |
| 974 | BELARUSSIAN RUBLE BYR |
| 975 | NEW LEV BGN |
| 976 | FRANCO DEL CONGO CDF |
| 977 | BOSNIAN MARKA BAM |
| 978 | EURO EUR |
| 980 | HRYVNIA UAH |
| 981 | GEORGIAN LARI GEL |
| 985 | NEW POLISH ZLOTY PLN |
| 986 | BRAZILIAN REAL BRL |
| 991 | RAND FINANCIER ZAL |
| Idioma | |
|---|---|
| 0 | Por defecto - Español |
| 1 | Español |
| 2 | English - Ingles |
| 3 | Català |
| 4 | Français - Frances |
| 5 | Deutsch - Aleman |
| 6 | Nederlands - Holandes |
| 7 | Italiano |
| 8 | Svenska - Sueco |
| 9 | Português |
| 10 | Valencià |
| 11 | Polski - Polaco |
| 12 | Galego |
| 13 | Euskara |
| 100 | български език - Bulgaro |
| 156 | Chino |
| 191 | Hrvatski - Croata |
| 203 | Čeština - Checo |
| 208 | Dansk - Danes |
| 233 | Eesti keel - Estonio |
| 246 | Suomi - Finlandes |
| 300 | ελληνικά - Griego |
| 348 | Magyar - Hungaro |
| 392 | Japonés |
| 428 | Latviešu valoda - Leton |
| 440 | Lietuvių kalba - Lituano |
| 470 | Malti - Maltés |
| 642 | Română - Rumano |
| 643 | ру́сский язы́к - Ruso |
| 703 | Slovenský jazyk - Eslovaco |
| 705 | Slovenski jezik - Esloveno |
| 792 | Türkçe - Turco |
| Significado | |
|---|---|
| 0000 a 0099 | Transacción autorizada para pagos y preautorizaciones |
| 900 | Transacción autorizada para devoluciones y confirmaciones |
| 400 | Transacción autorizada para anulaciones |
| 101 | Tarjeta caducada |
| 102 | Tarjeta en excepción transitoria o bajo sospecha de fraude |
| 106 | Intentos de PIN excedidos |
| 125 | Tarjeta no efectiva |
| 129 | Código de seguridad (CVV2/CVC2) incorrecto |
| 172 | Denegada, no repetir. |
| 173 | Denegada, no repetir sin actualizar datos de tarjeta. |
| 174 | Denegada, no repetir antes de 72 horas. |
| 180 | Tarjeta ajena al servicio |
| 184 | Error en la autenticación del titular |
| 190 | Denegación del emisor sin especificar motivo |
| 191 | Fecha de caducidad errónea |
| 202 | Tarjeta en excepción transitoria o bajo sospecha de fraude con retirada de tarjeta |
| 904 | Comercio no registrado en FUC |
| 909 | Error de sistema |
| 913 | Pedido repetido |
| 944 | Sesión Incorrecta |
| 950 | Operación de devolución no permitida |
| 9912/912 | Emisor no disponible |
| 9064 | Número de posiciones de la tarjeta incorrecto |
| 9078 | Tipo de operación no permitida para esa tarjeta |
| 9093 | Tarjeta no existente |
| 9094 | Rechazo servidores internacionales |
| 9104 | Comercio con "titular seguro" y titular sin clave de compra segura |
| 9218 | El comercio no permite op. seguras por entrada /operaciones |
| 9253 | Tarjeta no cumple el check-digit |
| 9256 | El comercio no puede realizar preautorizaciones |
| 9257 | Esta tarjeta no permite operativa de preautorizaciones |
| 9261 | Operación detenida por superar el control de restricciones en la entrada al SIS |
| 9915 | A petición del usuario se ha cancelado el pago |
| 9997 | Se está procesando otra transacción en SIS con la misma tarjeta |
| 9998 | Operación en proceso de solicitud de datos de tarjeta |
| 9999 | Operación que ha sido redirigida al emisor a autenticar |
| TIPO DE OPERACIÓN | DS_MERCHANT_TRANSACTIONSTYPE | ENTRADAS |
|---|---|---|
| Autorización | 0 |
|
| Preautorización | 1 |
|
| Preautorización de reemplazo | 11 |
|
| Confirmación | 2 |
|
| Devolución | 3 |
|
| Preautorización Separada | 7 |
|
| Confirmación Separada | 8 |
|
| Anulación | 9 |
|
| Paygold | 15 |
|
| Autenticación Puce | 17 |
|
| Devolución sin original | 34 |
|
| Premio de apuestas | 37 |
|
| Anulación de pago | 45 |
|
| Anulación de devolución | 46 |
|
| Anulación de confirmación separada | 47 |
|
| Confirmación parcial | 48 |
|
| Modificación de caducidad del enlace (Paygold) | 51 |
|
| DATO | Long. / Tipo | OPCION DEL PARÁMETRO |
COMENTARIOS | |
|---|---|---|---|---|
| Información adicional de la cuenta del cliene | acctID | Variable, máximo 64 / A-N | OPCIONAL | Información adicional sobre la cuenta |
| Información de la cuenta del titular | acctInfo | JSON Data Type Object | RECOMENDABLE | Información adicional de la cuenta de usuario en
el establecimiento.
***Se recomienda enviar este parámetro para mejorar la experiencia del usuario en el proceso de autenticación.. Ver tabla acctInfo |
| Indicador de coincidencia de dirección | addrMatch | 1/A-N | OPCIONAL | Indica si la dirección de envío es la misma que la
dirección de facturación
|
| Ciudad de la dirección de facturación | billAddrCity | Variable, máximo 50 / A-N | OPCIONAL | La ciudad de la dirección de facturación del titular de la tarjeta asociada a la compra |
| País de la dirección de facturación | billAddrCountry | 3 / N | CONDICIONAL | Corresponde al código numérico (ISO 3166-1) del país de la dirección de facturación del titular de la tarjeta asociada asociado a la compra |
| Dirección de facturación (línea 1) | billAddrLine1 | Variable, máximo 50 / A-N | OPCIONAL | Primera línea de la dirección de facturación del titular de la tarjeta asociada a la compra |
| Dirección de facturación (línea 2) | billAddrLine2 | Variable, máximo 50 / A-N | OPCIONAL | Segunda línea de la dirección de facturación del titular de la tarjeta asociada a la compra. |
| Dirección de facturación (línea 3) | billAddrLine3 | Longitud: Variable, máximo 50 / A-N | OPCIONAL | Tercera línea de la dirección de facturación del titular de la tarjeta asociada a la compra. |
| Código postal de la dirección de facturación | billAddrPostCode | Variable, máximo 16 / A-N | OPCIONAL | Código postal de la dirección de facturación del titular de la tarjeta asociada a la compra. |
| Estado o provincia de la dirección de facturación | billAddrState | Variable, máximo 3 / A-N | OPCIONAL | El estado o provincia de la dirección de facturación
del titular de la tarjeta asociada a esta compra. Corresponde al código de subdivisión ISO 3166-2 |
| Browser Accept Headers | browserAcceptHeader | Variable, máximo 2048 / A-N | OBLIGATORIO | HTTP accept headers enviado desde el navegador . |
| Browser Screen Color Depth | browserColorDepth | 1-2 /A-N | OBLIGATORIO | Valor que representa la profundidad de bits de la
paleta de colores para mostrar imágenes, en bits por píxel. Obtenido desde el navegador del titular de la tarjeta utilizando la propiedad screen.colorDepth. Valores aceptados: 1 = 1 bit 4 = 4 bits 8 = 8 bits 15 = 15 bits 16 = 16 bit 24 = 24 bits 32 = 32 bits 48 = 48 bits Enviar 1 en el caso que no tenga habilitado javascript (versión 3DS2.1.0) |
| Browser IP Address | browserIP | Variable, máximo 45 / A-N | OBLIGATORIO | IP del navegador. Value accepted: IPv4 address Ejemplo: 1.12.123.255 IPv6 address. Ejemplo:2011:0db8:85a3:0101:0101:8a2e:0370:7334 |
| Browser Java Enabled | browserJavaEnabled | Boolean | OBLIGATORIO | Indicador de capacidad del navegador de ejecutar Java
Valores aceptados:
|
| Browser JavaScript Enabled | browserJavascriptEnabled | Boolean | CONDICIONAL | Indicador de capacidad del navegador de ejecutar
Javascript Valores aceptados:
|
| Browser Language | browserLanguage | Variable, 1-8 / A-N | OBLIGATORIO | Idioma del navegador definido en IETF BCP47 . Es el valor retornado por la propiedad navigator.language |
| Browser Screen Height | browserScreenHeight | Variable, 1-6 / A-N | OBLIGATORIO | Altura total de la pantalla en píxeles El valor se devuelve de la propiedad screen.height Enviar 0 en el caso que no tenga habilitado javascript (versión 3Ds2.1.0) |
| Browser Screen Width | browserScreenWidth | Variable, 1-6 / A-N | OBLIGATORIO | Ancho total de la pantalla en píxeles. El valor se devuelve de la propiedad screen.width Enviar 0 en el caso que no tenga habilitado javascript (version 3DS2.1.0) |
| Browser Time Zone | browserTZ | 1-5 / A-N | OBLIGATORIO | Diferencia horaria entre la hora UTC y la hora local
del navegador, en minutos Value accepted: Value is returned from the getTimezoneOffset() method Enviar 0 en el caso que no tenga habilitado javascript (version 3DS2.1.0) |
| Browser User-Agent | browserUserAgent | Variable, máximo 2048 / A-N | OBLIGATORIO | Http user-agent header Si la longitud total del User-Agent enviado por el navegador supera los 2048 caracteres, el valor será truncado |
| Nombre del titular | cardholderName | Variable, 2-45 / A-N | OPCIONAL | Nombre del titular |
| Tamaño de ventana del challenge | challengeWindowSize | 2 / A-N | OPCIONAL | "Dimensión de ventana de challenge que el banco emisor
presentará al cliente para realizar la autenticación Valores posibles (tamaño en píxeles): 01 = 250 x 400 02 = 390 x 400 03 = 500 x 600 04 = 600 x 400 05 = Full screen (Valor por defecto El tamaño precondigurado es el ancho x alto en píxeles de la ventana del navegador |
| cres de respuesta del ACS al Challenge | cres | Variable length / JSON Data Type: String | OPCIONAL | cres de respuesta del ACS, se deberá enviar de
respuesta de la autenticación. cres codificado Base64url |
| Dirección de correo electrónico del titular | Variable, máximo 254 / A-N | RECOMENDABLE | La dirección de correo electrónico asociada con la
cuenta del titular de la tarjeta.
***Se recomienda enviar este parámetro para mejorar la experiencia del usuario en el proceso de autenticación. |
|
| Número de teléfono del domicilio | homePhone | JSON Data Type: Object | RECOMENDABLE | Número de teléfono del domicilio del titular.
***Se recomienda enviar este parámetro para mejorar la experiencia del usuario en el proceso de autenticación. Ver tabla Phone |
| Indicador de riesgo del comerciante | merchantRiskIndicator | JSON Data Type: Object | OPCIONAL | Altamente recomendable el envío de esta información. Información adicional del comercio que representa la evaluación del nivel de riesgo de fraude para la autenticación. Ver tabla merchantRiskIndicator |
| Número de móvil del titular | mobilePhone | JSON Data Type: Object | OPCIONAL | Número de teléfono móvil del titular. Ver tabla tabla Phone |
| URL de notificación de respuesta del challenge | notificationURL | Variable, máximo 256 / A-N | OBLIGATORIO | Url del comercio que recibirá la notificación con el mensaje cres al finaliza el challenge |
| Versión del protocolo 3DSecure | protocolVersion | Variable 5-8 / A-N | OBLIGATORIO | Versión de protocolo 3DSecure Valores posibles:
|
| Datos de pago aplazado | purchaseInstalData | Variable, máximo 3 / N | CONDICIONAL | Indica el número máximo de autorizaciones en pago aplazado Valores aceptados: El valor debe ser mayor que 1 |
| Finalización de pago recurrente | recurringExpiry | 8 / A-N | CONDICIONAL | La fecha a partir de la cual no se harán más autorizaciones Formato aceptado: YYYYMMDD |
| Frecuencia de pagos recurrentes | recurringFrequency | Variable, máximo 4 / A-N | CONDICIONAL | Indica el mínimo número de días entre autorizaciones |
| Ciudad de la dirección de envío | shipAddrCity | Variable, máximo 50 / A-N | OPCIONAL | Ciudad de la dirección de envío solicitada por el titular de la tarjeta |
| País de la dirección de envío | shipAddrCountry | 3 / N | CONDICIONAL | Corresponde al código numérico (ISO 3166-1) del país de la dirección de envío solicitada por el titular de la tarjeta |
| Dirección de envío (línea 1) | shipAddrLine1 | Variable, máximo 50 / A-N | RECOMENDABLE | Primera línea de la dirección de envío solicitada por
el titular de la tarjeta.
***Se recomienda enviar este parámetro para mejorar la experiencia del usuario en el proceso de autenticación. |
| Dirección de envío (línea 2) | shipAddrLine2 | Variable, máximo 50 / A-N | OPCIONAL | Segunda línea de la dirección de envío solicitada por el titular de la tarjeta. |
| Dirección de envío (línea 3) | shipAddrLine3 | Variable, máximo 50 / A-N | OPCIONAL | Tercera línea de la dirección de envío solicitada por el titular de la tarjeta |
| Código postal de la dirección de envío | shipAddrPostCode | Variable, máximo 16 / A-N | OPCIONAL | El código postal de la dirección de envío solicitada por el titular de la tarjeta. |
| Estado o provincia de la dirección de envío | shipAddrState | Variable, máximo 3 / A-N | OPCIONAL | El estado o provincia de la dirección de envío asociada con la tarjeta utilizada para esta compra. Corresponde al código de subdivisión ISO 3166-2 |
| Indicador del resultado del 3DSMethod | threeDSCompInd | 1 / Y,N,U | OBLIGATORIO | Indica si el 3DSMethod se ha ejecutado Values accepted:
|
| Tipo de información 3dSecure enviada | threeDSInfo | Variable, máximo 32/A-N | OBLIGATORIO | Tipo de solicitud. Valores posibles:
|
| Información de inicio de sesión en el establecimiento | threeDSRequestorAuthenticationInfo | JSON Data Type: Object | OPCIONAL | Información adicional sobre como el cliente se autenticó en el inicio de sesión en la cuenta del comercio. Ver tabla threeDSRequestorAuthenticationInfo |
| Identificador de transacción 3DSecure | threeDSServerTransID | 36 / A-N | OBLIGATORIO | El mismo valor devuelto en la consutla de tarjeta |
| Teléfono del trabajo | workPhone | JSON Data Type: Object | OPCIONAL | Número de teléfono del trabajo.Ver tabla tabla Phone |
| Información de la autenticación previa | threeDSRequestorPriorAuthenticationInfo | JSON Data Type: Object | OPCIONAL | Datos de la autenticación previa. Estos datos pueden ser requeridos en determinadas operativas. Por ejemplo, en recurrentes EMV 3DS subsiguientes deberá enviarse en este campo el json Object threeDSRequestorPriorAuthenticationInfo de la recurrente inicial, es decir, lo mismo que se devolvió en el threeDSRequestorPriorAuthenticationInfo (DS_EMV3DS) en la recurrente inicial. Para más información consultar el apartado Funcionalidades Avanzadas EMV3DS en las guías de integración |
| Preferencia del comercio para la autenticación | threeDSRequestorChallengeInd | 2/JSON Data Type: String | CONDICIONAL | Indica la preferencia del comercio para que se aplique autenticación
reforzada (SCA) a su cliente en esta operación. Valores posibles:
|
| NOTA:Los números de teléfono enviados en estos parámetros deben ir estructurados
indicando en campos independientes el prefijo del país (campo "cc") y el número de
teléfono del abonado (campo "subscriber") de forma obligatoria. Por ejemplo: "mobilePhone": {NOTA-1: En ningún caso se debe omitir alguno de los campos o enviarlo vacío. Los siguientes ejemplos serían incorrectos: "mobilePhone": { "mobilePhone": {"mobilePhone": {"699999999"} "mobilePhone": {""}NOTA-2: En el caso de no disponer de los datos completos deberá omitirse el parámero "mobilePhone" / "workPhone" / "homePhone". |
|||
| DATO | NOMBRE DEL DATO | Long./Tipo | COMENTARIOS |
|---|---|---|---|
| Prefijo | cc | 1 -3 / N | Indicativo del país correspondiente al número de teléfono. |
| Numeración | Subscriber | Máximo 15 / N | Numeración correspondiente al número de teléfono. |
| DATO | NOMBRE DEL DATO | long/Tipo | COMENTARIOS |
|---|---|---|---|
| Datos de inicio de sesión | threeDSReqAuthData | Máximo 2048 / A-N | Datos que documentan y soportan un proceso de autenticación especifico. No está especificado el contenido en la versión actual del protocolo |
| Método de autenticación en el inicio de sesión | threeDSReqAuthMethod | 2 / A-N | Mecanismo utilizado por el titular para autenticarse en
el comercio. Valores aceptados: 01 = No 3DS Requestor authentication occurred (i.e. cardholder “logged in” as guest) 02 = Login to the cardholder account at the 3DS Requestor system using 3DS Requestor’s own credentials 03 = Login to the cardholder account at the 3DS Requestor system using federated ID 04 = Login to the cardholder account at the 3DS Requestor system using issuer credentials 05 = Login to the cardholder account at the 3DS Requestor system using third-party authentication 06 = Login to the cardholder account at the 3DS Requestor system using FIDO Authenticator 07–79 = Reserved 80–99 = Reserved |
| Fecha Hora de autenticación (inicio de sesión) | threeDSReqAuth Timestamp | 12 / N | Fecha y hora UTC de la autenticación Date format = YYYYMMDDHHMM |
| DATO | long/Tipo | COMENTARIOS | |
|---|---|---|---|
| Dirección de entrega electrónica | deliveryEmailAddress | Máximo 254 / A-N | Para la entrega electrónica, la dirección de correo electrónico a la que se entregó la mercancía |
| Plazo de entrega | deliveryTimeframe | 2 / A-N | Indica el plazo de entrega de la mercancía. Valores
aceptados: 01 = Electronic Delivery 02 = Same day shipping 03 = Overmight shipping 04 = Two-day or more shipping |
| Importe en compras de tarjetas prepago / regalo | giftCardAmount | máximo 15 / A-N | Para compras de tarjetas prepago o tarjetas regalo, el importe total de la compra en unidades principales (por ejemplo, USD 123,.45 es 123) |
| Recuento de tarjetas preapago/regalo | giftCardCount | 2 / N | Para la compra de tarjeta prepago o tarjetas regalo, recuento toal de tarjetas prepago o tarjetas/códigosregalo comprados. |
| Código de moneda de tajeta prepago/regalo | giftCardCurr | 3 / N | Para la compra de tarjeta prepago / regalo, el código ISO-4217 de moneda de la tarjeta |
| Fecha prevista de compra preordenada | preOrderDate | 8 / N | Para una compra preordenada, la fecha prevista de disponibilidad de la mercancía. Date format = YYYYMMDD |
| Indicador de disponibilidad del pedido | preOrderPurchaseInd | 2 / A-N | "Indica si el titular de la tarjeta realiza un pedido
con disponibilidad o fecha de lanzamiento futuros. Valores
aceptados: 01 = Merchandise available 02 = Future availability |
| Indicador de recompra | reorderItemsInd | 2 / A-N | "Indica si el titular de la tarjeta está reordenando
mercancía comprada previamente. Valores aceptados: 01 = First time ordered 01 = Reordered |
| Método de envío | shipIndicator | 2 / A-N | "Indica el método de envío elegido para la transacción.
Los comercios deben elegir el código del indicador de envío que
describa con mayor precisión la transacción específica del
titular de la tarjeta, no su actividad comercial en general. Si se incluyen uno o más artículos en la venta, utilice el código del Indicador de envío para los bienes físicos, o si todos los productos son digitales, utilice el código del Indicador de envío que describe el artículo más caro. Valores aceptados: 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 services, electronic gift cards and redemption codes) 06 = Travel and Event tickets, not shipped 06 = Travel and Event tickets, not shipped 07 = Other (for example, Gaming, digital services not shipped, emedia subscriptions, etc.) |
| DATO | Long/Tipo | COMENTARIOS | |
|---|---|---|---|
| Indicador de permanencia de la cuenta | chAccAgeInd | 2 / A-N | "Periodo de tiempo que el titular de la tarjeta ha
tenido la cuenta en el comercio. Valores posibles: 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 |
| Fecha de modificación de la cuenta | chAccChange | 8 / N | Fecha en que se modificó por última vez la cuenta del
titular de la tarjeta en el comercio, incluida la dirección de
facturación o de envío, la nueva cuenta de pago o los nuevos
usuarios agregados. ***Se recomienda enviar este parámetro para mejorar la experiencia del usuario en el proceso de autenticación. Date format = YYYYMMDD |
| Indicador de modificación de la cuenta | chAccChangeInd | 2 / A-N | "Período de tiempo transcurrido desde que se modificó
por última vez la información de la cuenta del titular de la
tarjeta en el comercio, incluida la dirección de facturación o
de envío, la nueva cuenta de pago o los nuevos usuarios
agregados. Valores aceptados: 01 = Modificado en esta transacción 02 = Menos de 30 días 03 = 30-60 días 04 = Más de 60 días |
| Fecha de alta | chAccDate | 9 / N | Fecha en que el titular de la tarjeta abrió la cuenta
en el comercio.
***Se recomienda enviar este parámetro para mejorar la experiencia del usuario en el proceso de autenticación. Date format = YYYYMMDD |
| Fecha de cambio de contraseña | chAccPwChange | 8 / N | Fecha en que el titular tuvo un cambio de contraseña en la cuenta del comercio o un restablecimiento de la cuenta. Date format = YYYYMMDD |
| Indicador de cambio de contraseña | chAccPwChangeInd | 2 / A-N | "Indica el período de tiempo desde que la cuenta del
titular de la tarjeta en el comercio tuvo un cambio de
contraseña o restablecimiento de cuenta. Valores aceptados: 01 = No change 02 = Changed during this transaction 03 = Less than 30 days 04 = 30-60 days 05 = More than 60 days |
| Número de compras 6 meses | nbPurchaseAccount | máximo 4 / N | Númerco de compras con esta cuenta durante los últimos seis meses |
| Intentos de agregar tarjeta 24 h | provisionAttemptsDay | máximo 3 / N | Número de intentos de agregar tarjeta en las últimas 24 horas |
| Número de transacciones 24 h | txnActivityDay | máximo 3 / N | Número de transacciones (exitosas y abandonadas) para esta cuenta del titular de la tarjeta en el comercio en todas las cuentas de pago en las últimas 24 horas. |
| Número de transacciones año anterior | txnActivityYear | máximo 3 / N | Número de transacciones (exitosas y abandonadas) para
esta cuenta del titular de la tarjeta en el comercio en todas
las cuentas de pago del año anterior.
***Se recomienda enviar este parámetro para mejorar la experiencia del usuario en el proceso de autenticación. |
| Alta de cuenta de pago | paymentAccAge | 8 / N | Fecha en que la cuenta de pago se inscribió en la cuenta del titular de la tarjeta en el comercio. Date format = YYYYMMDD |
| Indicador de creación de cuenta de pago | paymentAccInd | 2 / A-N | "Indica el período de tiempo que la cuenta de pago se
inscribió en la cuenta del titular de la tarjeta en el
comercio. Valores aceptados: 01 = No account (guest check-out) 02 = During this transaction 03 = Less than 30 days 04 = 30-60 days 05 = More than 60 days |
| Fecha de primer uso de dirección de envío | shipAddressUsage | 8 / N | Fecha en que la dirección de envío utilizada para esta transacción se utilizó por primera vez con el comercio. Date format = YYYYMMDD |
| Indicador de primer uso de dirección de envío | shipAddressUsageInd | 2 / A-N | "Indica cuándo la dirección de envío utilizada para
esta transacción se utilizó por primera vez con el comercio.
Valores aceptados: 01 = This transaction 02 = Less than 30 days 03 = 30-60 days 04 = More than 60 days |
| Indicador de nombre de titular | shipNameIndicator | 2 / A-N | "Indica si el Nombre del titular de la tarjeta en la
cuenta es idéntico al Nombre de envío utilizado para esta
transacción. Valores aceptados: 01 = Account Name identical to shipping Name 02 = Account Name different than shipping Name |
| Indicador de actividad sospechosa | suspiciousAccActivity | 2 / A-N | "Indica si el comercio ha experimentado actividad
sospechosa (incluido fraude anterior) en la cuenta del titular
de la tarjeta. Valores aceptados: 01 = No suspicious activity has been observed 02 = Suspicious activity has been observed |
| DATO | NOMBRE DEL DATO | Long./Tipo | COMENTARIOS |
|---|---|---|---|
| Moneda DCC | MonedaDCC | 4 / Núm. | Se debe enviar el código numérico de la moneda según el ISO-4217, ver tabla Monedas. |
| Importe DCC | ImporteDCC | 12 / N | Las últimas posiciones hacen referencia a los decimales
de la moneda. Ejemplo: En el caso de EURO43,45 Euros habría que indicar 4345 |
| FORMA DE PAGO | DS_MERCHANT_PAYMETHODS | DS_MERCHANT_TRANSACTIONTYPE | COMENTARIOS |
|---|---|---|---|
| BIZUM | z | 0,7,8 | Se requiere activación por parte de la entidad. |
| PAYPAL | P | 0,1,15 | Se requiere activación por parte de la entidad. |
| Transferencia | R | 0,15, | Se requiere activación por parte de la entidad. |
| Con Tarjeta | C | TODAS | |
| GooglePay y ApplePay | xpay | 0,7, | Se requiere activación por parte de la entidad. |
| NOMBRE DEL DATO | Long. /Tipo | VERSIÓN | CONDICIÓN DEL PARÁMETRO | COMENTARIOS |
|---|---|---|---|---|
| threeDSServerTransID | 36 / A-N | 2.1.0, 2.2.0 | OBLIGATORIO | Identificador de la transacción |
| dsTransID | 36 / A-N | 2.1.0, 2.2.0 | OBLIGATORIO | Identificador del DS |
| authenticationValue | 28 / A-N | 2.1.0, 2.2.0 | OBLIGATORIO | Valor CAVV de campo autenticado. Valor en Base 64 |
| ProtocolVersion | Variable 5-8 / A-N | 2.1.0, 2.2.0 | OBLIGATORIO | Version de protocolo 3DSecure 2 con la que se ha
autenticado la operación. Valores permitidos: 2.1.0 |
| Eci | 2 / A-N | 2.1.0, 2.2.0 | OBLIGATORIO | Valores a determinar por las marcas. Valores posibles: 00, 01, 02, 04, 05, 06, o 07 |
| authenticationMethod | 2 / A-N | 2.1.0, 2.2.0 | OPCIONAL | Valores posibles 01 = Static Passcode 02 = SMS OTP 03 = Key fob or EMV card reader OTP 04 = App OTP 05 = OTP Other 06 = KBA 07 = OOB Biometrics 08 = OOB Login 09 = OOB Other 10 = Other |
| authentication Type | 2 / A-N | 2.1.0, 2.2.0 | OPCIONAL | |
| authentication Flow | 1 / A-N | 2.1.0, 2.2.0 | OPCIONAL | Valores posibles: F = Frictionless C = Challenge |
| DATO | NOMBRE DEL DATO | Long./Tipo | COMENTARIOS | PARÁMETROS DEL JSON |
|---|---|---|---|---|
| Información de la moneda de la tarjeta | InfoMoneda Tarjeta | JSON | Información adicional sobre la moneda de la tarjeta |
|
| Información de la moneda del titular | InfoMoneda Titular | JSON | Información adicional sobre la moneda del titular |
|
| DATO | Long. / Tipo | OPCION DEL PARÁMETRO |
COMENTARIOS | |
|---|---|---|---|---|
| Criptograma descifrado | cryptogram | Variable/ String | OBLIGATORIO | |
| Indicador de ECI | eciInd | 2 / String | OBLIGATORIO | |
| Fecha de caducidad | expirationDate | 4 / String | OBLIGATORIO | |
| Regerencia de la tarjeta | token | 19/ String | OBLIGATORIO | |
| Forma de Pago | paymentMethod | Variable / String | CONDICIONAL | Unicamente será necesario cuando el pago sea de Google Pay |
| DATO | Long. / Tipo | COMENTARIOS | |
|---|---|---|---|
| Versión del protocolo 3DSecure | protocolVersion | Variable 5-8 / JSON Data Type: String | Valores Posibles:
|
| Identificador de transacción 3DSecure | threeDSServerTransID | 36 / JSON Data Type: String | Identificación de la transaccion EMV3DS, se debe mandar el mismo en todo el flujo EMV3DS. |
| Tipo de información 3dSecure enviada | threeDSInfo | Variable, máximo 32/ JSON Data Type: String | Tipo de solicitud. Valores posibles:
|
| URL del ACS para ejecutar el 3DSMethod | threeDSMethodURL | Variable, máximo 256 / JSON Data Type: String | URL del ACS para ejecutar el 3DSMethod |
| URL del ACS para la ejecución del Challenge | acsURL | Variable, máximo 2048 / JSON Data Type: String | URL del ACS para la ejecución del Challenge |
| Creq que se deberá enviar al ACS para la ejecución del Challenge | CReq | Variable length / JSON Data Type: String | Creq codificado base64url que se deberá enviar al ACS para la ejecución del Challenge. *Este dato NO se debe de alterar. |
| Información adicional para el titular | cardholderInfo | Variable, máximo 128/JSON Data Type: String | Campo opcional que contiene información adicional para mostrar al titular después de solicitar la autenticación |
| Información de la autenticación | threeDSRequestorPriorAuthenticationInfo | JSON Data Type: Object | Contiene datos de la autenticación realizada. Estos datos pueden ser requeridos en operaciones posteriores que necesiten vincularse a ésta. Por ejemplo, el json Object threeDSRequestorPriorAuthenticationInfo devuelto en una recurrente EMV 3DS inicial será utilizado en las recurrentes subsiguientes |
| Información de la autenticación | AuthenticacionValue | 28 / JSON Data Type: String | CAVV. |
| Información de la autenticación | ECI | 2 / JSON Data Type: String | Indicador de comercio electrónico. |
| Información de la autenticación | TraceId | 16 / JSON Data Type: String | Identificador de la operación. |
| Estado del comercio en la lista de Beneficiarios de Confianza del cliente | whiteListStatus | 1 / JSON Data Type: String | TDato informativo. Opcional. Campo que devuelve el emisor que indica el estado del comercio en la lista de Beneficiarios de Confianza del cliente.
Por el momento solo es de carcater informativo, el comercio no tiene que hacer ninguna validación de este campo. El campo whiteListStatus podrá ser de ayuda en el futuro para aquellos comercios que quieran aplicar la exención de beneficiarios de confianza (listas blancas). Se publicará la información al respecto con los casos de uso.
Valores posibles:
|