support
Volver a la documentación
Buscar
Categoria
Tags
parámetros principalesdesplegar todo
paymentMethodToken
requerido
paymentForms
[1]
paymentMethodType
requerido
pan
Tarjetas de Prueba

    Token de formulario no definido

    Número de tarjetaDescripciónEstado3DS3DS2
    requerido
    expiryMonth
    requerido
    expiryYear
    requerido
    securityCode
    brand
    cardHolderName
    identityDocumentNumber
    identityDocumentType
    currency
    requerido
    orderId
    recomendado
    información sobre tu cliente
    customer
    reference
    recomendado
    email
    requerido
    billingDetails
    title
    category
    firstName
    lastName
    phoneNumber
    streetNumber
    address
    address2
    district
    zipCode
    city
    state
    country
    language
    cellPhoneNumber
    identityCode
    identityType
    legalName
    shippingDetails
    category
    firstName
    lastName
    phoneNumber
    streetNumber
    address
    address2
    district
    zipCode
    city
    state
    country
    deliveryCompanyName
    shippingSpeed
    shippingMethod
    legalName
    identityCode
    shoppingCart
    insuranceAmount
    shippingAmount
    taxAmount
    cartItemInfo
    [1]
    productLabel
    productType
    productRef
    productQty
    productAmount
    productVat
    ipAddress
    opciones generales de la transacción
    contrib
    ipnTargetUrl
    fingerPrintId
    opciones relacionadas con la tarjeta
    transactionOptions
    cardOptions
    paymentSource
    mid
    retry
    Pruébame
    Documentación

    Token/Update (PCI)

    L'appel aux Web Services requiert une authentification HTTP Basic Authentication. Plus d'infos : "Phase d'authentification".

    POSThttps://api.micuentaweb.pe/api-payment/V4/Token/Update

    La activación de esta funcionalidad está sujeta a la aprobación previa de Izipay.

    La operación Token/Update es un Web Servicede la API REST. Permite actualizar la tarjeta asociada a un token existente (paymentMethodToken).

    En el modo PCI DSS, puede ingresar la información de la tarjeta directamente en el Web Service.

    Se crea una transacción de cero euros al mismo tiempo que el token.

    Para el uso no PCI con el formulario incrustado, consulte: Token/Update (no PCI).

    Parámetros de entrada

    contrib

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

    Formato

    paymentMethodToken

    Token asociado a un medio de pago.

    Formato

    currency

    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:

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

    ipAddress

    Dirección IP del comprador.

    Formato

    ipnTargetUrl

    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

    orderId

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

    Formato

    fingerPrintId

    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

    customer.reference

    Identificador del comprador en el sitio web comercial.

    Formato

    customer.email

    E-mail del comprador.

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

    Formato

    customer.ipAddress

    Dirección IP del comprador.

    Formato

    address

    Camino: customer.billingDetails.address

    Dirección de facturación.

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

    Formato

    address2

    Camino: customer.billingDetails.address2

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

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

    Formato

    category

    Camino: customer.billingDetails.category

    Tipo de cliente.

    Formato

    Valores posibles

    Valores Descripción
    PRIVATE Cliente de tipo Particular
    COMPANY Cliente de tipo Empresa

    cellPhoneNumber

    Camino: customer.billingDetails.cellPhoneNumber

    Teléfono móvil del comprador.

    Acepta todos los formatos:

    Ejemplos:

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

    Según el medio de pago, algunas restricciones pueden modificar el formato. Para más información, consulte la documentación técnica específica del medio de pago.

    Formato

    city

    Camino: customer.billingDetails.city

    Ciudad de facturación.

    Formato

    country

    Camino: customer.billingDetails.country

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

    Formato

    Valores posibles

    Ejemplos de valores posibles:

    País Código
    Argentina AR
    Brasil BR
    Colombia CO
    COSTA RICA CR
    ECUADOR EC
    GUATEMALA GT
    MÉXICO MX
    NICARAGUA NI
    PERÚ PE
    SALVADOR SV
    ESTADOS UNIDOS DE AMÉRICA US
    URUGUAY UY

    district

    Camino: customer.billingDetails.district

    Barrio de la dirección de facturación.

    Formato

    firstName

    Camino: customer.billingDetails.firstName

    Nombre del comprador.

    Formato

    identityCode

    Camino: customer.billingDetails.identityCode

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

    Formato

    identityType

    Camino: customer.billingDetails.identityType

    Tipo del documento de identidad.

    Valores posibles:

    País TIPO DESCRIPCIÓN
    ARGENTINA DNI Documento Nacional de Identidad
    BRASIL CNPJ Cadastro Nacional da Pessoa Jurídica
    CPF Cadastro de Pessoas Físicas
    COLOMBIA CC Cédula de ciudadania
    TI Tarjeta de Identidad
    CE Cédula de Extranjeria
    NI Número de Identificación Tributaria
    PS Pasaporte
    Peru DNI_PER Documento National de Identidad
    por Partida de Nacimiento
    No Pasaporte
    LMI Libreta Militar
    NAN Otro

    Formato

    language

    Camino: customer.billingDetails.language

    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:

    Idioma Código
    Alemán (Alemania) DE
    Inglés (Reino Unido) EN
    Inglés (Estados Unidos) EN
    Chino (tradicional) ZH
    Español (España) ES
    Español (Chile) ES
    Francés (Francia) FR
    Italiano (Italia) IT
    Japonés (Japón) JP
    Holandés (Países Bajos) NL
    Polaco (Polonia) PL
    Portugués (Brasil) PT
    Portugués (Portugal) PT
    Ruso (Rusia) RU

    lastName

    Camino: customer.billingDetails.lastName

    Nombre del comprador.

    Formato

    legalName

    Camino: customer.billingDetails.legalName

    Razón social.

    Formato

    phoneNumber

    Camino: customer.billingDetails.phoneNumber

    Número de teléfono del comprador.

    Acepta todos los formatos:

    Ejemplos:

    • 0123456789
    • +33123456789
    • 0033123456789
    • (00.571) 638.14.00
    • 40 41 42 42

    Según el medio de pago, algunas restricciones pueden modificar el formato. Para más información, consulte la documentación técnica específica del medio de pago.

    Formato

    state

    Camino: customer.billingDetails.state

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

    Formato

    streetNumber

    Camino: customer.billingDetails.streetNumber

    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

    title

    Camino: customer.billingDetails.title

    Tratamiento del comprador.

    Ejemplos:

    • Sr.
    • Sr.
    • Sra.

    Formato

    zipCode

    Camino: customer.billingDetails.zipCode

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

    Formato

    address

    Camino: customer.shippingDetails.address

    Dirección de entrega.

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

    Formato

    address2

    Camino: customer.shippingDetails.address2

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

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

    Formato

    category

    Camino: customer.shippingDetails.category

    Tipo de cliente.

    Formato

    Valores posibles

    Valores Descripción
    PRIVATE Cliente de tipo Particular
    COMPANY Cliente de tipo Empresa

    city

    Camino: customer.shippingDetails.city

    Ciudad de entrega.

    Formato

    country

    Camino: customer.shippingDetails.country

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

    Formato

    Valores posibles

    Ejemplos de valores posibles:

    País Código
    AUSTRIA AT
    Brasil BR
    CÓRCEGA FR
    COSTA DE MARFIL CI
    FRANCIA FR
    GUADALUPE GP
    INDIA IN
    MARTINICA MQ
    NUEVA CALEDONIA NC
    SAN PEDRO Y MIQUELÓN PM
    POLINESIA FRANCESA PF

    deliveryCompanyName

    Camino: customer.shippingDetails.deliveryCompanyName

    Nombre de la empresa emisora del producto.

    Formato

    district

    Camino: customer.shippingDetails.district

    Barrio de la dirección de facturación.

    Formato

    firstName

    Camino: customer.shippingDetails.firstName

    Nombre del destinatario.

    Formato

    identityCode

    Camino: customer.shippingDetails.identityCode

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

    Formato

    lastName

    Camino: customer.shippingDetails.lastName

    Nombre del comprador.

    Formato

    legalName

    Camino: customer.shippingDetails.legalName

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

    Formato

    phoneNumber

    Camino: customer.shippingDetails.phoneNumber

    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

    shippingMethod

    Camino: customer.shippingDetails.shippingMethod

    Modo de entrega.

    Formato

    Valores posibles

    VALOR Descripción
    RECLAIM_IN_SHOP Retiro en tienda.
    RELAY_POINT Uso de una red de puntos de retiro de terceros (Kiala, Alveol, etc.).
    RECLAIM_IN_STATION Retiro en un aeropuerto, una estación o una agencia de viajes.
    PACKAGE_DELIVERY_COMPANY Entrega por transportista (Colissimo, UPS, etc.).
    ETICKET Emisión de un ticket electrónico, descarga de producto virtual.
    CARD_HOLDER_ADDRESS Entrega al comprador. Reservado para su uso futuro.
    VERIFIED_ADDRESS Entrega a una dirección verificada. Reservado para su uso futuro.
    NOT_VERIFIED_ADDRESS Entrega a una dirección no verificada. Reservado para su uso futuro.
    SHIP_TO_STORE Entrega en tienda. Reservado para su uso futuro.
    DIGITAL_GOOD Entrega digital. Reservado para su uso futuro.
    ETRAVEL_OR_ETICKET Boleto electronico. Reservado para su uso futuro.
    OTHER Otros Reservado para su uso futuro.
    PICKUP_POINT Retiro en un punto de relevo. Reservado para su uso futuro.
    AUTOMATED_PICKUP_POINT Recoger en el punto de relevo automático. Reservado para su uso futuro.

    shippingSpeed

    Camino: customer.shippingDetails.shippingSpeed

    Plazo de entrega.

    Formato

    Valores posibles

    Ejemplos de valores posibles:

    VALOR Descripción
    STANDARD Entrega estándar
    EXPRESS Entrega en 24 horas
    PRIORITY Entrega prioritaria (Click & Collect)

    state

    Camino: customer.shippingDetails.state

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

    Formato

    streetNumber

    Camino: customer.shippingDetails.streetNumber

    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

    zipCode

    Camino: customer.shippingDetails.zipCode

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

    Formato

    insuranceAmount

    Camino: customer.shoppingCart.insuranceAmount

    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

    shippingAmount

    Camino: customer.shoppingCart.shippingAmount

    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

    taxAmount

    Camino: customer.shoppingCart.taxAmount

    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

    cartItemInfo

    Camino: customer.shoppingCart.cartItemInfo

    cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.

    Permite describir cada artículo del carrito.

    Formato

    productAmount

    Camino: customer.shoppingCart.cartItemInfo.productAmount

    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

    productLabel

    Camino: customer.shoppingCart.cartItemInfo.productLabel

    Nombre del producto.

    Formato

    productQty

    Camino: customer.shoppingCart.cartItemInfo.productQty

    Cantidad de producto.

    Formato

    productRef

    Camino: customer.shoppingCart.cartItemInfo.productRef

    Referencia del producto.

    Formato

    productType

    Camino: customer.shoppingCart.cartItemInfo.productType

    Tipo de producto.

    Valores posibles

    VALOR Descripción
    FOOD_AND_GROCERY Alimentos y productos comestibles.
    AUTOMOTIVE Automotriz / Motocicleta
    ENTERTAINMENT Entretenimiento / Cultura
    HOME_AND_GARDEN Casa y jardín
    HOME_APPLIANCE Equipo de la casa
    AUCTION_AND_GROUP_BUYING Subastas y compras a granel
    FLOWERS_AND_GIFTS Flores y regalos
    COMPUTER_AND_SOFTWARE Computadoras y software
    HEALTH_AND_BEAUTY Salud y belleza
    SERVICE_FOR_INDIVIDUAL Servicios a domicilio
    SERVICE_FOR_BUSINESS Servicios de negocios
    SPORTS Deportes
    CLOTHING_AND_ACCESSORIES Ropa y accesorios
    TRAVEL Viajes
    HOME_AUDIO_PHOTO_VIDEO Sonido, imagen y video
    TELEPHONY Telefonía

    Formato

    productVat

    Camino: customer.shoppingCart.cartItemInfo.productVat

    Tipo de producto.

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

    Valores posibles

    VALOR Descripción
    Un número entero Montant de la transaction. Sa valeur doit être un entier positif (ex: 1234 pour 12,34 PEN).
    Un número decimal, inferior a 100 Porcentaje aplicado sobre el importe. Ejemplos: 20,0 o 19,6532

    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

    mid

    Camino: transactionOptions.cardOptions.mid

    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

    paymentSource

    Camino: transactionOptions.cardOptions.paymentSource

    Origen del pago.

    Formato

    Valores posibles

    . Los valores posibles son:

    VALOR Descripción
    EC E-Commerce: el comprador ingresa los datos del medio de pago. Este valor permite tener una autentificación fuerte al momento del pago.
    MOTO MAIL OR TELEPHONE ORDER: Ingreso realizado por un operador. Los datos del medio de pago se envían por correo postal o electrónico. Requiere un contrato de tipo VAD.
    CC Call Center: pago realizado a través de un centro de atención telefónico. Requiere un contrato de tipo VAD.
    OTHER Otro canal de venta. Valor de salida devuelto para los pagos realizados desde el Back Office Vendedor, los pagos por archivo, los pagos recurrentes, los pagos de proximidad.
    Absent ou null El valor predeterminado es “EC”.

    retry

    Camino: transactionOptions.cardOptions.retry

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

    Formato

    Referencia de la respuesta

    Existen varias respuestas posibles dependiendo del contexto:

    Respuesta Contexto
    Payment Objeto que contiene la transacción generada. Este objeto se devuelve directamente cuando se paga con un simple token.

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