Servicio Web Charge/CreateShipmentTransaction

Le Web Service REST Charge/CreateShipmentTransaction permet de créer une nouvelle transaction d'expédition à partir de la transaction initiale.

Consultez le guide d'intégration : Réaliser un paiement à l'expédition.

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

Referencia única de la transacción generada por la plataforma de pago.

Formato

Comentario libre.

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:

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.

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

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

Referencia de la respuesta

El Web Service devuelve el siguiente objeto:

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