Web Service Charge/CreatePayment

Casos de uso

Parámetros de entrada

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

Ejemplo: 30050 para 300,50 PEN.

Formato

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

Ejemplo: 30050 para 300,50 PEN.

Formato

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

Formato

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

Ejemplo: Ej: "PEN" para el sol peruano.

Formato

Valores posibles

. Los valores posibles son:

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

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

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

Transmitir los datos para el análisis de riesgos

Las transacciones se someten sistemáticamente a un análisis de riesgo para determinar si se necesita una autentificación 3D-Secure o si presentan un riesgo demasiado elevado para aceptarlas. Para que el análisis sea lo más pertinente posible, usted debe transmitir un máximo de informaciones en su formulario de pago.

Para detallar el análisis, usted puede utilizar los campos descritos a continuación. Se devuelven estos campos en la notificación de fin de pago.

Para ilustrar, aquí hay un ejemplo con el número de teléfono : cybersource_mdd_13.

{
  "amount": 180,
  "currency": "PEN",
  "customer": {
    "email": "[sample@example.com|mailto:sample@example.com]"
  },
  "metadata": {
    "cybersource_mdd_13": "0606060606"
  },
  "orderId": "myOrderId-417842"
}

Valores posibles

Los valores posibles son:

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

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

Formato

Valores posibles

. Los valores posibles son:

PAYMENT

Le Web Service retourne un formToken.

C'est le comportement par défaut. L'appel à Charge/CreatePayment crée une transaction sans effectuer d'opération supplémentaire.

REGISTER_PAY

Le Web Service retourne un formToken.

Un alias (ou token) du moyen de paiement est créé en même temps que la transaction. Cet alias vous permet ensuite de créer des transactions en un clic. L'alias nouvellement créé est renseigné dans la propriété paymentMethodToken. Plus d'informations, voir : Création et utilisation d'alias.

ASK_REGISTER_PAY

Le Web Service retourne un formToken.

Ce paramètre permet d'ajouter dans le formulaire de paiement une case à cocher demandant à l'acheteur s'il veut enregistrer sa carte.

Más información, consulte: Creación y uso de alias.

CUSTOMER_WALLET

Le Web Service retourne un formToken.

Ce paramètre permet d'ajouter dans le formulaire de paiement une case à cocher demandant à l'acheteur s'il veut enregistrer sa carte dans son wallet. Nécessite la référence acheteur customer.reference.

SILENT Réservé pour les transactions initiées par le marchand sans la présence de l'acheteur et notamment pour les paiements récurrents lorsque la récurrence est gérée par le marchand.

En el área de aplicación de la DSP2, la autentificación del titular es obligatoria cuando el titular está presente. Por lo tanto, el modo SILENT se reserva para aquellos casos en que el titular está ausente o para los vendedores que se encuentren fuera del área de la DSP2.

En el área de aplicación de la DSP2, se ignora el campo strongAuthentication y no se realiza autentificación alguna del titular.

Le Web Service retourne directement une transaction plutôt qu'un formToken lors d'un paiement par alias (token). La transaction se fait donc de serveur à serveur.

Token asociado a un medio de pago.

Formato

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.

Formato

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

Lista de formas de pago para ofrecer al comprador

Ejemplo: "VISA;MASTERCARD".

Si la lista solo contiene un modo de pago, la página de ingreso de datos de este medio de pago será presentada directamente. De lo contrario, se presentará la página de selección de los medios de pago.

Si este campo está vacío (indicado), se ofrecerán todos los medios de pago elegibles (monedas, restricciones técnicas, etc.) asociados a la tienda.

Formato

Identificador del comprador en el sitio web comercial.

Obligatorio si vads_cust_status está establecido en PRIORITY.

En ese caso, la referencia del comprador se utiliza como identificador del wallet.

Formato

E-mail del comprador.

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

Este parámetro es obligatorio al crear un alias (definiciónformActionaREGISTER_PAY,ASK_REGISTER_PAYoCUSTOMER_WALLET).
Si este parámetro está ausente al crear elformToken(Crear un formToken), la plataforma muestra automáticamente un campo para ingresar el correo electrónico del comprador.

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.

Valores posibles:

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 fracción monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

Monto de los gastos de envío de todo el pedido expresado en su unidad monetaria más pequeña (el céntimo para el suelo peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

Monto de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.

Permite describir cada artículo del carrito.

Formato

Cantidad del producto expresada en su unidad monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

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

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.

Un contrato de VISANET no puede utilizarse para una transacción de MASTERCARD.

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

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

Formato

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

Formato

Finalidad del uso del token de la tarjeta.

• Para la redMastercard

Formato

Referencia de encadenamiento.

Formato

Monto de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

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

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

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

formTokenVersion define la versión del formToken enviada por el Web Service.

Este parámetro se utiliza en el marco del SDK móvil. Permite asegurarse de que la versión del formToken devuelta está siempre sincronizada con la aplicación móvil implementada en el teléfono del comprador.

El valor por defecto es 4.

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.

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

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:

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