support
Volver a la documentación
Buscar
Categoria
Tags
parámetros principalesdesplegar todo
subscriptionId
shopId
paymentMethodToken
orderId
metadata
[1]
:
effectDate
cancelDate
initialAmount
initialAmountNumber
amount
currency
pastPaymentsNumber
totalPaymentsNumber
rrule
description
Pruébame
Documentación

Respuesta de la suscripción

Objeto que contiene información relativa a una suscripción.

Referencia de la respuesta

subscriptionId

Identificador de la recurrencia.

Formato

shopId

Identificación de la tienda.

Formato

paymentMethodToken

Token asociado a un medio de pago.

Formato

orderId

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

Formato

metadata

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 datos para análisis de datos

Las transacciones se someten sistemáticamente a análisis de riesgos para determinar si se requiere autenticación 3D-Secure o si existe un alto riesgo de aceptación. Para garantizar que el análisis sea lo más relevante posible, debemos transmitir la mayor cantidad de información posible en nuestro formulario.

Para detallar el análisis, podemos usar los campos descritos a medida que avanzamos. Estos campos se conocerán al recibir la notificación de fin de página.

Para ilustrarlo, 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:

Nombre del campo DESCRIPCIÓN Opcional / Recomendado Formato
cybersource_mdd_12 Email que el cliente ingresó en el registro o el que coloca durante el proceso de compra. R String (255)
cybersource_mdd_13 Numero de telefono utilizado. R String (255)
cybersource_mdd_14 Información del cliente que realiza la compra, en el campo se registrará el tipo concatenado con el número de identidad.

01 -DNI

02 - CUADERNO DE EXTRAJERIA

03 - PASAPORTE

10 -RUC 10

20 -RUC 20

15 -RUC 15

17 -RUC 17

30 -PTT

Ejm :
  • 01-07659002 (dni)
  • 20-20102034561 (ruc juridico)
 R String (255)
cybersource_mdd_15 Identificador único del cliente de cara al comercio. O String (255)
cybersource_mdd_16 ¿Registro mediante Redes Soc u otras?

SI

NO

 O String (255)
cybersource_mdd_17 Cliente Frecuente.

SI

NO

 O String (255)
cybersource_mdd_18 Número de días transcurridos desde primera compra del cliente. O Float
cybersource_mdd_19 Número de días transcurridos desde última compra del cliente. O Float
cybersource_mdd_20 Número de cupón de descuento. O String (255)
cybersource_mdd_21 Número de Giftcard. O String (255)
cybersource_mdd_22 Indica si el cliente se ha registrado en la web del comercio y bajo qué modalidad Registrado.

01 = Invitado

02 = Empleado

03 = Inscripción directa

 O String (255)
cybersource_mdd_23 Ticket promedio del cliente (sin incluir la compra actual). O Float
cybersource_mdd_24 Riesgo de la transacción.

BAJO

MEDIO

ALTO

 O String (255)
cybersource_mdd_27 Información del beneficiario de la compra, en el campo se registrará el tipo concatenado con el número de identidad .

01 -DNI

02 - CUADERNO DE EXTRAJERIA

03 - PASAPORTE

10 -RUC 10

20 -RUC 20

15 -RUC 15

17 -RUC 17

30 -PTT

Ejm :
  • 01-07659002 (dni)
  • 20-20102034561 (ruc juridico)
 R String (255)
cybersource_mdd_28 Aplica a ventas telefónicas, identificado único de la persona que atendió al cliente durante el proceso de venta (Asistidas). R String (255)
cybersource_mdd_29 Número de items que compra el cliente por pedido. O Float
cybersource_mdd_30 Enviado/Pendiente.

Enviado

Pendiente

 R String (255)
