PCI/Charge/CreatePayment (PCI)

POSThttps://api.cobroinmediato.tech/api-payment/V4.1/PCI/Charge/CreatePayment

La operación PCI/Cargo/CrearPago es un servicio web API REST. Permite crear una nueva transacción autenticada a partir de un número de tarjeta.

En el modo PCI DSS, puede ingresar la información de la tarjeta directamente en el Web Service.

Para el uso no PCI con el formulario incrustado, consulte: Charge/CreatePayment(non-PCI).

Tenga en cuenta que la versión anterior obsoleta de este servicio web se puede encontrar aquí: PCI/Charge/CreatePayment (obsoleta)

autentificación con nuestro servidor de autentificación

Este Web Service permite realizar una transacción 3DS. Por lo tanto, es necesario saber cómo funciona esta funcionalidad Para saber cómo integrarlo, consulte la siguiente documentación: Web Services PCI de pago.

Autentificación con otro servidor de autentificación

El servicio PCI/Charge/CreatePayment permite que los vendedores PCI DSS que han realizado la autentificación del titular de la tarjeta en su propio servidor de autentificación realicen pagos transmitiendo la información de la tarjeta y los datos de autentificación del titular en su solicitud.

Consulte el capítulo la guía de integración para obtener más información.

Parámetros de entrada

El Web Service REST PCI/Charge/CreatePayment admite los siguientes parámetros:

amount

Monto del pago en su fracción monetaria más pequeña (el centavo para el peso argentino).

Ejemplo: 30050 para 300,50 ARS.

Formato

currency

Moneda del pago. Código alfabético un mayúsculas según ISO 4217 alpha-3.

Ejemplo: "ARS" por 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 de 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 token de los medios de pago al mismo tiempo que la transacción. No permite crear un token asociado a un IBAN.
null	Si el valor es nulo o no definido, se aplica PAYMENT.

PAYMENT:

El Web Service 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 Web Service devolverá un formToken.

Se crea un token del medio de pago al mismo tiempo que la transacción. Este token le permite crear transacciones en un solo clic. El token recién creado se indica en la propiedad paymentMethodToken. Para más información, consulte el artículo sobre Creación y uso de token.

paymentMethodType

Camino: paymentForms.paymentMethodType

Tipo de medio de pago. Ejemplo: PAYCONIQ

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 expiración en 2 dígitos. Ejemplo: "09" por septiembre.

Formato

expiryYear

Camino: paymentForms.expiryYear

Año de expiración en 2 dígitos. Ejemplo: "25" por 2025.

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

Cantidad de meses en los que se aplaza el primer pago de un pago a plazos. Campo específico a los adquirentes en Latino américa.

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 América Latina, este parámetro puede ser obligatorio para algunos adquirentes.

Formato

identityDocumentType

Camino: paymentForms.identityDocumentType

Tipo del documento de identidad.

Valores posibles:

País	TIPO	DESCRIPCIÓN
ARGENTINA	DNI	Documento Nacional de Identidad
BRASIL	CNPJ	Cadastro Nacional da Pessoa Jurídica
BRASIL	CPF	Cadastro de Pessoas Físicas
COLOMBIA	CC	Cédula de ciudadania
	TI	Tarjeta de Identidad
	CE	Cédula de Extranjeria
	NI	Número de Identificación Tributaria
	PS	Pasaporte
	TE	Tarjeta De Extranjería
	DE	Documento De Identificación Extranjero
	RN	Registro Civil De Nacimiento
Peru	DNI_PER	Documento National de Identidad
	PAR	Partida de Nacimiento
	PAS	Pasaporte
	LMI	Libreta Militar
	NAN	Otro

Formato

installmentNumber

Camino: paymentForms.installmentNumber

Cantidad de cuotas.

Formato

overridePaymentCinematic

Camino: paymentForms.overridePaymentCinematic

Le permite cambiar el modo de captura. Específico de los adquirientes de América Latina. Esta característica no se puede usar 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 asociado a un medio de pago.

Formato

taxAmount

Monto 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 para 300,50 ARS.

Formato

taxRate

Usado por ciertos medios de pago en América Latina. permite transmitir el tipo de impuesto aplicado a todo el pedido. El valor debe ser el porcentaje a aplicar (21 para 21 %).

Formato

customer.reference

Identificador del comprador en el sitio web comercial.

Formato

customer.email

E-mail del comprador.

Especificaciones de la estructura del correo electrónico: RFC-2822

