support
Volver a la documentación
Buscar
Categoria
Tags
Charge/CreatePayment
webService
Charge/CreatePaymentOrder
webService
Charge/CreateSubscription
webService
Charge/CreateToken
webService
Charge/CreateTokenFromTransaction
webService
Charge/PaymentOrder/Get
webService
Charge/PaymentOrder/Update
webService
Charge/SDKTest
webService
Order/Get
webService
Subscription/Cancel
webService
Subscription/Get
webService
Subscription/Update
webService
Token/Cancel
webService
Token/Get
webService
Token/Reactivate
webService
Token/Update
webService
Token/UpdateCustomerDetails
webService
Transaction/CancelOrRefund
webService
CustomerWallet/Get
webService
CustomerWallet/Update
webService
Transaction/Capture
webService
Transaction/Duplicate
webService
Transaction/Get
webService
Transaction/Update
webService
Transaction/Validate
webService
Risk/AddToGreyList
webService
PCI/Charge/Authenticate (PCI)
PCI
webService
PCI/Charge/CreatePayment (PCI)
PCI
webService
PCI/Charge/CreateToken (PCI)
PCI
webService
Token/Update (PCI)
PCI
webService
PCI/Charge/VerifyPaymentMethod
PCI
webService
AuthenticationResponseData
answer
Charge/PaymentForm
answer
OrderTransactions
answer
Payment
answer
PaymentOrder
answer
Common/ResponseCodeAnswer
answer
Subscription
answer
SubscriptionCreated
answer
Transaction
answer
Token
answer
CustomerWallet
answer
GreyList
answer
parámetros principalesdesplegar todo
amount
requerido
currency
requerido
orderId
recomendado
formAction
paymentForms
[1]
paymentMethodType
requerido
pan
Tarjetas de prueba

    Token de formulario no definido

    PanDescripciónEstado3DS3DS2
    requerido
    expiryMonth
    requerido
    expiryYear
    requerido
    securityCode
    brand
    installmentNumber
    firstInstallmentDelay
    overridePaymentCinematic
    paymentMethodToken
    cardHolderName
    identityDocumentNumber
    identityDocumentType
    taxAmount
    taxRate
    Información del dispositivo
    device
    deviceType
    requerido
    acceptHeader
    requerido
    userAgent
    requerido
    ip
    javaEnabled
    requerido
    language
    requerido
    colorDepth
    requerido
    screenHeight
    requerido
    screenWidth
    requerido
    timeZoneOffset
    requerido
    información sobre tu cliente
    customer
    reference
    recomendado
    email
    recomendado
    billingDetails
    title
    category
    firstName
    lastName
    phoneNumber
    streetNumber
    address
    address2
    district
    zipCode
    city
    state
    country
    language
    cellPhoneNumber
    identityCode
    identityType
    legalName
    shippingDetails
    category
    firstName
    lastName
    phoneNumber
    streetNumber
    address
    address2
    district
    zipCode
    city
    state
    country
    deliveryCompanyName
    shippingSpeed
    shippingMethod
    legalName
    identityCode
    shoppingCart
    insuranceAmount
    shippingAmount
    taxAmount
    cartItemInfo
    [1]
    productLabel
    productType
    productRef
    productQty
    productAmount
    productVat
    ipAddress
    opciones generales de la transacción
    acquirerTransientData
    [1]
    :
    contrib
    ipnTargetUrl
    fingerPrintId
    metadata
    [1]
    :
    merchantPostUrlRefused
    merchantPostUrlSuccess
    strongAuthentication
    opciones relacionadas con la tarjeta
    transactionOptions
    cardOptions
    paymentSource
    manualValidation
    captureDelay
    retry
    debitCreditSelector
    información sobre al sub-vendedor
    subMerchantDetails
    companyType
    legalNumber
    name
    requerido
    url
    phoneNumber
    address1
    address2
    zip
    city
    country
    mcc
    mid
    softDescriptor
    External authentication data
    authenticationDetails
    protocol
    name
    requerido
    version
    requerido
    directoryServer
    challengePreference
    authenticationType
    status
    requerido
    commerceIndicator
    authenticationValue
    dsScore
    authValueAlgorithm
    requestorName
    requerido
    dsTransID
    acsTransID
    xid
    exemption
    challengeCancelationIndicator
    transactionStatusReason
    parámetros de retorno 3DS
    instructionResult
    name
    requerido
    value
    requerido
    protocol
    name
    requerido
    version
    requerido
    network
    challengePreference
    requerido
    simulation
    requerido
    operationSessionId
    Pruébame
    Documentación

    PCI/Charge/CreatePayment

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

    La activación de estas características está sujeta al consentimiento previo de Cobro Inmediato.

    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

    ATENCIÓN: El objeto threeDSResponse pronto quedará en desuso. Se puede dejar en blanco (null) u omitirse en futuras versiones. Se recomienda utilizar transactions[0].transactionDetails.cardDetails.authenticationResponse

    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

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