PCI/Charge/CreatePayment

POSThttps://api.cobroinmediato.tech/api-payment/V4/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

Cadena de caracteres que indica el idioma del navegador.

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

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

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 Back Office Vendedor.

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 Back Office Vendedor).

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 Back Office Vendedor.

Todas las personas autorizadas pueden definir este valor en el Back Office Vendedor.

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 ( timeout por ejemplo).

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.

Categoria

Tags

Token de formulario no definido

PCI/Charge/CreatePayment

Autenticación con nuestro servidor de autenticación

Autentificación con otro servidor de autentificación

Parámetros de la solicitud

amount

Formato

currency

Formato

Valores posibles

orderId

Formato

formAction

Formato

Valores posibles

paymentMethodType

Camino: paymentForms.paymentMethodType

Valores posibles

Formato

paymentForms.pan

Formato

expiryMonth

Camino: paymentForms.expiryMonth

Formato

expiryYear

Camino: paymentForms.expiryYear

Formato

securityCode

Camino: paymentForms.securityCode

Formato

paymentForms.brand

Formato

cardHolderName

Camino: paymentForms.cardHolderName

Formato

firstInstallmentDelay

Camino: paymentForms.firstInstallmentDelay

Formato

identityDocumentNumber

Camino: paymentForms.identityDocumentNumber

Formato

identityDocumentType

Camino: paymentForms.identityDocumentType

Formato

installmentNumber

Camino: paymentForms.installmentNumber

Formato

paymentForms.mid

Formato

overridePaymentCinematic

Camino: paymentForms.overridePaymentCinematic

Formato

paymentMethodToken

Camino: paymentForms.paymentMethodToken

Formato

taxAmount

Formato

taxRate

Formato

device.deviceType

Valores posibles

Formato

device.acceptHeader

Formato

device.userAgent

Formato

device.ip

Formato

device.javaEnabled

Formato

device.language

Formato

device.colorDepth

Formato

device.screenHeight

Formato

device.screenWidth

Formato