Formato

customer.ipAddress

Dirección IP del comprador.

Formato

address

Camino: customer.billingDetails.address

Dirección 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

identityType

Camino: customer.billingDetails.identityType

Tipo del documento de identidad.

Valores posibles:

País	TIPO	DESCRIPCIÓN
ARGENTINA	DNI	Documento Nacional de Identidad
BRASIL	CNPJ	Cadastro Nacional da Pessoa Jurídica
BRASIL	CPF	Cadastro de Pessoas Físicas
COLOMBIA	CC	Cédula de ciudadania
	TI	Tarjeta de Identidad
	CE	Cédula de Extranjeria
	NI	Número de Identificación Tributaria
	PS	Pasaporte
Peru	DNI_PER	Documento National de Identidad
	por	Partida de Nacimiento
	No	Pasaporte
	LMI	Libreta Militar
	NAN	Otro

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 obligatorios si el valor de paymentSource está establecido en MOTO, CC MOTO o si se indica el objeto authenticationDetails.

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

Nombre 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 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

Nombre 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 su uso futuro.
VERIFIED_ADDRESS	Entrega a una dirección verificada. Reservado para su uso futuro.
NOT_VERIFIED_ADDRESS	Entrega a una dirección no verificada. 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	Otros Reservado para su uso futuro.
PICKUP_POINT	Retiro en un punto de relevo. 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

Monto del seguro para todo el pedido expresado en su fracción monetaria más pequeña (el centavo para el peso argentino).

Ejemplo: 30050 para 300,50 ARS.

Formato

shippingAmount

Camino: customer.shoppingCart.shippingAmount

Monto 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 para 300,50 ARS.

Formato

taxAmount

Camino: customer.shoppingCart.taxAmount

Monto 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 para 300,50 ARS.

Formato

cartItemInfo

Camino: customer.shoppingCart.cartItemInfo

cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.

Permite describir cada artículo del carrito.

Formato

productAmount

Camino: customer.shoppingCart.cartItemInfo.productAmount

Monto del producto expresada en su fracción monetaria más pequeña (el centavo para el peso argentino).

Ejemplo: 30050 para 300,50 ARS.

Formato

productLabel

Camino: customer.shoppingCart.cartItemInfo.productLabel

Nombre del producto.

Formato

productQty

Camino: customer.shoppingCart.cartItemInfo.productQty

Cantidad de producto.

Formato

productRef

Camino: customer.shoppingCart.cartItemInfo.productRef

Referencia del producto.

Formato

productType

Camino: customer.shoppingCart.cartItemInfo.productType

Tipo de producto.

Valores posibles

VALOR	Descripción
FOOD_AND_GROCERY	Alimentos y productos comestibles.
AUTOMOTIVE	Automotriz / Motocicleta
ENTERTAINMENT	Entretenimiento / Cultura
HOME_AND_GARDEN	Casa y jardín
HOME_APPLIANCE	Equipo de la casa
AUCTION_AND_GROUP_BUYING	Subastas y compras a granel
FLOWERS_AND_GIFTS	Flores y regalos
COMPUTER_AND_SOFTWARE	Computadoras y software
HEALTH_AND_BEAUTY	Salud y belleza.
SERVICE_FOR_INDIVIDUAL	Servicios a domicilio
SERVICE_FOR_BUSINESS	Servicios de negocios
SPORTS	Deportes
CLOTHING_AND_ACCESSORIES	Ropa y accesorios
TRAVEL	Viajes
HOME_AUDIO_PHOTO_VIDEO	Sonido, imagen y video
TELEPHONY	Telefonía

Formato

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 sobre el importe. Ejemplos: 20,0 o 19,6532

Para expresar un porcentaje aplicado al monto del producto en cuestión, el valor debe tener un máximo de 4 dígitos después del punto decimal. El decimal es obligatorio para expresar un porcentaje. La posición decimal está marcada por el carácter ".".

Formato

acquirerTransientData

Permite la transmisión de información específica a determinados adquirentes/redes.

Restringir los códigos BIN aceptados

Para limitar las tarjetas de pago aceptadas según su código BIN, se requiere el formato siguiente:

{"MULTI":{"bins": ["bin1","bin2","bin3"]}}

Nota : Admite códigos BIN de 6 u 8 dígitos.

Ejemplo: .
Códigos BIN6 cifras: 4012 34XX XXXX XXXX;
Códigos BIN8 cifras: 4000 1234 XXXX XXXX.

Formato

