Códigos de regalo bajo demanda de Amazon Creación web Especificación técnica de integración Agosto de 2018: Esta specificacion no esta actualizada. Utilice los siguientes enlaces para las versiones nuevas (para cado idioma apoyado):  Inglés - https://s3-us-west-2.amazonaws.com/incentives-apisetup/index.html#integrate  Francés - https://s3-us-west-2.amazonaws.com/incentives-apisetup/index-FR.html#integrate  Japonés - https://s3-us-west-2.amazonaws.com/incentives-apisetup/index-JP.html#integrate

Los códigos de regalo bajo demanda de Amazon (AGCOD) son un conjunto de sistemas diseñado para permitir a nuestros clientes crear y distribuir códigos de regalo de Amazon en tiempo real bajo demanda. Entre los ejemplos, se incluyen: los casos de uso aplicables incluyen la inserción de códigos de regalo en tarjetas regalo

electrónicas, reclamo publicitario del grupo, canje en tiempo real de códigos de regalo en programas de fidelidad (p. ej., programas de puntos), etc.

Contenido I.

¿Qué es un código de regalo bajo demanda de Amazon?.................................................................... 4 1.

Resumen ........................................................................................................................................... 4

2.

Público al que va dirigido .................................................................................................................. 4

3.

Descripción general de AGCOD ......................................................................................................... 4

4.

Operaciones de asistencia y ejemplos de solicitudes/respuestas .................................................... 4 (a)

Definiciones............................................................................................................................... 4

5.

Gestión de errores ............................................................................................................................ 9

6.

Firmas digitales – Proceso de firma ................................................................................................ 10

7.

Flujo básico ..................................................................................................................................... 10

8.

Solicitudes y respuestas POST HHTP de muestra ........................................................................... 11

9.

Seguridad ........................................................................................................................................ 11 (a)

Transmisión de datos segura .................................................................................................. 11

(b)

Control de acceso .................................................................................................................... 11

10.

Documentación de referencia relacionada................................................................................. 11

II.

Descripción general del proceso de integración ................................................................................. 12

III.

Registro y configuración única ........................................................................................................ 13

1.

Configuración de cuentas de AWS .................................................................................................. 13

2.

Asignación de identificador de cliente ............................................................................................ 13

3.

Cantidad máxima de la transacción ................................................................................................ 14

4.

Descuentos...................................................................................................................................... 14

IV.

Desarrollo e integración .................................................................................................................. 14

1.

Desarrollo y pruebas en el entorno Sandbox ................................................................................. 14

2.

Activación de producciónn.............................................................................................................. 16 Página 2

V.

Solicitud de asistencia técnica a Amazon (requiere un contrato o acuerdo activo)........................... 16

VI.

Ejemplos de solicitudes/respuestas ................................................................................................ 17

VII.

Historial de revisiones de documentos........................................................................................... 17

Página 3

I.

¿Qué es un código de regalo bajo demanda de Amazon?

1. Resumen Los códigos de regalo (GC) de Amazon pueden adquirirlos clientes de terceros a través de una interfaz de servicios web y pueden distribuirlos después a sus clientes. El producto Códigos de regalo bajo demanda de Amazon (AGCOD) es un sistema de varios componentes que proporciona una forma de adquirir GC en tiempo real. Este documento describe la integración con la API de AGCOD.

2. Público al que va dirigido Este documento va dirigido a desarrolladores y clientes de terceros que firmen un acuerdo contractual con Amazon para adquirir códigos de regalo de Amazon. Este documento da por sentado que se posee un sólido conocimiento de las tecnologías de servicios web (XML, protocolos RESTful, etc.), conceptos de seguridad básicos (cifrado/firmas digitales, etc.) y arquitecturas orientadas a servicios (SOA).

