Web ServiceToken/Update

Le Web Service REST Token/Update permet de mettre à jour la carte rattachée à un alias (paymentMethodToken).

Mettez à jour un alias en affichant un formulaire de paiement grâce au formToken (Etape 3 : Créer un formToken).

Consultez les paramètres de la réponse Token.

Parámetros de entrada

Token asociado a un medio de pago.

Formato

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

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

Formato

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 IP del comprador.

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

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

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:

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

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.

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:

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

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

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

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:

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

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

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.

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)

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

Ejemplo: 30050 para 300,50 EUR.

Formato

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

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

cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.

Permite describir cada artículo del carrito.

Formato

Cantidad de ingresos expresados en su unidad monetaria más pequeña (el centimo para el euro).

Ejemplo: 30050 para 300,50 EUR.

Formato

Nombre del producto.

Formato

Cantidad de producto.

Formato

Referencia del producto.

Formato

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

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

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

Formato

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

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

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.

Formato

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 y los reembolsos desde el CMS de Shopify.
Absent ou null	El valor predeterminado es “EC”.

Cantidad de nuevos intentos disponibles en caso de rechazo del pago (1 por defecto).

Formato

formTokenVersion define la versión del formToken enviada por el Web Service.

Este parámetro se utiliza en el marco del SDK móvil. Permite asegurarse de que la versión del formToken devuelta está siempre sincronizada con la aplicación móvil implementada en el teléfono del comprador.

El valor por defecto es 4.

Formato

Referencia de la respuesta

Respuesta	Contexto
Charge/PaymentForm	El objeto contiene un hash para utilizar con el formulario incrustado para crear una nueva transacción.

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