contrib

Nombre de la solución de e-comercio utilizada en el sitio web comercial 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 lo utilizan los vendedores que implementan el analizador de riesgos en su página de pago. Permite transmitir el identificador de la 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 adjuntos a la transacción, en formato json.

Ejemplo de llamada

Por ejemplo, para transmitir un valor personalizado, agregue a su solicitud:

{
    "metadata": {
        "MyValueKey": "1234"
    }
}

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 se muestran en el Back Office Vendedor, en la información de la transacción (pestaña Extra ).

Formato

merchantPostUrlRefused

Permite definir la URL a la que se redirigirá el navegador tras el fallo de la autentificación 3-D Secure.

Formato

merchantPostUrlSuccess

Permite definir la URL a la que se redirigirá el navegador tras una autentificación 3-D Secure satisfactoria.

Formato

strongAuthentication

strongAuthentication permet d'indiquer la préférence du marchand au sujet de l'authentification de l'acheteur.

Sin interacción del titular ( frictionless ).
Con interacción del titular (autentificación fuerte o challenge ).
Sin preferencia del vendedor.

Se requerirá siempre una autentificación fuerte al registrar una tarjeta, cualquiera que sea la preferencia del vendedor.

Casos de uso	Valores posibles
CHALLENGE : Con interacción del titular	ENABLED : Valor obsoleto
	CHALLENGE_REQUESTED : Permite solicitar una autenticación fuerte para la transacción.
	CHALLENGE_MANDATE : Permite solicitar una autenticación fuerte para la transacción por razones reglamentarias.
FRICTIONLESSSin interacción del titular Opción "Frictionless 3DS2" obligatoria	DISABLED: Permite solicitaruna exenciónde autenticación fuerte. Si la tienda no dispone de la opción "Frictionless 3DS2", la elección de preferencia se delega al emisor de la tarjeta (No Preference). Si el emisor acepta la solicitud de frictionless, la transacción no está cubierta por la transferencia de responsabilidad en caso de disputa del titular de de tarjeta.
Sin preferencia del vendedor	NO_PREFERENCE : Indica al DS que el vendedor no tiene preferencia. El pago quedará garantizado si el emisor decide realizar una autenticación sin interacción (frictionless).
Sin preferencia del vendedor	AUTO : Se delega la elección de la preferencia al emisor de la tarjeta (No Preference).

Formato

useCase

Se utiliza para especificar el caso de uso deseado.

Valor posible

Valor que debe introducirse para el pago múltiple en el envío :

VALOR	Descripción
SHIPMENT_MULTIPLE_AUTHORISATION	Caso práctico "Pago al envío con autorizaciones múltiples

Formato

paymentSource

Camino: transactionOptions.cardOptions.paymentSource

Origen del pago.

Formato

Valores posibles

. Los valores posibles son:

VALOR	Descripción
EC	E-Commerce: el comprador ingresa los datos del medio de pago. Este valor permite tener una autentificación fuerte al momento del pago.
MOTO	MAIL OR TELEPHONE ORDER: Ingreso realizado por un operador. Los datos del medio de pago se envían por correo postal o electrónico. Requiere un contrato de tipo VAD.
CC	Call Center: pago realizado a través de un centro de atención telefónico. Requiere un contrato de tipo VAD.
OTHER	Otro canal de venta. Valor de salida devuelto para los pagos realizados desde el Back Office Vendedor, los pagos por archivo, los pagos recurrentes, los pagos de proximidad.
Absent ou null	El valor predeterminado es “EC”.

mid

Camino: transactionOptions.cardOptions.mid

Número de contrato del vendedor. Si este campo es completado, asegúrese de utilizar el contrato correcto en función de 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 por defecto de la tienda seleccionada (configurable en el Back Office Vendedor).

captureDelay

Camino: transactionOptions.cardOptions.captureDelay

Fecha límite para aplicar en la fecha de captura.

Descripción

Indica el número de días antes de la captura.

Si no se transmite este parámetro, se utiliza el valor predeterminado definido en el Back Office Vendedor.

Este último es configurable en el Back Office Vendedor por todas las personas debidamente autorizadas.

Si el tiempo de entrega es mayor a 365 días en la solicitud de pago, se reposiciona automáticamente a 365 días.

Formato

firstInstallmentDelay

Camino: transactionOptions.cardOptions.firstInstallmentDelay

Cantidad de meses en los que se aplaza el primer pago de un pago a plazos. Campo específico a los adquirentes en Latino américa.