3. Descripción general de AGCOD Los códigos de regalo y tarjetas regalo de Amazon (GC) pueden utilizarse en el sitio web de Amazon como moneda para adquirir productos. La puerta de enlace de AGCOD proporciona una interfaz programática para que los clientes creen GC en tiempo real. Los clientes pueden realizar solicitudes síncronas al extremo de AGCOD y especificar el valor del GC que deseen crear. La API de AGCOD responde con un estado que indica si la operación se ha realizado correctamente o no, y con un código promocional, si todo estuviera correcto, que los clientes pueden distribuir a sus clientes de la forma que Amazon haya autorizado. La financiación de las tarjetas se realiza a través de la cuenta de pago del cliente o por transferencia a la cuenta bancaria de Amazon. Para más información, consulta al Apéndice 1, “Arquitectura de servicio de puerta de enlace de AGCOD de alto nivel”, en el Apéndice de preguntas frecuentes.

4. Operaciones de asistencia y ejemplos de solicitudes/respuestas La puerta de enlace de AGCOD gestiona solicitudes en tiempo real de clientes para crear o cancelar códigos de regalo. Se trata de un servicio web al que se puede acceder públicamente y que respalda las solicitudes RESTful a través de HTTPS.

(a) Definiciones 1. partnerId: identificador exclusivo (distingue entre mayúsculas y minúsculas, 1a letra en mayúscula y las cuatro siguientes en minúscula) suministrado por el equipo de GC de Amazon. Este valor forma parte de la carga de toda solicitud a un puerta de enlace de AGCOD. 2. creationRequestId: identificador exclusivo para todas las llamadas de CreateGiftCard que da como resultado la creación de un GC. El cliente debe generar un nuevo valor para cada solicitud de Página 4

creación (excepto para los reintentos). Para conservarlo como un identificador de transacción globalmente exclusivo, el cliente tiene que:  

Generar un valor alfanumérico que sea exclusivo en los sistemas del cliente. El identificador puede tener un máximo de 19 caracteres alfanuméricos El identificador de la solicitud de creación debe comenzar con el identificador de cliente

Por ejemplo: si el identificador de cliente es Amzn1, tu creationRequestId debe comenzar por Amzn1 y los demás caracteres adicionales que desees incluir en tu identificador (ejemplo: Amzn154321). Puesto que la API es idempotente, si se envía una solicitud con un creationRequestId que se haya utilizado previamente, la puerta de enlace de AGCOD volverá al estado original que se creó la primera vez que se utilizó el creationRequestId. 3. CreateGiftCardResponse/CancelGiftCardResponse: la puerta de enlace de AGCOD generará una respuesta de estado en cada llamada de creación o cancelación correcta asociada con el GC. 4. Transaction: una transacción es una respuesta a una solicitud que provoca la creación o cancelación de un GC en los sistemas de Amazon.

(i) CreateGiftCard El cliente envía un creationRequestId que identifica de forma exclusiva la solicitud de creación, junto con otros datos como el importe, la moneda, etc. (además de los metadatos de la solicitud, la información de autenticación, etc.). Para más información, consulta el Apéndice 2, “Esquemas de mensajes del servicio de puerta de enlace de AGCOD”, que se encuentra en el Apéndice de preguntas frecuentes. Para realizar esta operación, deben seguirse los pasos siguientes: 1. El cliente envía un mensaje CreateGiftCardRequest a la puerta de enlace de AGCOD 2. Amazon confirma si hay suficientes fondos para la solicitud mediante la comprobación de la cuenta de prepago 3. Amazon deduce el importe del pedido y responde con un mensaje CreateGiftCardResponse síncrono que contiene el código promocional de GC activo, la fecha de caducidad (no aplicable en EE. UU.) junto con el gcId. Es necesario que el cliente guarde el creationRequestId, el gcId, el importe y el código de divisa para futuras comunicaciones y resolución de problemas. Mensaje de muestra: POST /CreateGiftCard HTTP/1.1

Página 5