cybersource_mdd_31 Número de horas entre la compra y la entrega del producto / servicio. R Float
cybersource_mdd_32 Número de días que se encuentra esa dirección registrada en sistemas. R Float
cybersource_mdd_33 Número de pedidos realizados a esa dirección registrada en sistemas. O Float
cybersource_mdd_34 Número de compras realizadas en los últimos 6 meses según historial del cliente. O Float
cybersource_mdd_35 Identificador único del establecimiento del comercio. Aplica para delivery de productos/servicios y recoge en el establecimiento. R String (255)
cybersource_mdd_36 Nombre del establecimiento del comercio. Aplica para delivery de productos/servicios y recoge en el establecimiento. R String (255)
cybersource_mdd_37 Indica si la compra se enviará mediante delivery a la dirección del cliente o será recogida en el local del comercio Delivery / recoge en tienda.

DELIVERY

RECOJO EN TIENDA

 R String (255)
cybersource_mdd_38 Cuenta de destino para la recarga de billeteras de criptomonedas y otros instrumentos financieros. R String (255)
cybersource_mdd_39 Banco al cual pertenece la cuenta de destino.

2 = BCP,

3 = IBK PRIVADA,

5 = IBK,

7 = CITI,

9 = PAS,

10 = LOY,

11 = BBVA,

18 = BN,

23 = COMERCIO,

35 =PICHINCHA,

38 = BIF,

41 = PAS,

43 = LCR,

49 =MI BANCO

 R String (255)
cybersource_mdd_40 Número de placa de auto. R String (255)
cybersource_mdd_41 Indicar si el cliente ha adquirido o está recargando un número PREPAGO o POSTPAGO. Aplica para empresas de telefonía.

PREPAGO

POSTPAGO

 R String (255)
cybersource_mdd_42 Identificador único del usuario final del servicio, de cara al comercio. En el caso de telcos, ese el número de celular a recargar. R String (255)
cybersource_mdd_43 Número telefónico ingresado por el cliente al registrarse en la web/app del comercio. R String (255)
cybersource_mdd_44 Código de Reserva. R String (255)
cybersource_mdd_45 Número de código de fidelidad del viajero frecuente. R String (255)
cybersource_mdd_46 Canal de venta ticket..

OTA

APP

WEB

 R String (255)
cybersource_mdd_47 Round Trip or One Way Trip

OW

RT

 R String (255)
cybersource_mdd_48 Delta entre fecha de salida y fecha de regreso. Solo para vuelos de ida y vuelta (en días). O String (255)
cybersource_mdd_49 Número de adultos viajando. O String (255)
cybersource_mdd_50 Ciudad donde se inicia el viaje comprado por el cliente. R

Código IATA

cybersource_mdd_51 Ciudad donde finaliza el viaje comprado por el cliente. R

Código IATA

cybersource_mdd_52 Compra de millas/km.

SI

NO

 R String (255)
cybersource_mdd_53 Vuelo internacional.

SI

NO

 R String (255)
cybersource_mdd_54 Clase Tarifa. Letra que corresponde a la clase del billete.

Ejm: W, Y, N.

 O String (255)
cybersource_mdd_55 Fecha de inicio del primer vuelo. R DateTime (25)
cybersource_mdd_56 Aeropuerto Origen O

Código IATA

cybersource_mdd_57 Aeropuerto Destino O

Código IATA

effectDate

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

Formato

cancelDate

Fecha de cancelación de la suscripción.

Formato

initialAmount

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

Formato

initialAmountNumber

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

Formato

amount

Monto de los vencimientos de la recurrencia, excepto las posiblemente definidas por.

El valor se expresa en la fracción monetaria más pequeña de la divisa.

Formato

currency

La moneda utilizada para el pago de cuotas de suscripción. Código alfabético un mayúsculas según ISO 4217 alpha-3.

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

Valores posibles

. Los valores posibles son:

Moneda CODIFICACIÓN ISO 4217 Unidad fraccionaria
Sol peruano (604) PEN
Dólar estadounidense (840) USD 2

Formato

pastPaymentsNumber

Número de desembolsos vencidos.

Formato

totalPaymentsNumber

Número total de pagos.

Formato

rrule

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

Por razones técnicas, no es posible definir períodos de suscripción inferiores a un día.
Por lo tanto, las palabras clave "CADA SEGUNDO" / "CADA MINUTO" / "CADA HORARIO" no se tienen en cuenta.

Formato

description

Descripción asociada a la suscripción.

Formato