Formato

installmentNumber

Camino: transactionOptions.cardOptions.installmentNumber

Cantidad de cuotas.

Formato

retry

Camino: transactionOptions.cardOptions.retry

Número de nuevos intentos disponibles en caso de rechazo del pago (3 por defecto).

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 en crédito: el débito se difiere y el monto puede debitarse en una o más cuotas. Al vendedor se le acredita posteriormente la totalidad o solo una parte del monto 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

initiatedTransactionIndicator

Camino: transactionOptions.cardOptions.initiatedTransactionIndicator

Finalidad del uso del token de la tarjeta.

Para la redMastercard

Value	Category	Descripción
C101	Credential-on-file	El consumidor acepta almacenar las credenciales en los archivos del comerciante para futuras compras iniciadas por el titular de la tarjeta que puedan ocurrir de vez en cuando.
C102	Orden permanente (importe variable y frecuencia fija)	El consumidor acepta almacenar la credencial en archivo e inicia una primera transacción de una serie destinada a ser por un monto variable y una frecuencia fija.
C103	Suscripción (cantidad fija y frecuencia)	El consumidor acepta almacenar la credencial en archivo e inicia una primera transacción de una serie destinada a ser por un monto fijo y una frecuencia fija.
C104	Installment	El consumidor acepta almacenar la credencial en archivo para establecer un plan de pagos e inicia la primera transacción de una serie. El plan de pagos debe reflejar la compra única de bienes o servicios con un importe determinado y una frecuencia establecida durante un período específico.
M101	Orden permanente (importe variable y frecuencia fija)	Una transacción realizada conforme a un acuerdo entre el titular de la tarjeta y el comercio, mediante el cual el titular autoriza al comercio a almacenar y utilizar los datos de su cuenta para iniciar una o más transacciones futuras. La transacción puede ser por un importe fijo o variable, pero no se realiza a intervalos regulares en una fecha programada.
M102	Orden permanente (importe variable y frecuencia fija)	Una transacción realizada de conformidad con un acuerdo entre un titular de tarjeta y un comerciante, mediante el cual el titular de la tarjeta autoriza al comerciante a almacenar y utilizar los datos de la cuenta del titular de la tarjeta para una transacción que debe ocurrir a intervalos regulares programados por un monto variable, según se especifica en el acuerdo.
M103	Suscripción (cantidad fija y frecuencia)	Una transacción realizada en virtud de un acuerdo entre el titular de la tarjeta y un comercio, mediante el cual el titular autoriza al comercio a almacenar y utilizar los datos de su cuenta para una transacción que debe realizarse a intervalos regulares por un importe fijo, según lo especificado en el acuerdo. El acuerdo de suscripción puede incluir una cláusula de precio introductorio o la posibilidad de cambios de precio ocasionales.
M104	Installment	Una transacción en una serie de transacciones realizadas de conformidad con un acuerdo entre un titular de tarjeta y un comerciante, en donde el titular de tarjeta autoriza al comerciante a almacenar los datos de la cuenta del titular de tarjeta para que el comerciante los utilice para iniciar una o más transacciones futuras por un monto conocido durante una duración específica basada en una sola compra.

Formato

initialIssuerTransactionIdentifier

Camino: transactionOptions.cardOptions.initialIssuerTransactionIdentifier

Referencia de encadenamiento.

Formato

name

Camino: authenticationDetails.protocol.name

Nombre del protocolo de autentificación del titular de la tarjeta.

Valores posibles

VALOR	Descripción
THREEDS	Protocolo 3-D Secure

Formato

version

Camino: authenticationDetails.protocol.version

Versión del protocolo de autentificación del titular de la tarjeta.

Valores posibles

VALOR	Descripción	Protocolo compatible
2	Debe indicarse si la versión exacta no se conoce. En este caso, se considera la última versión que la plataforma admite en 3-D Secure 2	Todos
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 autentificación.

Valores posibles

NOMBRE DEL PROTOCOLO	VALOR DE DIRECTORYSERVER	NOMBRE DE LA RED
THREEDS	Amex	Red American Express (Safekey)
	CB	Red Carte Bancaire
	Visa	Red Visa
	Elo	Red Elo (Brasil)
	Diners	Red Diners
	Discover	Red Discover
	Elo	Red Elo

Formato

challengePreference

Camino: authenticationDetails.protocol.challengePreference

Indica si el vendedor ha solicitado un "challenge" o no.

Valores posibles