accept:application/x-www-form-urlencoded; charset=UTF-8 content-type:application/x-www-form-urlencoded; charset=UTF-8 host:agcod-v2-eu-gamma.amazon.com x-amz-date:20130910T221949Z x-amz-target:com.amazonaws.agcod.AGCODService.CreateGiftCard Authorization:AWS4-HMAC-SHA256 Credential=AKIAJBYCL67O6NJUNYBQ/20130910/useast-1/AGCODService/aws4_request, SignedHeaders=accept;content-type;host;xamz-date;x-amz-target, Signature=6dce900ea3557473ee750dfe11489dc667366ffc8823541fadf13934e5d64790 AwssbTSpecTest001AwssbEUR 1.00 RESPUESTA:

W3GU-YD4NGH-88C8 EUR 1.0 Fulfilled A3B6AC387ESRIX AwssbTSpecTest001 Mon Jun 09 21:59:59 UTC 2025 SUCCESS

Esta operación es idempotente, en el sentido de que si la puerta de enlace de AGCOD recibe más de una de estas solicitudes con el mismo creationRequestId, entonces la primera solicitud causará la creación de un nuevo GC, mientras que todas las respuestas posteriores devolverán el GC creado originalmente. No se tratarán como una transacción diferente. Observa que una invocación de la llamada CreateGiftCard da como resultado la creación de un solo GC (no se permite la creación masiva en estos momentos). Opcional - atributo de referencia externa Nuestros clientes pueden utilizar el campo Referencia Externa para enviar su propia referencia como una cadena de caracteres al realizar ordenes de cheques de regalo (hasta 100 caracteres, compatible con Unicode). El campo Referencia externa se puede utilizar para almacenar un mapeo adecuado con el fin de seguir: reclamaciones de seguros, distribuidores, casos de clientes, ID de pedidos, cuentas de clientes, referencia de órdenes, etc. Únicamente códigos y números de serie son permitidos este campo. El identificador indicado será incluido en el portal de pago. El siguiente mensaje muestra las modificaciones necesarias para incluir el campo Referencia Externa. Página 6

Mensaje de muestra: POST /CreateGiftCard HTTP/1.1 accept:application/x-www-form-urlencoded; charset=UTF-8 content-type:application/x-www-form-urlencoded; charset=UTF-8 host:agcod-v2-eu-gamma.amazon.com x-amz-date:20130910T221949Z x-amz-target:com.amazonaws.agcod.AGCODService.CreateGiftCard Authorization:AWS4-HMAC-SHA256 Credential=AKIAJBYCL67O6NJUNYBQ/20130910/useast-1/AGCODService/aws4_request, SignedHeaders=accept;content-type;host;xamz-date;x-amz-target, Signature=6dce900ea3557473ee750dfe11489dc667366ffc8823541fadf13934e5d64790 AwssbTSpecTest001AwssbEUR 1.00889jj14797

(ii) CancelGiftCard El cliente puede cancelar un GC, siempre que dicho GC no haya sido reclamado por un cliente de Amazon. Será necesario el creationRequestId original utilizado para crear el GC y el GCID a partir de la gcCreateResponse correcta para cancelar un GC. Nota: esta operación solo se puede ejecutar dentro de los 15 minutos de la creación de la llamada. Después de 15 minutos ha pasado, el código no se puede cancelar y los cargos serán debitados de su crédito prepago. Para realizar esta operación, el cliente envía una solicitud de CancelGiftCard y la puerta de enlace de AGCOD responde con una CancelGiftCardResponse síncrona. Tanto la operación CreateGiftCard como CancelGiftCard son idempotentes. Si la puerta de enlace de AGCOD recibe más de una de estas solicitudes con el mismo creationRequestId, entonces la primera solicitud causará la creación o cancelación de la solicitud de GC, mientras que todas las respuestas posteriores darán como resultado NO-OP (no se tratarán como una transacción diferente). Mensaje de muestra: POST /CancelGiftCard HTTP/1.1 accept:application/x-www-form-urlencoded; charset=UTF-8 content-type:application/x-www-form-urlencoded; charset=UTF-8 host:agcod-v2-eu-gamma.amazon.com x-amz-date:20130910T222449Z x-amz-target:com.amazonaws.agcod.AGCODService.CancelGiftCard Authorization:AWS4-HMAC-SHA256 Credential=AKIAJBYCL67O6NJUNYBQ/20130910/useast-1/AGCODService/aws4_request, SignedHeaders=accept;content-type;host;xamz-date;x-amz-target, Signature=0bef87e8b01aec57fca532e79a5819fcc55d3c02cfafcdf08495ed4a26d0cd87

