support
Volver a la documentación
Buscar
Categoria
Tags
parámetros principalesdesplegar todo
amount
requerido
currency
requerido
paymentMethodType
requerido
orderId
recomendado
opciones generales de la transacción
ipnTargetUrl
validityPeriod
size
description
metadata
[1]
:
opciones relacionadas con la tarjeta
transactionOptions
paymentMethodOptions
paymentSource
deviceSerialNumber
mid
información sobre tu cliente
customer
reference
recomendado
email
recomendado
billingDetails
title
category
firstName
lastName
phoneNumber
streetNumber
address
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
Pruébame
Documentación

Servicio Web Charge/CreateQRCode

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

POSThttps://api.lyra.com/api-payment/V4/Charge/CreateQRCode

L'opération Charge/CreateQRCode est un Web Service de l'API REST.

Il permet de générer un QR code de paiement.

Consultez le guide d'intégration Payer avec un QR Code.

Parámetros de entrada

amount

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

Ejemplo: 30050 para 300,50 EUR.

Formato

currency

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

Ejemplo: "EUR" para el euro.

Formato

Valores posibles

. Los valores posibles son:

Moneda CODIFICACIÓN ISO 4217 Unidad fraccionaria
Dólar australiano (036) AUD 2
Dólar canadiense (124) CAD 2
Franco suizo (756) CHF 2
Corona danesa (208) DKK 2
Euro (978) EUR 2
Libra esterlina (826) GBP 2
Yen (392) JPY 0
Corona noruega (578) NOK 2
Corona sueca (752) SEK 2
Dólar estadounidense (840) USD 2

orderId

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

Formato

paymentMethodType

Tipo de medio de pago. Ejemplo: PAYCONIQ

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

validityPeriod

Periodo de validez del código QR en segundos.

Formato

size

Tamaño del código QR generado.

Valores posibles

. Los valores posibles son:

STATUS Descripción
S Small, pequeño código QR
M Medium QR mediano, de tamaño mediano
L Large, Código QR grande

Formato

description

Descripción.

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

paymentSource

Camino: transactionOptions.paymentMethodOptions.paymentSource

Origen del pago.

Formato

Valores posibles

. Los valores posibles son:

valores Descripción
EC E-Commerce
INSTORE En stock
APP Aplicación

deviceSerialNumber

Camino: transactionOptions.paymentMethodOptions.deviceSerialNumber

Número de serie del terminal.

Formato

mid

Camino: transactionOptions.paymentMethodOptions.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

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

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
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

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.

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 unidad monetaria más pequeña (el centimo del euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

shippingAmount

Camino: customer.shoppingCart.shippingAmount

Monto de los gastos de entrega para todo el pedido expresado en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

taxAmount

Camino: customer.shoppingCart.taxAmount

Monto de los impuestos para toda la orden expresados en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

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 de ingresos expresados en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

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 Monto de la transacción. Su valor debe ser un entero positivo (por ejemplo: 1234 para 12,34 EUR).
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

Referencia de la respuesta

Respuesta Contexto
QRCodeTransaction Objeto que contiene el código QR de pago.

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