VALOR	Tarjeta 3DS2
NO_PREFERENCE	La elección de la preferencia se delega al emisor de la tarjeta.
NO_CHALLENGE_REQUESTED	Permite solicitar una autentificación sin interacción (frictionless).
CHALLENGE_REQUESTED	Permite solicitar una autentificación fuerte para la transacción.
CHALLENGE_MANDATED	Permite indicar que, por razones reglamentarias, la transacción requiere una autentificación fuerte.
DATA_ONLY	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 se desactiva si la red es incompatible con esta funcionalidad. El Web Service PCI/Charge/Authenticate devuelve un código de error INT_808 si el campo`transactionCategory`su valor no puede ser`PAYMENT`.

Formato

authenticationType

Camino: authenticationDetails.authenticationType

El tipo de autentificación que tuvo lugar.

Valores posibles

VALOR	Descripción
FRICTIONLESS	autentificación en modo Frictionless, es decir, de forma transparente para el cliente
CHALLENGE	Autentificación con Challenge, el cliente tuvo que autentificarse 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 autentificación, es decir, el resultado positivo/negativo de la autentificación.

Valores posibles

VALOR	Descripción
ATTEMPT	Prueba de intento de autentificación cuando la autentificación no está disponible
ENROLLED_UNAVAILABLE	No se puede obtener el estado de inscripción
FAILED	autentificación incorrecta
NOT_ENROLLED	Tarjeta no enrolada
SUCCESS	autentificación exitosa
UNAVAILABLE	No se pudo completar la autentificación (error técnico, etc.)
DISABLED	autentificación desconectada. El campo exemption se vuelve obligatorio

Formato

commerceIndicator

Camino: authenticationDetails.commerceIndicator

El indicador de comercio, llamado ECI (Electronic Commerce Indicator) para el protocolo 3DS. Indicador devuelto por el ACS para indicar los resultados del intento de autentificació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 autentificación final (según el DS, este valor puede denominarse CAVV, AEVV o AAV). Cadena de caracteres codificada en base 64 con un tamaño de 28 caracteres.

Formato

dsScore

Camino: authenticationDetails.dsScore

Puntuación de autenticación especificada por el DS, solo para la red CB . Consulte la Guía de Integración .

Formato

authValueAlgorithm

Camino: authenticationDetails.authValueAlgorithm

Algoritmo utilizado para calcular el campo authenticationValue . Este campo solo es relevante para la red CB . Consulte la Guía de Integración .

Formato

requestorName

Camino: authenticationDetails.requestorName

Nombre del solicitante utilizado durante la autenticación inicial. Normalmente, este campo corresponde al nombre del comerciante. Este campo solo es relevante para la red CB . Consulte la Guía de Integración .

Formato

dsTransID

Camino: authenticationDetails.dsTransID

Identificación de la transacción de la DS. (Obligatorio en 3-D Secure V2).

Formato

acsTransID

Camino: authenticationDetails.acsTransID

ID de transacción de ACS. Este campo solo es relevante para la red CB . Consulte la Guía de Integración .

Formato

xid

Camino: authenticationDetails.xid

Identificador único de la transacción.

Formato

exemption

Camino: authenticationDetails.exemption