Página 7

AwssbTSpecTest001AwssbA3B6AC387ESRIX RESPUESTA:

AwssbTSpecTest001 SUCCESS A2GCN9BRX5QS76

(iii) GetAvailableFunds Esta operación devuelve la cantidad de fondos disponibles en tu Cuenta de Amazon Incentives. Provee una alternativa al acceso online a nuestro portal para ver los fondos disponibles. Un posible uso de esta operación es desarrollar un sistema de alertas personalizado o verificar el saldo de una cuenta periódicamente. Nota: Este tipo de petición se limita a 1 transacción por segundo (TPS). Los intentos de enviar solicitudes a mayor velocidad serán ignorados por nuestros sistemas. Dado que no hay un saldo real en la cuenta de Sandbox, la operación ‘GetAvailableFunds’ siempre regresará un balance en ceros. Mensaje de muestra: SIGNED REQUEST POST /GetAvailableFunds HTTP/1.1 accept:charset=UTF-8 content-type:charset=UTF-8 host:agcod-v2-eu-gamma.amazon.com x-amz-date:20170915T200959Z x-amz-target:com.amazonaws.agcod.AGCODService.GetAvailableFunds Authorization:AWS4-HMAC-SHA256 Credential=AKIAI9ZN2Z6XI463M2SA/20170915/euwest1/AGCODService/aws4_request, SignedHeaders=accept;content-type;host;x-amzdate;x -amz-target, Signature=78e0971a383cdfb0cc287c277984498e7e147ff759c4a359eb632074d39b3e55 Aptuk RESPUESTA:

GBP 10.0 20170915T200959Z SUCCESS

Página 8

(iv) GetGiftCardActivityPage El cliente puede recuperar una lista de transacciones (hasta 1.000 por llamada) para un determinado plazo. La llamada API limita el plazo a únicamente las transacciones de devolución que tengan una antigüedad de al menos 30 minutos o más (hasta 90 días). Por ejemplo, el cliente podría recuperar la actividad de las transacciones desde el 1/1/2015 12:30 el 4/1/2015 12:30 si la hora actual es 4/1/2015 13:00. La API GetGiftCardActivityPage no debería superar el umbral de 1 llamada por minuto (es decir, no se debería llamar a la API más de una vez por minuto; una solicitud de reintento consecutiva debido al tiempo de espera, por ejemplo, es aceptable). Esta operación puede bloquearse por cliente si se supera el umbral anterior (se inunda el sistema de solicitudes sucesivas que causan una denegación de servicio) de forma que afecte a la disponibilidad del sistema para otras llamadas de operaciones. El indicador “showNoOps” se muestra si los resultados devueltos incluyen operaciones idempotentes. Consulta el Apéndice 4, “Código de muestra y solicitudes y respuestas de ejemplo”, en el Apéndice de preguntas frecuentes para obtener más información y ejemplos de solicitudes, incluidas firmas digitales. Los ejemplos anteriores se han creado utilizando el código de muestra proporcionado en el apéndice.

5. Gestión de errores Cada respuesta enviada desde la puerta de enlace de AGCOD tiene un elemento de estado asociado que describe el estado de ejecución de la operación determinada; hay tres valores de statusCode: SUCCESS/FAILURE/RESEND.

(i) statusCode: SUCCESS Se devuelve un statusCode de SUCCESS si la operación resulta satisfactoria.

(ii) statusCode: FAILURE Se devuelve un statusCode de FAILURE si la solicitud no puede obtener la puerta de enlace de AGCOD. Esta respuesta de estado puede incluir datos de solicitud no válidos o algún error de lógica de negocio que el cliente debe revisar. En estos casos, el campo errorCode se rellenará y se proporcionarán datos adicionales relativos al error.

