PCI/Charge/CreatePayment

La operación Charge/CreatePayment es un Web Service 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 Web Service.

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

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.

Punto importante sobre los pagos CB

Con la aplicación de la DSP2, los emisores pueden rechazar la transacción si no se ha realizado la autentificación 3-D Secure. Este comportamiento se llama "Soft Decline".

En caso de "Soft Decline", el valor del campo transactionDetails.cardDetails.authorizationResponse.authorizationResult es 81 Es responsabilidad del vendedor iniciar un nuevo pago con autentificación 3-D Secure.

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 la solicitud

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

Monto del pago en su fracción monetaria más pequeña (el céntimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

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

Ejemplo: "EUR" para el euro.

Formato

Valores posibles

. Los valores posibles son:

Referencia de pedido definida por el vendedor. No admite los caracteres UTF-8.

Formato

formAction le permite definir el tipo de comportamiento que desea al crear la transacción.

Formato

Valores posibles

. Los valores posibles son:

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.

Tipo de medio de pago. Ejemplo: PAYCONIQ

Formato

El PAN (Primary Account Number) es el número principal de la tarjeta, generalmente compuesto por 16 dígitos).

Formato

Mes de expiración en 2 dígitos. Ejemplo: "09" por septiembre.

Formato

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

Formato

Código de seguridad de la tarjeta.

Su longitud puede variar entre 3 o 4 dígitos dependiendo del tipo de tarjeta.

Formato

Marca de la tarjeta.

Formato

Nombre completo del titular de la tarjeta

Formato

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

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

Tipo del documento de identidad.

Formato

Cantidad de cuotas.

Formato

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:

Formato

Token asociado a un medio de pago.

Formato

Monto de los impuestos para toda la orden expresados en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

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

Tipo de dispositivo en el que se realiza la autentificación.

Valores posibles

Formato

El contenido exacto del encabezado HTTP accept, tal como lo envió el navegador del cliente.

Formato

Contenido exacto del encabezado HTTP "user-agent" enviado por el navegador. 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;

Formato

Dirección IP del navegador tal como la devuelve el cliente en los encabezados HTTP. Format IPV4 (ejemplo: 1.12.123.255) o IPV6 (ejemplo: 2011:0db8:85a3:0101:0101:8a2e:0370:7334). Longitud variable máximo 45 caracteres.

Formato

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();

Formato

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

Este valor representa la profundidad de la paleta de colores utilizada para visualizar 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;

Formato

La altura total de la pantalla del cliente en píxeles. El valor es aquel devuelto por la propiedad “screen.height”. De 1 a 6 caracteres.

Código Javascript que permite obtener el valor:

const screenHeight = screen.height;

Formato

El ancho total de la pantalla del cliente en píxeles. El valor es aquel devuelto por la propiedad “screen.width”. De 1 a 6 caracteres.

Código Javascript que permite obtener el valor:

const screenWidth = screen.width;

Formato

Diferencia de tiempo entre la hora UTC y la hora local del navegador del cliente, en minutos. Su valor es de -120 para un usuario en el huso horario UTC+2 y 570 para el huso horario UTC−09:30.

Código Javascript que permite obtener el valor:

const timeZoneOffset = new Date().getTimezoneOffset();

Formato

Identificador del comprador en el sitio web comercial.

Formato

E-mail del comprador.

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

Formato

Dirección de facturación.

Atención: Los caracteres > y < no están permitidos.

Formato

Información adicional sobre la dirección de facturación.

Atención: Los caracteres > y < no están permitidos.

Formato

Tipo de cliente.

Formato

Valores posibles

Teléfono móvil del comprador.

Acepta todos los formatos:

Ejemplos:

• 0623456789
• +33623456789
• 0033623456789
• (+34) 824 65 43 21
• 87 77 12 34

Formato

Ciudad de facturación.

Formato

País del comprador (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).

Formato

Valores posibles

Ejemplos de valores posibles:

Barrio de la dirección de facturación.

Formato

Nombre del comprador.

Formato

Identificación nacional. Identifica de manera única a cada ciudadano en un país.

Formato

Tipo del documento de identidad.

Formato

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.

Formato

Valores posibles

Ejemplos de valores posibles:

Nombre del comprador.

Formato

Razón social.

Formato

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

Región (estado) de la dirección de facturación. Es recomendable pero no obligatorio transmitir el valor ISO-3166-2.

Formato

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

Tratamiento del comprador.

Ejemplos:

• Sr.
• Sr.
• Sra.

Formato

Código postal de la dirección de facturación.

Formato

Dirección de entrega.

Atención: Los caracteres > y < no están permitidos.

Formato

Segunda línea de la dirección de facturación.

Atención: Los caracteres > y < no están permitidos.

Formato

Tipo de cliente.

Formato

Valores posibles

Ciudad de entrega.

Formato

País de entrega (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).

Formato

Valores posibles

Ejemplos de valores posibles:

Nombre de la empresa emisora del producto.

Formato

Barrio de la dirección de facturación.

Formato

Nombre del destinatario.

Formato

Identificación nacional. Identifica de manera única a cada ciudadano en un país.

Formato

Nombre del comprador.

Formato

Razón social en caso de entrega a una empresa.

Formato

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

Modo de entrega.

Formato

Valores posibles

Plazo de entrega.

