PCI/Charge/CreatePayment
La operación Charge/CreatePayment es un servicio Web de la API REST. Le permite crear una nueva transacción a partir de un número de tarjeta.
En el modo PCI-DSS, puede ingresar la información de la tarjeta directamente en el servicio web.
Para un uso sin PCI con el formulario incrustado, vaya aquí: Charge/CreatePayment(non-PCI) .
Autenticación con nuestro servidor de autenticación
Este Servicio Web permite realizar una transacción 3DS. Por lo tanto, es necesario saber el funcionamiento de esta funcionalidad. Para ver cómo integrarlo, la documentación de referencia está presente aquí: Servicio web de creación de pago PCI .
Autentificación con otro servidor de autentificación
El servicio PCI/Charge/CreatePayment permite que los vendedores PCI-DSS que hayan efectuado la autentificación del titular a través de su propio servidor de autentificación, para realizar pagos transmitiendo la información de la tarjeta y los datos de autentificación del titular en su solicitud.
Consulte el capítulo guía de integración para obtener más información.
Parámetros de la solicitud
El servicio web PCI/Charge/CreatePayment admite los siguientes parámetros:
amount
Monto del pago en su unidad monetaria más pequeña (el centavo por el peso argentino).
Ejemplo: 30050 por 300.50 ARS.
Formato
currency
Moneda de pago. Código del alfabeto en mayúsculas según ISO 4217 alfa-3.
Ejemplo: "ARS" para el peso argentino.
Formato
Valores posibles
Los valores posibles son:
Moneda | CODIFICACIÓN ISO 4217 | Unidad fraccionaria |
---|---|---|
Peso argentino (032) | ARS | 2 |
Dólar estadounidense (840) | USD | 2 |
orderId
Referencia del pedido definida por el vendedor.No admite los caracteres UTF-8.
Formato
formAction
formAction le permite definir el tipo de comportamiento que desea al crear la transacción.
Formato
Valores posibles
Los valores posibles son:
Valor | DESCRIPCIÓN |
---|---|
PAYMENT | Creación de una transacción simple. Comportamiento predeterminado. |
REGISTER_PAY | Creación de un alias (token) del medio de pago al mismo tiempo que la transacción. No permite la creación de un alias asociado a un IBAN. |
null | Si el valor es nulo o no definido, se aplica PAYMENT. |
PAYMENT:
El servicio web devolverá un formToken .
Es el comportamiento predeterminado. La llamada a Charge/CreatePayment crea una transacción sin realizar ninguna operación adicional.
REGISTER_PAY:
El servicio web devolverá un formToken .
Un token (o alias) del medio de pago se crea al mismo tiempo que la transacción. Más adelante, este token le permitirá crear transacciones en un clic . El token recién creado se indicará en la propiedad paymentMethodToken . Para más información, consulte el artículo sobre Creación y uso de tokens .
paymentMethodType
Camino: paymentForms.paymentMethodType
Tipo de medio de pago.
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
CARD | Pago con tarjeta. |
SDD | Domiciliación SEPA |
Formato
paymentForms.pan
El PAN (Primary Account Number) es el número principal de la tarjeta, generalmente compuesto por 16 dígitos).
Formato
expiryMonth
Camino: paymentForms.expiryMonth
Mes de vencimiento.
Formato
expiryYear
Camino: paymentForms.expiryYear
Año de vencimiento.
Formato
securityCode
Camino: paymentForms.securityCode
Código de seguridad de la tarjeta.
Su longitud puede variar entre 3 o 4 dígitos dependiendo del tipo de tarjeta.
Formato
paymentForms.brand
Marca de la tarjeta.
Formato
cardHolderName
Camino: paymentForms.cardHolderName
Nombre completo del titular de la tarjeta.
Formato
firstInstallmentDelay
Camino: paymentForms.firstInstallmentDelay
Número de meses diferidos que se aplicarán a la primera cuota de un pago en varias cuotas. Campo específico a los adquirientes latinoamericanos.
Formato
identityDocumentNumber
Camino: paymentForms.identityDocumentNumber
Número del documento de identidad del comprador.
El formato depende del tipo de documento de identidad: entre 7 y 13 caracteres, números, letras y/o puntos.
En Latinoamérica, este parámetro puede ser obligatorio para algunos adquirientes.
Formato
identityDocumentType
Camino: paymentForms.identityDocumentType
Tipo de documento de identidad.
Valores posibles:
Tipo | DESCRIPCIÓN |
---|---|
DNI | Documento Nacional de Identidad |
CC | Cédula de ciudadania |
TI | Tarjeta de Identidad |
CE | Cédula de Extranjeria |
NI | Número de Identificación Tributaria |
PS | Pasaporte |
Formato
installmentNumber
Camino: paymentForms.installmentNumber
Número de cuotas.
Formato
paymentForms.mid
Número de contrato del vendedor. Si completa este campo, asegúrese de utilizar el contrato correcto según la red de la tarjeta.
Un contrato de VISANET no puede utilizarse para una transacción de MASTERCARD.
Formato
overridePaymentCinematic
Camino: paymentForms.overridePaymentCinematic
Permite cambiar el modo de captura. Específico para los compradores de América Latina. Esta función no está disponible en Colombia.
Valores posibles:
Valor | DESCRIPCIÓN |
---|---|
IMMEDIATE_CAPTURE | Secuencia de captura inmediata: el adquiriente inicia la captura el día del pago. |
DELAYED_CAPTURE | Secuencia de captura diferida: la captura es iniciada por la plataforma de pago, siempre antes de que expire la solicitud de autorización. |
Formato
paymentMethodToken
Camino: paymentForms.paymentMethodToken
Token (o alias) asociado a un medio de pago.
Solo se admiten los tokens asociados a una tarjeta bancaria.
Formato
taxAmount
Importe de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el peso argentino).
Ejemplo: 30050 por 300.50 ARS.
Formato
taxRate
Utilizado por algunos métodos de pago en América Latina. Le permite transmitir la tasa de impuestos aplicada a todo el pedido. El valor debe ser el porcentaje a aplicar (21 para 21%).
Formato
device.deviceType
Tipo de dispositivo en el que se realiza la autenticación.
Diversos métodos permiten identificar el tipo de equipo (tamaño de pantalla, user-agent, etc.).
Ejemplo de código javascript basado en el tamaño de la pantalla:
var isMobile = ""; var testMobile = window.matchMedia("only screen and (max-width: 760px)"); if (testMobile.matches){ isMobile="MOBILE"; } else{ isMobile="BROWSER" }
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
BROWSER | la autenticación se lleva a cabo en un navegador |
MOBILE | la autenticación se lleva a cabo en un teléfono |
Formato
device.acceptHeader
El contenido exacto del encabezado HTTP accept, tal como lo envió el navegador del cliente.
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
device.userAgent
Contenido exacto del encabezao HTTP user-agent. Debe truncarse si el valor supera los 2048 caracteres.
Obtenido del navegador del cliente a través de la propiedad “navigator.userAgent”.
Código Javascript que permite obtener el valor:
const language = navigator.userAgent;
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
device.ip
Dirección IP del navegador, tal como la devuelve el cliente en los encabezados HTTP. Formato IPV4 (ejemplo\: 1.12.123.255) o IPV6 (ejemplo\: 2011\:0db8\:85a3\:0101\:0101\:8a2e\:0370:7334). Largo variable con un máximo de 45 caracteres.
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
device.javaEnabled
Booleano que representa la capacidad del navegador para ejecutar Java.El valor es el que devuelve la función “navigator.javaEnabled()” y puede ser true o false.
Código Javascript que permite obtener el valor:
const javaEnabled = navigator.javaEnabled();
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
device.language
Obtenido del navegador del cliente a través de la propiedad “navigator.language”.
Ejemplos: “en”, “en-US”, “de”, “fr”, etc.
Código Javascript que permite obtener el valor:
const language = navigator.language;
Formato
device.colorDepth
Valor que representa la profundidad de la paleta de colores utilizada para mostrar las imágenes, en bits por píxel.
Obtenido del navegador del cliente a través de la propiedad “screen.colorDepth”.
Código Javascript que permite obtener el valor:
const colorDepth = screen.colorDepth;
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
device.screenHeight
La altura total de la pantalla del cliente en píxeles. Valor es devuelto por la propiedad screen.height. De 1 a 6 caracteres.
Código Javascript que permite obtener el valor:
const screenHeight = screen.height;
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
device.screenWidth
El ancho total de la pantalla del cliente en píxeles. El valor es el devuelto por la propiedad "screen.width". De 1 a 6 caracteres.
Código Javascript que permite obtener el valor:
const screenWidth = screen.width;
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
timeZoneOffset
Camino: device.timeZoneOffset
Diferencia horaria entre la hora UTC y la hora local del navegador del cliente, en minutos. Su valor es -120 para un usuario en la zona horaria UTC+2 y 570 para la zona horaria UTC-09:30.
Código Javascript que permite obtener el valor:
const timeZoneOffset = new Date().getTimezoneOffset();
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
customer.reference
Identificador del comprador en el sitio del vendedor.
Formato
customer.email
Dirección de correo electrónico del comprador.
Formato
customer.ipAddress
Dirección IP del comprador.
Formato
address
Camino: customer.billingDetails.address
Direccion de facturación.
Atención: Los caracteres ">" y "<" no están permitidos.
Formato
address2
Camino: customer.billingDetails.address2
Información adicional sobre la dirección de facturación.
Atención: Los caracteres ">" y "<" no están permitidos.
Formato
category
Camino: customer.billingDetails.category
Tipo de cliente.
Formato
Valores posibles
valores | DESCRIPCIÓN |
---|---|
PRIVATE | Cliente de tipo Particular |
COMPANY | Cliente de tipo Empresa |
cellPhoneNumber
Camino: customer.billingDetails.cellPhoneNumber
Teléfono móvil del comprador.
Acepta todos los formatos:
Ejemplos:
- 0623456789
- +33623456789
- 0033623456789
- (+34) 824 65 43 21
- 87 77 12 34
Formato
city
Camino: customer.billingDetails.city
Ciudad de facturación.
Formato
country
Camino: customer.billingDetails.country
País del comprador (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).
Formato
Valores posibles
Ejemplos de valores posibles:
País | Código |
---|---|
ARGENTINA | AR |
BRASIL | BR |
COLOMBIA | CO |
COSTA RICA | CR |
ECUADOR | EC |
GUATEMALA | GT |
MÉXICO | MX |
NICARAGUA | NI |
PERÚ | PE |
SALVADOR | SV |
ESTADOS UNIDOS DE AMÉRICA | US |
URUGUAY | UY |
district
Camino: customer.billingDetails.district
Barrio de la dirección de facturación.
Formato
firstName
Camino: customer.billingDetails.firstName
Nombre del comprador.
Formato
identityCode
Camino: customer.billingDetails.identityCode
Identificación nacional. Identifica de manera única a cada ciudadano en un país.
Formato
language
Camino: customer.billingDetails.language
Código del idioma del comprador según la norma ISO 639-1.
Permite especificar el idioma en el que se envían los e-mails de confirmación de pago.
El objeto device y sus atributos no son requeridos si el valor de paymentSource es MOTO .
Formato
Valores posibles
Ejemplos de valores posibles:
Idioma | Código |
---|---|
Alemán (Alemania) | DE |
Inglés (Reino Unido) | EN |
Inglés (Estados Unidos) | EN |
Chino (tradicional) | ZH |
Español (España) | ES |
Español (Chile) | ES |
Francés (Francia) | FR |
Italiano (Italia) | IT |
Japonés (Japón) | JP |
Holandés (Países Bajos) | NL |
Polaco (Polonia) | PL |
Portugués (Brasil) | PT |
Portugués (Portugal) | PT |
Ruso (Rusia) | RU |
lastName
Camino: customer.billingDetails.lastName
Apellido del comprador.
Formato
legalName
Camino: customer.billingDetails.legalName
Razón social.
Formato
phoneNumber
Camino: customer.billingDetails.phoneNumber
Número de teléfono del comprador.
Acepta todos los formatos:
Ejemplos:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Formato
state
Camino: customer.billingDetails.state
Región (estado) de la dirección de facturación. Es recomendable pero no obligatorio transmitir el valor en formato ISO-3166-2.
Formato
streetNumber
Camino: customer.billingDetails.streetNumber
Número de calle de la dirección de facturación.
Carácteres aceptados:
- Caracteres alfabéticos (de la "A" a la "Z" y desde la "a" hasta la "z")
- Espacio
Formato
title
Camino: customer.billingDetails.title
Tratamiento del comprador.
Ejemplos:
- Sr.
- Sr.
- Sra.
Formato
zipCode
Camino: customer.billingDetails.zipCode
Código postal de la dirección de facturación.
Formato
address
Camino: customer.shippingDetails.address
Dirección de entrega.
Atención: Los caracteres ">" y "<" no están permitidos.
Formato
address2
Camino: customer.shippingDetails.address2
Segunda línea de la dirección de facturación.
Atención: Los caracteres ">" y "<" no están permitidos.
Formato
category
Camino: customer.shippingDetails.category
Tipo de cliente.
Formato
Valores posibles
valores | DESCRIPCIÓN |
---|---|
PRIVATE | Cliente de tipo Particular |
COMPANY | Cliente de tipo Empresa |
city
Camino: customer.shippingDetails.city
Ciudad de entrega.
Formato
country
Camino: customer.shippingDetails.country
País de entrega (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).
Formato
Valores posibles
Ejemplos de valores posibles:
País | Código |
---|---|
AUSTRIA | AT |
BRASIL | BR |
CÓRCEGA | FR |
COSTA DE MARFIL | CI |
FRANCIA | FR |
GUADALUPE | GP |
INDIA | IN |
MARTINICA | MQ |
NUEVA CALEDONIA | NC |
SAN PEDRO Y MIQUELÓN | PM |
POLINESIA FRANCESA | PF |
deliveryCompanyName
Camino: customer.shippingDetails.deliveryCompanyName
Nombre de la empresa emisora del producto.
Formato
district
Camino: customer.shippingDetails.district
Barrio de la dirección de facturación.
Formato
firstName
Camino: customer.shippingDetails.firstName
Nombre del destinatario.
Formato
identityCode
Camino: customer.shippingDetails.identityCode
Identificación nacional. Identifica de manera única a cada ciudadano en un país.
Formato
lastName
Camino: customer.shippingDetails.lastName
Apellido del comprador.
Formato
legalName
Camino: customer.shippingDetails.legalName
Razón social en caso de entrega a una empresa.
Formato
phoneNumber
Camino: customer.shippingDetails.phoneNumber
Número de teléfono del comprador.
Acepta todos los formatos:
Ejemplos:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Formato
shippingMethod
Camino: customer.shippingDetails.shippingMethod
Modo de entrega.
Formato
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
RECLAIM_IN_SHOP | Retiro en tienda. |
RELAY_POINT | Uso de una red de puntos de retiro de terceros (Kiala, Alveol, etc.). |
RECLAIM_IN_STATION | Retiro en un aeropuerto, una estación o una agencia de viajes. |
PACKAGE_DELIVERY_COMPANY | Entrega por transportista (Colissimo, UPS, etc.). |
ETICKET | Emisión de un ticket electrónico, descarga de producto virtual. |
CARD_HOLDER_ADDRESS | Entrega al comprador. Reservado para uso futuro. |
VERIFIED_ADDRESS | Entrega a una dirección verificada.Reservado para su uso futuro. |
NOT_VERIFIED_ADDRESS | Entrega a una dirección no comprobada.Reservado para su uso futuro. |
SHIP_TO_STORE | Entrega en tienda.Reservado para su uso futuro. |
DIGITAL_GOOD | Entrega digital.Reservado para su uso futuro. |
ETRAVEL_OR_ETICKET | Boleto electronico.Reservado para su uso futuro. |
OTHER | Otro: Reservado para su uso futuro. |
PICKUP_POINT | Retiro en punto de retiro.Reservado para su uso futuro. |
AUTOMATED_PICKUP_POINT | Recoger en el punto de relevo automático.Reservado para su uso futuro. |
shippingSpeed
Camino: customer.shippingDetails.shippingSpeed
Plazo de entrega.
Formato
Valores posibles
Ejemplos de valores posibles:
Valor | DESCRIPCIÓN |
---|---|
STANDARD | Entrega estándar |
EXPRESS | Entrega en 24 horas |
PRIORITY | Entrega prioritaria (Click & Collect) |
state
Camino: customer.shippingDetails.state
Región de la dirección de facturación.
Formato
streetNumber
Camino: customer.shippingDetails.streetNumber
Número de calle de la dirección de facturación.
Carácteres aceptados:
- Caracteres alfabéticos (de la "A" a la "Z" y desde la "a" hasta la "z")
- Espacio
Formato
zipCode
Camino: customer.shippingDetails.zipCode
Código postal de la dirección de facturación.
Formato
insuranceAmount
Camino: customer.shoppingCart.insuranceAmount
Cantidad del seguro para todo el pedido expresada en su unidad monetaria más pequeña (el centavo para el peso argentino).
Ejemplo: 30050 por 300.50 ARS.
Formato
shippingAmount
Camino: customer.shoppingCart.shippingAmount
Importe de los gastos de envío de todo el pedido expresado en su unidad monetaria más pequeña (el céntimo de peso argentino).
Ejemplo: 30050 por 300.50 ARS.
Formato
taxAmount
Camino: customer.shoppingCart.taxAmount
Importe de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el peso argentino).
Ejemplo: 30050 por 300.50 ARS.
Formato
cartItemInfo
Camino: customer.shoppingCart.cartItemInfo
cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.
Para más información, consulte las propiedades de customer.shoppingCart.*.
Formato
productAmount
Camino: customer.shoppingCart.cartItemInfo.productAmount
Cantidad del producto expresada en su unidad monetaria más pequeña (el centavo para el peso argentino).
Ejemplo: 30050 por 300.50 ARS.
Formato
productLabel
Camino: customer.shoppingCart.cartItemInfo.productLabel
Nombre del producto.
Formato
productQty
Camino: customer.shoppingCart.cartItemInfo.productQty
Cantidad del producto.
Formato
productRef
Camino: customer.shoppingCart.cartItemInfo.productRef
Referencia del producto.
Formato
productType
Camino: customer.shoppingCart.cartItemInfo.productType
Tipo de producto.
Formato
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
FOOD_AND_GROCERY | Alimentos y productos comestibles |
AUTOMOTIVE | Automóviles / Motos |
ENTERTAINMENT | Entretenimiento / Cultura |
HOME_AND_GARDEN | Casa y jardín |
HOME_APPLIANCE | Equipamiento del hogar |
AUCTION_AND_GROUP_BUYING | Subastas y compras conjuntas |
FLOWERS_AND_GIFTS | Flores y regalos |
COMPUTER_AND_SOFTWARE | Computadores y software |
HEALTH_AND_BEAUTY | Salud y belleza |
SERVICE_FOR_INDIVIDUAL | Servicios a personas |
SERVICE_FOR_BUSINESS | Servicios a empresas |
SPORTS | Deportes |
CLOTHING_AND_ACCESSORIES | Ropa y accesorios |
TRAVEL | Viajes |
HOME_AUDIO_PHOTO_VIDEO | Sonido, imagen y video |
TELEPHONY | Telefonía |
productVat
Camino: customer.shoppingCart.cartItemInfo.productVat
Tipo de producto.
Monto del impuesto sobre el producto (en la unidad más pequeña de la moneda).
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
Un número entero | Monto de la transacción. Su valor debe ser un entero positivo (por ejemplo: 1234 para 12, 34 ARS). |
Un número decimal, inferior a 100 | Porcentaje aplicado al monto. Ejemplos: 20.0 o 19.6532 |
Para expresar un porcentaje aplicado al monto del producto en cuestión, el valor debe contener un máximo de 4 dígitos tras el punto decimal. El decimal es obligatorio para expresar un porcentaje. La posición decimal está marcada por el carácter ".".
acquirerTransientData
Permite la transmisión de información específica a determinados adquirentes/redes.
Formato
contrib
Nombre de la solución de comercio electrónico utilizada en el sitio web del vendedor y su número de versión.
Formato
ipnTargetUrl
Puede sobrescribir la URL de notificación instantánea (también llamada IPN) en el formulario si utiliza una única tienda para diferentes canales de venta, diferentes tipos de pago, diferentes idiomas, etc.
Formato
fingerPrintId
Este campo es utilizado por los comerciantes que implementan el analizador de riesgos en su página de pago. Permite transmitir el ID de sesión (o fingerPrint ID) a la plataforma de pago para finalizar el análisis de riesgo.
Los analizadores compatibles son:
- NOTO
- Cybersource
- MonitorPlus
- ClearSale
Puede contener mayúsculas, minúsculas, números o guiones ([AZ] [az], 0-9, _, -).
Formato
metadata
Valores personalizados vinculados a la transacción, en formato json.
Ejemplo de llamada
Por ejemplo, para transmitir un valor personalizado, como el color de ojos de su comprador, agregue a su solicitud:
{ "metadata": { "eyesColor": "blue" } }
Este valor se devolverá en el objeto de transacción recién creado.
También puede utilizar los metadatos " orderInfo ", " orderInfo2 " y " orderInfo3 " para transmitir la información adicional sobre el pedido.
Estos datos aparecerán en la pestaña Extra del detalle de la transacción desde su
Formato
merchantPostUrlRefused
Permite definir la URL a la que se redirigirá el navegador tras el fallo de la autenticación 3D Secure.
Formato
merchantPostUrlSuccess
Permite definir la URL a la que se redirigirá el navegador tras una autenticación 3D Secure exitosa.
Formato
strongAuthentication
strongAuthentication permite indicar la preferencia del vendedor respecto a la autenticación fuerte del comprador.
Con 3DS2, ya no es posible desactivar el 3DS. Sin embargo, el comerciante puede solicitar una exención en su solicitud de pago (lo que se denomina "merchant preference").
En ese caso, si la solicitud es aceptada por el emisor, el comprador no tendrá que autenticarse (sin challenge), pero el vendedor asumirá la responsabilidad en caso de impago (no hay transferencia de responsabilidad al emisor).
En todos los casos, es el banco emisor el que determina si es necesario interactuar con el comprador (challenge).
La autenticación fuerte es necesaria cuando se registra una tarjeta, independientemente de la preferencia del comerciante.
Valores posibles
Los valores posibles son:
Valor | Descripción 3DS1 | Descripción 3DS2 |
---|---|---|
ENABLED | Habilita (de ser posible) la autenticación fuerte. | En desuso.Este valor se interpretará como CHALLENGE_REQUESTED. |
DISABLED | Inhabilita (si es posible) la autenticación fuerte. Se requiere la opción "3DS1 Selective". . Utilizando este valor, usted se expone a rechazos "Soft decline". La desactivación no se tendrá en cuenta si el método de pago requiere una autenticación fuerte. Este es el caso de las tarjetas MAESTRO. | Permite solicitar una autenticación sin interacción (frictionless). Requiere la opción "Frictionless 3DS2". Si la tienda no cuenta con la opción “Frictionless 3DS2”, se ignora el valor transmitido por el vendedor y se delega la gestión de la autenticación del titular de la tarjeta a la plataforma. |
CHALLENGE_REQUESTED | Habilita (de ser posible) la autenticación fuerte. | Permite solicitar una autenticación fuerte para la transacción. |
CHALLENGE_MANDATE | Habilita (de ser posible) la autenticación fuerte. | Permite indicar que, por razones reglamentarias, se requiere una autenticación fuerte para la transacción. |
NO_PREFERENCE | Habilita (de ser posible) la autenticación fuerte. | Indica al DS que el comerciante no tiene ninguna preferencia. Si el emisor decide realizar la autenticación sin fricción, el pago estará garantizado. |
AUTO | Habilita (de ser posible) la autenticación fuerte. | Se delega la elección de la preferencia al emisor de la tarjeta (No Preference). |
Formato
paymentSource
Camino: transactionOptions.cardOptions.paymentSource
Origen del pago.
Formato
Valores posibles
Los valores posibles son:
Valor | DESCRIPCIÓN |
---|---|
EC | Comercio Electrónico: los datos del medio de pago son ingresados por el comprador. Este valor permite una autenticación fuerte durante el pago. |
MOTO | Ingreso realizado por un operador.La información sobre el pago se envía por correo o correo electrónico. Requiere un contrato VAD. |
CC | Call Center: pago efectuado a través de un centro de atención telefónico. Requiere un contract VAD. |
OTHER | Otro canal de venta.Valor de salida devuelto para los pagos realizados desde el Back Office, los pagos por archivo, los pagos recurrentes, los pagos de proximidad y los reembolsos desde el CMS de Shopify. |
Absent ou null | El valor predeterminado es “EC”. |
mid
Camino: transactionOptions.cardOptions.mid
Número de contrato del vendedor. Si completa este campo, asegúrese de utilizar el contrato correcto según la red de la tarjeta.
Un contrato de VISANET no puede utilizarse para una transacción de MASTERCARD.
Formato
manualValidation
Camino: transactionOptions.cardOptions.manualValidation
Modo de validación de la transacción.
Formato
Valores posibles
Los valores posibles son:
Valor | DESCRIPCIÓN |
---|---|
NO | Validación automática por la plataforma de pago. |
YES | Validación manual por el vendedor. |
null | Configuración predeterminada de la tienda (definida en el |
captureDelay
Camino: transactionOptions.cardOptions.captureDelay
Fecha límite para la fecha de captura.
DESCRIPCIÓN
Indica el número de días antes de la captura.
Si no se envía este parámetro, se utilizará el valor predeterminado definido en
Todas las personas autorizadas pueden definir este valor en el
Si el tiempo de entrega es superior a 365 días en la solicitud de pago, se reposicionará automáticamente en 365 días.
Formato
firstInstallmentDelay
Camino: transactionOptions.cardOptions.firstInstallmentDelay
Número de meses diferidos que se aplicarán a la primera cuota de un pago en varias cuotas. Campo específico a los adquirientes latinoamericanos.
Formato
installmentNumber
Camino: transactionOptions.cardOptions.installmentNumber
Número de cuotas.
Formato
retry
Camino: transactionOptions.cardOptions.retry
Número de nuevos intentos disponibles en caso de rechazo del pago (de forma predeterminada, 3).
Formato
debitCreditSelector
Camino: transactionOptions.cardOptions.debitCreditSelector
Este campo es exclusivo para Brasil para la gestión de las tarjetas multiplo .
Las tarjetas “Multiplo” son tarjetas de pago (Elo, Visa o Mastercard) que permiten pagar:
- ya sea en débito inmediato: el monto se debita inmediatamente y se acredita al vendedor al día siguiente.
- o a crédito: el débito se aplaza y el importe puede cargarse en uno o varios plazos. Al comerciante se le abona posteriormente la totalidad o sólo una parte del importe total.
Este campo permite forzar el uso de la tarjeta como tarjeta de débito o de crédito.
Valores posibles
valores | DESCRIPCIÓN |
---|---|
DEBIT | Uso de la función “débito” de la tarjeta |
CREDIT | Uso de la función “crédito” de la tarjeta |
Formato
name
Camino: authenticationDetails.protocol.name
Nombre del protocolo de autenticación del titular de la tarjeta.
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
THREEDS | Protocolo 3D Secure |
PROCESOS_DINERS | Protocolo Procesos Diners OTP |
OSB | Protocolo OTP OSB |
Formato
version
Camino: authenticationDetails.protocol.version
Versión del protocolo de autenticación del titular de la tarjeta.
Valores posibles
Valor | DESCRIPCIÓN | Protocolo compatible |
---|---|---|
1 | Para completar si no se conoce la versión exacta. En este caso, se considerará la última versión soportada en 3D Secure 1 por la plataforma de pago | all |
2 | debe rellenarse si no se conoce la versión exacta. En este caso, se considerará la última versión soportada en 3D Secure 2 por la plataforma de pago | all |
1.0 | Versión 1.0 | PROCESOS_DINERS o OSB |
1.0.2 | Versión 1.0.2 | THREEDS |
2.1.0 | Versión 2.1.0 | THREEDS |
2.2.0 | Versión 2.2.0 | THREEDS |
Formato
directoryServer
Camino: authenticationDetails.protocol.directoryServer
Nombre de la red DS en la que se realizó la autenticación.
Valores posibles
Si se elige el protocolo THREEDS
Valor | DESCRIPCIÓN |
---|---|
AMEX | Red American Express (Safekey) |
CB | Red Carte Bancaire |
MASTERCARD | Red Mastercard |
VISA | Red Visa |
ELO | Red Elo (Brasil) |
DINERS | Red Diners |
DISCOVER | Red Discover |
ELO | Red ELO |
Si el protocolo elegido es PROCESOS_DINERS
Valor | DESCRIPCIÓN |
---|---|
PROCESOS_DINERS | Red PROCESOS_DINERS |
Si se elige el protocolo OSB
Valor | DESCRIPCIÓN |
---|---|
OSB | Red OSB |
Formato
challengePreference
Camino: authenticationDetails.protocol.challengePreference
Indica si el vendedor ha solicitado un challenge o no.
Valores posibles
Valor | Tarjeta 3DS1 | Tarjeta 3DS2 | |
---|---|---|---|
NO_PREFERENCE | Autenticación 3DS1 forzada. | Se delega la elección de la preferencia al emisor de la tarjeta. | |
NO_CHALLENGE_REQUESTED | Autenticación 3DS1 desconectada. | Permite solicitar una autenticación sin interacción (frictionless) | |
CHALLENGE_REQUESTED | Autenticación 3DS1 forzada. | Permite solicitar una autenticación fuerte para la transacción. | |
CHALLENGE_MANDATED | Autenticación 3DS1 forzada. | Permite indicar que, por razones reglamentarias, se requiere una autenticación fuerte para la transacción. | |
DATA_ONLY | Autenticación 3DS1 desconectada. | Permite solicitar una autentificación sin interacción, tratada por el DS y no por el ACS del banco emisor. La transacción no cuenta con transferencia de responsabilidad . La autentificación será desactivada si la red no es compatible con esta funcionalidad. El servicio PCI/Charge/Authenticate envía un código de error INT_808 si el campo transactionCategory no tiene el valor PAYMENT . |
Formato
authenticationType
Camino: authenticationDetails.authenticationType
El tipo de autenticación que tuvo lugar.
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
FRICTIONLESS | Autenticación en modo Frictionless, es decir, de forma transparente para el cliente |
CHALLENGE | Autenticación con Challenge, el cliente tuvo que autenticarse explícitamente con el ACS |
DATA_ONLY | Autentificación tratada por el DS sin interacción del cliente |
Formato
status
Camino: authenticationDetails.status
El estado de autenticación, es decir, el resultado positivo/negativo de la autenticación.
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
ATTEMPT | Prueba de intento de autenticación cuando la autenticación no está disponible |
ENROLLED_UNAVAILABLE | No se puede obtener el estado de inscripción |
FAILED | Autenticación fallida |
NOT_ENROLLED | Tarjeta no inscrita |
SUCCESS | Autenticación exitosa |
UNAVAILABLE | No se pudo completar la autenticación (error técnico, etc.) |
DISABLED | Autenticación desactivada. El campo exemption se vuelve obligatorio . |
Formato
commerceIndicator
Camino: authenticationDetails.commerceIndicator
Indicador del comercio, llamado ECI (Electronic Commerce Indicator) para el protocolo 3DS. Indicador devuelto por el ACS para informar los resultados del intento de autenticación del titular de la tarjeta.
En caso de autentificación sin pago (registro de una tarjeta) Mastercard puede devolver estos 2 valores:
VALOR | DESCRIPCIÓN |
---|---|
N0 | Not authenticated |
N2 | Authenticated |
Formato
authenticationValue
Camino: authenticationDetails.authenticationValue
Valor de autenticación final (dependiendo del DS este valor puede llamarse CAVV, AEVV o AAV). Cadena de caracteres codificada en base64 con un tamaño de 28 caracteres.
Formato
dsScore
Camino: authenticationDetails.dsScore
Resultado de la autentificación especificado por el DS.
Formato
authValueAlgorithm
Camino: authenticationDetails.authValueAlgorithm
Algoritmo utilizado para calcular el campo authenticationValue . Este campo es obligatorio en 3D Secure V2 CB, así como en 3D Secure V1 con un valor de autenticación (CAVV distinto de cero).
Formato
requestorName
Camino: authenticationDetails.requestorName
RequestorName utilizado durante la autenticación inicial. Normalmente este campo es el nombre del comerciante.
Formato
dsTransID
Camino: authenticationDetails.dsTransID
Identificación de la transacción de la DS.(Obligatorio en 3D Secure V2).
Formato
acsTransID
Camino: authenticationDetails.acsTransID
Identificación de la transacción ACS.(Obligatorio en 3D Secure V2).
Formato
xid
Camino: authenticationDetails.xid
Identificador único de la transacción.(Obligatorio en 3D Secure V1).
Formato
exemption
Camino: authenticationDetails.exemption
Indica el motivo de la falta de autenticación fuerte (Obligatorio en caso de estado DISABLED, o en caso de autenticación FRICTIONLESS).
Valores posibles
valores | DESCRIPCIÓN |
---|---|
LOW_VALUE | Transacción de monto bajo (ej. monto inferior a 30€ en Europa) |
ACQUIRER_TRA | Análisis de riesgo realizado previamente por el comprador |
ISSUER_TRA | Análisis de riesgo realizado previamente por el emisor |
LOW_RISK_MERCHANT | Comerciante inscrito en el programa LOW RISK MERCHANT CB |
OUT_OF_SCOPE | Autentificación no requerida, ya que está fuera del scope RTS SCA |
DELEGATED_SCA | Autenticación fuerte delegada a un tercero. |
FIXED_RECURRING_PAYMENT | Pago recurrente de monto fijo y duración definida |
TRUSTED_BENEFICIARY | Beneficiario de confianza |
AUTOMATIC_PAYMENT_MACHINES | Autómata de pago |
CORPORATE | Procedimiento de pago seguro para empresas |
OTHER_EXEMPTION | Otros usos exentos de autentificación |
TECHNICAL_ERROR | Problema técnico que imposibilita la autentificación |
Formato
cancellationIndicator
Camino: authenticationDetails.cancellationIndicator
Indicador de anulación del reto recibido en la RReq. (Valor devuelto por el DS en caso de anulación de la autenticación).
Formato
transactionStatusReason
Camino: authenticationDetails.transactionStatusReason
Indica el motivo del fallo de autenticación. (Valor devuelto por el DS en caso de fallo de autenticación).
Formato
name
Camino: instructionResult.name
Nombre de la instrucción.
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
CHALLENGE | Instrucción Challenge, que permite la autenticación interactiva del usuario con el ACS. |
FINGERPRINT | Instrucción Fingerprint, que permite la autenticación interactiva del usuario con el ACS. |
Formato
value
Camino: instructionResult.value
Resultado como una cadena JWT, o un código de error en texto plano en caso de error (
Formato
challengePreference
Camino: instructionResult.protocol.challengePreference
Indica si el vendedor ha solicitado un challenge o no.
Valores posibles
Valor | Tarjeta 3DS1 | Tarjeta 3DS2 | |
---|---|---|---|
NO_PREFERENCE | Autenticación 3DS1 forzada. | Se delega la elección de la preferencia al emisor de la tarjeta. | |
NO_CHALLENGE_REQUESTED | Autenticación 3DS1 desconectada. | Permite solicitar una autenticación sin interacción (frictionless) | |
CHALLENGE_REQUESTED | Autenticación 3DS1 forzada. | Permite solicitar una autenticación fuerte para la transacción. | |
CHALLENGE_MANDATED | Autenticación 3DS1 forzada. | Permite indicar que, por razones reglamentarias, se requiere una autenticación fuerte para la transacción. | |
DATA_ONLY | Autenticación 3DS1 desconectada. | Permite solicitar una autentificación sin interacción, tratada por el DS y no por el ACS del banco emisor. La transacción no cuenta con transferencia de responsabilidad . La autentificación será desactivada si la red no es compatible con esta funcionalidad. El servicio PCI/Charge/Authenticate envía un código de error INT_808 si el campo transactionCategory no tiene el valor PAYMENT . |
Formato
name
Camino: instructionResult.protocol.name
Nombre del protocolo de autenticación del titular de la tarjeta.
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
THREEDS | Protocolo 3D Secure |
PROCESOS_DINERS | Protocolo Procesos Diners OTP |
OSB | Protocolo OTP OSB |
Formato
network
Camino: instructionResult.protocol.network
Nombre de la red preferencial recomendada por el vendedor en el caso de tarjetas multimarca (por ejemplo: CB y VISA en la misma tarjeta).
Valores posibles
Valor | DESCRIPCIÓN |
---|---|
AMEX | Red American Express (Safekey) |
CB | Red Carte Bancaire |
MASTERCARD | Red Mastercard |
VISA | Red Visa |
ELO | Red Elo (Brasil) |
DINERS | Red Diners |
DISCOVER | Red Discover |
OSB | Red OSB |
Formato
simulation
Camino: instructionResult.protocol.simulation
Booleano que indica si la autenticación debe realizarse en modo de simulación. El modo de simulación permite una integración comercial sin estar en modo de producción ni utilizar tarjetas reales.
Formato
version
Camino: instructionResult.protocol.version
Versión del protocolo de autenticación del titular de la tarjeta.
Versiones actualmente compatibles
Valor | DESCRIPCIÓN |
---|---|
1.0.2 | Versión 1.0.2 |
2.1.0 | Versión 2.1.0 |
Formato
operationSessionId
Identificador único de autenticación, en formato UUID.
No se define durante la primera llamada.
El operationSessionId se devuelve como resultado de una solicitud de pago que requiere autenticación del portador. Debe trasladarse a llamadas posteriores.
Formato
companyType
Camino: subMerchantDetails.companyType
Tipo de empresa del subvendedor.Transmitido por el facilitador de pago.
Formato
legalNumber
Camino: subMerchantDetails.legalNumber
Número legal del subvendedor.Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente de Prisma.
Formato
name
Camino: subMerchantDetails.name
Razón social del subvendedor.Transmitido por el facilitador de pago.
Formato
url
Camino: subMerchantDetails.url
URL del subvendedor.Transmitido por el facilitador de pago.
Formato
phoneNumber
Camino: subMerchantDetails.phoneNumber
Número de teléfono del subvendedor.Transmitido por el facilitador de pago.
Formato
address1
Camino: subMerchantDetails.address1
Dirección del subvendedor.Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente de Prisma.
Formato
address2
Camino: subMerchantDetails.address2
Adición de la dirección del subcomerciante. Transmitido por el facilitador de pagos.
Formato
zip
Camino: subMerchantDetails.zip
Código postal del subvendedor.Transmitido por el facilitador de pago.
Formato
city
Camino: subMerchantDetails.city
Ciudad del subvendedor.Transmitido por el facilitador de pago.
Formato
country
Camino: subMerchantDetails.country
Código de país de la dirección del subcomerciante (estándar ISO 3166 alfa-2). Transmitido por el facilitador de pago.
Formato
mcc
Camino: subMerchantDetails.mcc
Código MCC del subvendedor.Transmitido por el facilitador de pago.
Este campo es obligatorio para el adquirente de Prisma.
Formato
mid
Camino: subMerchantDetails.mid
Número de afiliación (MID) del subvendedor.Transmitido por el facilitador de pago.
Campo obligatorio para los compradores Fiserv y Procesos.
Formato
softDescriptor
Camino: subMerchantDetails.softDescriptor
Etiqueta (Soft-descriptor) del subcomerciante que aparece en el extracto bancario del comprador. Transmitida por el facilitador de pagos.
Campo obligatorio para los compradores Prisma. Debe respetar el formato:
CÓD.AGRUPADOR ASIGNADO POR PRISMA + "*" + NOMBRE FANTASÍA VENDEDOR
El campo es de texto libre aunque debe contruirse bajo el siguiente criterio:
Long. total: 25 caracteres incluyendo el cód. de agrupador.
Caracteres aceptados: [A-Z];[0-9];[*].
Ejemplos:
- "TP*ELECTONICA TUCUMAN"
- "MP*MARTIN GONZALEZ"
Formato
Referencia de la respuesta
Existen varias respuestas posibles dependiendo del contexto:
Respuesta | Contexto |
---|---|
Payment | Objeto que contiene la transacción generada. Este objeto se devuelve directamente cuando se paga con un simple alias. |
AuthenticationResponseData | Objeto devuelto si se requiere una autenticación 3DS |
Consultar la referencia de las respuestas para más detalles.