(iii) statusCode: RESEND Se devuelve un statusCode de RESEND si hay un fallo del sistema temporal o recuperable que puede solucionar el cliente mediante el reintento de la solicitud. En estos casos, el campo errorCode se rellenará y se proporcionarán datos adicionales relativos al error. El error RESEND no debería interpretarse como un fallo. Simplemente, el estado de la operación no pudo determinarse en el momento del envío. En estos casos, se espera que el cliente reintente la Página 9

solicitud utilizando los mismos datos de entrada que la solicitud original hasta que se obtenga un estado de respuesta definitivo (SUCCESS o FAILURE). Si los mensajes se interrumpen entre servidores causada de problemas de red, puede resultar en un error F400. Un error F400 es un “estado desconocido” y puede generar cargos en su cuenta. Por eso, es importante que su lógica de reintento se repita indefinidamente hasta que se obtenga una respuesta de SUCCESS o FAILURE. El cliente deberá limitar sus solicitudes de reintento para evitar el desbordamiento de la puerta de enlace de AGCOD. Se recomienda un método sencillo como un esquema de reducción exponencial.

(iv) Códigos de error Utilizamos una convención de códigos F2XX para indicar errores cuando la causa proviene del cliente y F1XX si la causa se encuentra en Amazon. Hemos proporcionado identificadores de solicitud de errores simulados para simular determinadas respuestas de error con las llamadas de creación o cancelación. Al simular una respuesta de error, el identificador de solicitud de error simulado deberá traspasarse al campo creationRequestId, similar a un identificador de solicitud normal. Los valores traspasados para el resto de campos simplemente quedarán reflejados en la respuesta. Para simular una respuesta correcta, el valor de F1000 puede traspasarse para el identificador de solicitud de error simulado. Para más información, consulta la sección “Ejemplos de prueba simulados” y el Apéndice 8, “Gestión de errores”, en el Apéndice de preguntas frecuentes.

6. Firmas digitales – Proceso de firma Todas las solicitudes a la puerta de enlace de AGCOD deben incluir una firma digital que utilice los identificadores de acceso y las credenciales de AWS. La puerta de enlace de AGCOD admite el algoritmo de firma Versión 4. Generación de firmas digitales para solicitudes HTTP. Artículos de referencia sobre Firma de solicitudes AWS mediante una firma Versión 4, Ejemplos de solicitudes firmadas con una firma Versión 4 , Ejemplos de derivación de claves de una firma Versión 4, Paquete de prueba, Resolución de problemas con una firma V4 de AWS en la Guía del desarrollador de Amazon AWS disponible públicamente para obtener instrucciones sobre cómo firmar solicitudes API de AWS.

7. Flujo básico Para más información, consulta el Apéndice 3, “Flujo básico para solicitudes de creación/cancelación de tarjetas regalo”, en el Apéndice de preguntas frecuentes. Página 10

8. Solicitudes y respuestas POST HHTP de muestra Para más información, consulta el Apéndice 4, “Código de muestra y solicitudes y respuestas de ejemplo”, en el Apéndice de preguntas frecuentes.

9. Seguridad Los códigos promocionales de GC tienen un valor monetario y deben tratarse de forma muy segura. Se aconseja disponer de controles para garantizar una manipulación segura de los datos confidenciales (códigos promocionales de GC, credenciales de acceso a AWS, etc.). Esto incluye el establecimiento de controles de auditoría adecuados en los sistemas de archivos y bases de datos en los que se almacene información confidencial. Los clientes deberían cambiar periódicamente la contraseña de su cuenta de AWS. El portal de AWS permite a los clientes generar una nueva clave de acceso a AWS en cualquier momento. Sin embargo, AGCOD no admite la rotación automática de claves. Se aconseja a los clientes que NO utilicen esta función para volver a generar la clave de acceso a AWS. Si tienes que cambiar la clave de acceso a AWS, avisa con una semana de antelación como mínimo y coordínalo con tu gestor de cuentas para garantizar una interrupción mínima.   