Indica la razón por la que no se utiliza la autentificación fuerte. (Necesario en caso de estado DISABLED o en caso de autentificació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 adquirente
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	Autentificació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

challengeCancelationIndicator

Camino: authenticationDetails.challengeCancelationIndicator

Indicador de la cancelación del challenge recibido en el RReq. (Valor que devuelve el DS en caso de anulación de la autentificación).

Formato

transactionStatusReason

Camino: authenticationDetails.transactionStatusReason

Indica el motivo del fallo de la autentificación. (Valor devuelto por el DS en caso de fallo de autentificación).

Formato

companyType

Camino: subMerchantDetails.companyType

Tipo de empresa del subvendedor. Transmitido por el facilitador de pago.

Pueden aplicarse reglas diferentes según el adquiriente. A menudo este campo permite indicar el tipo de Legal Number del comprador.

Fiserv

Valores posibles :

NATIONAL_IDENTITY
SINGLE_TAX_IDENTIFICATION
SINGLE_CODE_OF_LABOR_IDENTIFICATION
BOOK_ENLISTMENT
CIVIC_NOTEBOOK
PASSPORT

Más información: Fiserv.

PRISMA

Valores posibles :

CUIT: Código Único de Identificación Tributaria
CUIL: Código Único de Identificación Laboral
DNI: Documento Nacional de Identidad

Más información: Prisma.

Formato

legalNumber

Camino: subMerchantDetails.legalNumber

Número legal del subvendedor según el campo companyType. Transmitido por el facilitador de pago.

Este campo es obligatorio para el adquirente Prisma. (Más información: 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 Prisma. (Más información: Prisma ).

Formato

address2

Camino: subMerchantDetails.address2

Complemento de la dirección del subvendedor. Transmitido por el facilitador de pago.

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 del país de la dirección del subvendedor (norma ISO 3166 alpha-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 Prisma. (Más información: Prisma ).

Formato

mid

Camino: subMerchantDetails.mid

Número de afiliación (MID) del subvendedor. Transmitido por el facilitador de pago.

Campo obligatorio para los adquirentes Fiserv y Procesos. (Más información: Fiserv.)

Formato

softDescriptor

Camino: subMerchantDetails.softDescriptor

Descripción (soft-descriptor) del subvendedor que aparece en el extracto de operaciones bancarias del comprador. Transmitido por el facilitador de pago.

Para el adquirente Prisma , este campo es obligatorio y debe respetar el siguiente formato:

"CÓD.AGRUPADOR ASIGNADO POR PRISMA" * "NÚMERO FANTASÍA VENDEDOR".

El campo Softdescriptor se debe construir bajo el siguiente criterio:

Estructura:

Subcampo 1 : Nombre abreviado del Payment Facilitator o Marketplace, su longitud puede ser de 3, 7 o 12 posiciones. Este nombre debe coincidir con el valor informado en Anexo 1 campo 'Nombre del Payment Facilitator / Marketplace tal cual será enviado en Autorización'

Subcampo 2 : Informar valor fijo '*' en la posición 4, 8 o 13 según corresponda

Subcampo 3 : Informar el nombre del establecimiento esponsoreado desde la posición 5, 9 0 14 según corresponda.

La longitud máxima sumando los subcampos 1, 2 y 3 no podrá superar las 25 posiciones

Long. total: 25 caracteres incluyendo el cód. de agrupador.

Caracteres aceptados: [A-Z];[0-9];[*].

Ejemplos:

"TPP*ELECTONICA TUCUMAN"
"MPP*MARTIN GONZALEZ"

Más información: Prisma.

Para el adquirente Fiserv , este campo es obligatorio y debe respetar el siguiente formato:

"Pfac" * "subMerchantDetails.name".

El Pfac que ha elegido el vendedor permite construir este campo obligatorio concatenándolo con el campo subMerchantDetails.name.

Más información: Fiserv.

Formato

state

Camino: subMerchantDetails.state

Región de la dirección del subvendedor. Transmitido por el facilitador de pago.

Este campo es obligatorio para el adquirente Prisma. (Más información: Prisma ).

Formato

facilitatorId

Camino: subMerchantDetails.facilitatorId

Identificador del facilitador de pago. Transmitido por el facilitador de pago.

Este campo es obligatorio para el adquirente Prisma. (Más información: Prisma ).

Formato

Referencia de la respuesta

Existen varias respuestas posibles dependiendo del contexto:

Respuesta	Contexto
AuthenticationSessionResponse	Objeto que contiene el resultado de la autentificación de la sesión
Payment	Objeto que contiene la transacción generada. Este objeto se devuelve directamente durante un pago con autentificación simple.

Consulte la referencia de cada respuesta para más información.

Categoria

Tags

Token de formulario no definido

PCI/Charge/CreatePayment (PCI)

autentificación con nuestro servidor de autentificación

Autentificación con otro servidor de autentificación

Parámetros de entrada

amount

Formato

currency

Formato

Valores posibles

orderId

Formato

formAction

Formato

Valores posibles

paymentMethodType

Camino: paymentForms.paymentMethodType

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

overridePaymentCinematic

Camino: paymentForms.overridePaymentCinematic

Formato

paymentMethodToken

Camino: paymentForms.paymentMethodToken

Formato

taxAmount

Formato

taxRate

Formato

customer.reference

Formato

customer.email

Formato

customer.ipAddress

Formato

address

Camino: customer.billingDetails.address

Formato

address2

Camino: customer.billingDetails.address2

Formato

category

Camino: customer.billingDetails.category

Formato

Valores posibles

cellPhoneNumber

Camino: customer.billingDetails.cellPhoneNumber

Formato

city

Camino: customer.billingDetails.city

Formato