Web Service Charge/CreateSubscription

Le Web Service REST Charge/CreateSubscription permet de réaliser des paiements récurrents (abonnements) à partir d'un alias (Création d'un alias).

Pour être notifié du résultat d'une échéance, la règle "URL de notification à la création d'un paiement récurrent" doit être activée et configurée depuis lebom_expert(menuConfiguración > Reglas de notificación).

Verifique la configuración delRespuesta:Subscription.

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

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:

Comentario libre.

Formato

Descripción asociada a la suscripción.

Formato

Fecha de inicio de la suscripción en formato ISO 8601 definido por W3C.

Formato

Monto de los primeros vencimientos. Su valor debe ser un entero positivo (por ejemplo: 1234 por EUR 12.34).

Formato

Número de cuotas a las que se aplicará el monto definido en initalAmount.

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:

Token asociado a un medio de pago.

Formato

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

Formato

Descripción de la regla de la suscripción bajo la forma de rrule (RFC-5545).

Para más información sobre cómo administrar una RRULE:

• Especificación de una RRULE
• Generador de RRULE
• Ejemplos de reglas de recurrencia

Pour des raisons techniques, il est impossible de définir des périodes d'abonnement inférieures à une journée.
Les mots clés "SECONDLY" / "MINUTELY" / "HOURLY" ne sont donc pas pris en compte.

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

Referencia de la respuesta

El Web Service devuelve el siguiente objeto:

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