Deberá mantenerse la confidencialidad de los códigos promocionales durante la transferencia entre Amazon y el cliente Deberá mantenerse la confidencialidad de los códigos promocionales en el sistema del cliente Estas son prácticas de manipulación de datos seguras en las instalaciones del cliente cuando los códigos promocionales están accesibles (durante la transferencia o en un sitio fijo).

Nota: El cliente será responsable de los códigos de reclamación tan pronto como la puerta de enlace de AGCOD responda correctamente a la solicitud CreateGiftCard del cliente.

(a) Transmisión de datos segura La puerta de enlace de AGCOD SÓLO se abre a través de un puerto seguro (HTTPS) y todo el tráfico a través de este canal estará cifrado mediante SSL. Con ello se garantizará la confidencialidad de los datos de GC durante la transferencia. Se requiere que el cliente proporcione sus propios mecanismos seguros dentro de sus sistemas.

(b) Control de acceso La puerta de enlace de AGCOD impone un control de acceso para sus operaciones. Para que un cliente realice solicitudes correctas a la puerta de enlace de AGCOD, tendrá que firmar un acuerdo contractual con el equipo de Tarjetas regalo de Amazon y registrar una cuenta de AWS (consulta la Sección III para obtener más información sobre la configuración de cuentas de AWS).

10.

Documentación de referencia relacionada

Consulta la sección API DynamoDB de Amazon de la Guía del desarrollador de DynamoDB (la puerta de enlace de AGCOD comparte parte del mismo backend que DynamoDB) para obtener más Página 11