Formato

Valores posibles

Ejemplos de valores posibles:

Región de la dirección de facturación.

Formato

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

Código postal de la dirección de facturación.

Formato

Monto del seguro para todo el pedido expresado en su unidad monetaria más pequeña (el centimo del euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

Monto de los gastos de entrega para todo el pedido expresado en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

Monto de los impuestos para toda la orden expresados en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.

Permite describir cada artículo del carrito.

Formato

Cantidad de ingresos expresados en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

Nombre del producto.

Formato

Cantidad de producto.

Formato

Referencia del producto.

Formato

Tipo de producto.

Valores posibles

Formato

Tipo de producto.

Monto del impuesto sobre el producto (en la unidad más pequeña de la moneda).

Valores posibles

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

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

Utilización con Conecs in France

Campo opcional que permite la transferencia del monto de los productos elegibles pagaderos con la tarjeta de cheque restaurante CONECS.

Si el campo no se transmite, el monto total se considerará elegible para el pago con la tarjeta cheque restaurante, incluidos los eventuales costos de envío incluidos en el monto del pedido.

Ejemplo para una cantidad elegible de 17.25 €:

Ejemplo: .

{"CONECS":{"eligibleAmount":"1725"}}

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

Nombre de la solución de e-comercio utilizada en el sitio web comercial y su número de versión.

Formato

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

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

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

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

Formato

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

Formato

strongAuthentication indica la preferencia del vendedor respecto a la autentificación del comprador.

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

Al guardar una tarjeta, la autentificación fuerte del titular es obligatoria. Transmitir el campo formAction con los siguientes valores:

• REGISTER_PAY : para realizar un pago y guardar el medio de pago.
• REGISTER_PAY : para realizar un pago y preguntar si se desea guardar el medio de pago.
• CUSTOMER_WALLET : para guardar el medio de pago.

En este caso, en el campo strongAuthentication se establece automáticamente el valor CHALLENGE_MANDATE.

Tabla de exenciones (valor DISABLED)

Formato

Se utiliza para especificar el caso de uso deseado.

Valor posible

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

Formato

Origen del pago.

Formato

Valores posibles

. Los valores posibles son:

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.

Formato

Modo de validación de la transacción.

Formato

Valores posibles

. Los valores posibles son:

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

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

Cantidad de cuotas.

Formato

Cantidad de nuevos intentos disponibles en caso de rechazo del pago (1 por defecto).

Formato

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

Valores posibles

Formato

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

Valores posibles

Formato

Nombre de la red DS en la que se realizó la autentificación.

Valores posibles

Formato

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

Valores posibles

Formato

El tipo de autentificación que tuvo lugar.

Valores posibles

Formato

El estado de autentificación, es decir, el resultado positivo/negativo de la autentificación.

Valores posibles

Formato

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:

Formato

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

Score de l'authentification spécifié par le DS, uniquement pour le réseau CB. Voir : Guide d'intégration.

Formato

Algorithme utilisé pour calculer le champ authenticationValue. Ce champ concerne uniquement le réseau CB. Voir : Guide d'intégration.

Formato

RequestorName utilisé lors de l'authentification initiale. En général ce champ correspond au nom du marchand. Ce champ concerne uniquement le réseau CB. Voir : Guide d'intégration.

Formato

Identificación de la transacción de la DS.

Formato

Identifiant de transaction de l'ACS. Ce champ concerne uniquement le réseau CB. Voir : Guide d'intégration

Formato

Identificador único de la transacción.

Formato

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

Formato

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

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

Formato

Nombre de la instrucción.

Valores posibles

Formato

Resultado como una cadena JWT, o un código de error en texto plano en caso de error ('timeout' por ejemplo).

Formato

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

Valores posibles

Formato

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

Valores posibles

Formato

Red en la que se autentificó el medio de pago.

Este campo es obligatorio para gestionar el tiempo de espera en el método 3ds, cuando el campo instructionResult.value se establece en TIMEOUT.

Redes compatibles actualmente

Formato

Booleano que indica si la autentificación debe realizarse en modo de simulación. Si establece el valor de este campo obligatorio en:

• true, se activa el modo de simulación.
• false, no se activa el modo simulación.

El modo de simulación permite lograr una integración comercial sin estar en producción, ni utilizar tarjetas reales.

Formato

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

Versiones actualmente soportadas

Formato

Identificador único para la sesión de autentificación.

Formato

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.

Formato

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

Formato

Razón social del subvendedor. Transmitido por el facilitador de pago.

Formato

URL del subvendedor. Transmitido por el facilitador de pago.

Formato

Número de teléfono del subvendedor. Transmitido por el facilitador de pago.

Formato

Dirección del subvendedor. Transmitido por el facilitador de pago.

Formato

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

Formato

Código postal del subvendedor. Transmitido por el facilitador de pago.

Formato

Ciudad del subvendedor. Transmitido por el facilitador de pago.

Formato

Código del país de la dirección del subvendedor (norma ISO 3166 alpha-2). Transmitido por el facilitador de pago.

Formato

Código MCC del subvendedor. Transmitido por el facilitador de pago.

Formato

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

Formato

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

Formato

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

Formato

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

Formato

Referencia de la respuesta

Existen varias respuestas posibles dependiendo del contexto:

Consultar la referencia de las respuestas para más información.