información e instrucciones sobre el formato de datos JSON y la creación de solicitudes POST HTTP a DynamoDB de Amazon (que se utilizarán para la puerta de enlace de AGCOD.

II.

Descripción general del proceso de integración

Sigue estos pasos básicos para la integración con la puerta de enlace de AGCOD (puedes encontrar los pasos detallados en: Sección III): Paso 1. Registro de la cuenta, configuración única: crea una cuenta de AWS de Sandbox y de Producción, y proporciona a Amazon algo de información básica (direcciones de correo electrónico) para dichas cuentas. Paso 2. Concesión de acceso a Sandbox: indica al gestor de cuentas las direcciones de correo electrónico que estén asociadas con tus cuentas de AWS para poder obtener acceso a nuestro entorno Sandbox (el acceso a Sandbox debe concederlo Amazon). Amazon te asignará un identificador de cliente de 5 caracteres. Utiliza el formato siguiente como guía para enviar a Amazon la información de cuenta solicitada: Ejemplos Prueba (Sandbox) Dirección de [email protected] correo electrónico de la cuenta de AWS Identificador de Awssb cliente

Producción [email protected]

Awssb

Paso 3. Comienza el desarrollo y prueba la aplicación en el entorno Sandbox con el identificador de cliente y las cuentas de AWS. Paso 4. Certificación: una vez completado el código, informa a tu gestor de cuentas. Comenzarás el proceso de certificación con Amazon para validar que el sistema integrado funcione de la forma esperada en el entorno Sandbox. Paso 5. Activación en Producción: tras una certificación satisfactoria, trabaja con Amazon para activar tu cuenta de AGCOD en el entorno de Producción. Nota: La certificación de AGCOD no incluye la aprobación de la experiencia de usuario de la aplicación ni el uso de la marca Amazon (p. ej., logotipos de Amazon y marcas de Amazon). La obtención de la aprobación de la marca es un proceso independiente. Para más información, consulta el Centro de recursos de uso de la marca para tarjetas regalo corporativas de Amazon en:

Página 12

Plataforma Estados Unidos Canadá Reino Unido Francia Alemania España Italia Japón China

III.

Enlace US CA UK FR DE ES IT JP CH

Registro y configuración única

Para utilizar el sistema AGCOD, debes completar la configuración única.

1. Configuración de cuentas de AWS Los componentes de AGCOD imponen el control de acceso de las solicitudes entrantes que realizan los clientes. Para obtener acceso para realizar solicitudes, sigue estos pasos: i.

Vete a http://aws.amazon.com y haz clic en el botón Crear una cuenta de AWS. Nota: Utiliza una dirección de correo electrónico válida con el dominio de tu empresa, p. ej., @tuempresa.com (No se aceptarán dominios de correo electrónico públicos como @hotmail.com, @yahoo.com, @msn.com, @gmail.com, etc.) al que puedan acceder desarrolladores y operadores, y haz clic en el enlace Crear una cuenta de AWS ahora cuando se te indique durante el proceso de registro. ** La información de la tarjeta de crédito se requiere con fines de verificación de la identidad y no se realizarán cargos si la cuenta de AWS sólo se utiliza para el servicio AGCOD.

ii.

Regístrate para dos cuentas de AWS independientes, una para Sandbox y otra para Producción. Se recomienda configurar direcciones de correo electrónico como “[email protected]” y “[email protected]”.

iii.

Tras crear las cuentas de AWS, inicia sesión en el portal de AWS http://aws.amazon.com con el correo electrónico y la contraseña de la primera cuenta en el enlace Credenciales de seguridad de la parte superior de la pantalla (consulta la captura de pantalla aquí) y comprueba si el identificador de la clave de acceso está en la lista. Si no lo está, haz clic en el enlace Crear una nueva clave de acceso para generar una nueva (AGCOD no admite IAM en este punto. No crees una clave de acceso a AWS mediante la opción Gestión de accesos e identidades). Nota: Asegúrate de cerrar sesión de la 1a cuenta, cerrar el navegador e iniciar sesión en http://aws.amazon.com con la dirección de correo electrónico y la contraseña de la 2a cuenta.

2. Asignación de identificador de cliente Tu gestor de cuentas te proporcionará un identificador de cliente exclusivo de cinco caracteres (con distinción entre mayúsculas y minúsculas). Este identificador deberá utilizarse en todas las solicitudes al servicio AGCOD. Si no has recibido el identificador de cliente, consulta a tu gestor de cuentas. Página 13

3. Cantidad máxima de la transacción

4. Descuentos Tu descuento (si es aplicable) lo encontrarás en el acuerdo legal que tengas con Amazon. Si no participas en la negociación del contrato, puedes consultar a tu equipo financiero o al gestor de cuentas para obtener más información con relación a este descuento. Durante el desarrollo y las pruebas, esta información te permitirá verificar que se te cobran y se te reembolsan los importes apropiados a la hora de crear o cancelar códigos de regalo.

IV.

Desarrollo e integración

1. Desarrollo y pruebas en el entorno Sandbox (i) Acceso a Sandbox Utiliza el entorno Sandbox para realizar pruebas de desarrollo e integración. Para más información, consulta el Apéndice 6 para obtener una lista de los extremos de Sandbox y Producción, que encontrarás en el Apéndice de preguntas frecuentes. Nota: El acceso a Sandbox se concede una vez que informes a tu gestor de cuentas de que se han configurado las cuentas de Sandbox y Producción de AWS.

(ii) Desarrollo y pruebas Cuando se le haya concedido el acceso a Sandbox, el cliente podrá comenzar con el desarrollo de códigos y las pruebas. Proporcionamos códigos de muestra totalmente operativos en C#, Java, Python, JavaScript, Ruby y PHP. Para más información, consulta el Apéndice 4 en el Apéndice de preguntas frecuentes. La API de AGCOD se puede probar con la siguiente página de Internet totalmente operativa con las credenciales de AWS y el identificador de cliente asignado sin ningún trabajo de desarrollo o codificación.

Página 14

https://s3.amazonaws.com/AGCOD/htmlSDKv2/htmlSDKv2_NAEUFE/index.html

Tras finalizar el desarrollo de códigos y las pruebas, el cliente procederá con la fase de certificación. En este punto, el cliente deberá poder responder “SÍ” a las siguientes preguntas: 1. ¿Estás seguro de haber seguido fielmente las especificaciones de Amazon y de que no tienes preguntas sobre las especificaciones que piensas plantear durante la certificación? 2. ¿Has implementado todas las API de puerta de enlace de AGCOD aplicables (CreateGiftCard, CancelGiftCard) en su totalidad? 3. ¿Se ha probado tu código de forma exhaustiva? El proceso de control de calidad deberá incluir una buena combinación de pruebas de unidades de desarrollador y pruebas de integración de control de calidad (internas). 4. ¿Estás seguro de que el proceso de certificación tendrá lugar de forma fluida sin otros errores y cambios de códigos? 5. ¿Vas a realizar la certificación en producción/software cercano a la producción/sistemas con una mínima intervención manual? 6. ¿Conoces el descuento que recibes en los códigos de regalo? 7. ¿Estás seguro de que cuentas con los procesos internos para garantizar que la cuenta disponga de fondos suficientes para respaldar las compras con tarjeta regalo? Si no estás totalmente seguro de poder contestar “SÍ” a alguna de las preguntas, contacta con [email protected].

(iii) Certificación en Sandbox Una vez que el cliente haya confirmado que los códigos están completos y que haya probado internamente y de forma exhaustiva su aplicación, Amazon iniciará el proceso de certificación. Amazon Página 15

proporcionará un documento de certificación con casos que se ejecutarán en el entorno Sandbox para validar que el sistema del cliente se ha implementado de acuerdo con las especificaciones necesarias.

2. Activación de producciónn Tras una certificación correcta en Sandbox, el cliente obtendrá acceso al extremo de producción durante la llamada de activación de producción con Amazon. Durante esta llamada, analizaremos algunos casos de pruebas de producción para garantizar una activación correcta. Tras superar correctamente los casos de prueba, el cliente estará listo para la producción y para la activación correcta.

V. Solicitud de asistencia técnica a Amazon (requiere un contrato o acuerdo activo) A través del proceso de desarrollo e integración, las preguntas técnicas pueden dirigirse a [email protected]. Consulta el Apéndice de preguntas frecuentes para obtener casos de uso útiles y la resolución de problemas habituales. Ten en cuenta que si no dispones de un acuerdo activo y no se te ha proporcionado acceso a Sandbox, es probable que los desarrolladores que supervisan este alias no te reconozcan. Es importante que trabajes con tu gestor de cuentas para seguir los pasos necesarios para obtener acceso a Sandbox. Es importante, además, que incluyas tu identificador de cliente en las comunicaciones con nuestros desarrolladores para garantizar que puedan identificar tu cuenta fácilmente. En tus comunicaciones, indica la mayor cantidad de información posible (cuando corresponda)          

Par de solicitud/respuesta completo de tu llamada a la API de AGCOD URL completa de extremo utilizada (incluida la URL del servidor) para realizar la solicitud El parámetro StringToSign utilizado en la solicitud, si no se encuentra en la solicitud/respuesta anterior La firma correspondiente del parámetro StringToSign, si no se encuentra en la solicitud/respuesta anterior Tiempo aproximado (con zona horaria) empleado en la solicitud (la zona horaria configurada en el equipo en el que se realiza la solicitud anterior) Lenguaje de programación utilizado Cualquier cambio reciente (tanto de programación como de infraestructura) en tu extremo Captura de pantalla del error N.º de teléfono y correo electrónico de contacto técnico del cliente Zona horaria del cliente

Página 16

VI.

Ejemplos de solicitudes/respuestas

Consulta el Apéndice 4, “Código de muestra y solicitudes y respuestas de ejemplo”, en el Apéndice de preguntas frecuentes para obtener solicitudes de ejemplo, incluidas firmas digitales. Los ejemplos se han creado utilizando el código de muestra proporcionado en el apéndice.

VII. Historial de revisiones de documentos Fecha

Versión

Modificaciones

2-23-15

1.01

Crear documento

6-11-15

1.02

Modificaciones menores

6-10-16

1.03

Atributo de referencia externa

9-11-17

1.04

Add external reference

9-18-17

1,05

Add balance inquiry

11-20-17

1.06

Add 15 minute cancel rule

Página 17