Preguntas frecuentes


API de Amazon Incentives: Preguntas frecuentes

Especificación técnica de integración: Preguntas frecuentes

La API de Incentives permite a los socios crear y distribuir códigos de reclamación de Cheques regalo de Amazon rápidamente a través de Internet.

Preguntas frecuentes para no desarrolladores

Ver también: Para obtener respuestas más detalladas a las preguntas frecuentes sobre la API de Incentives, consulte las Preguntas frecuentes sobre la API de incentives en la página de registro.

P. ¿Qué es el identificador de socio?

R: El ID de socio es un identificador único que le proporcionamos y que deberá utilizar con la API de Incentives. Lo recibirá como parte de la suscripción.


P. ¿Qué es el autoservicio para la gestión de claves?

R: El autoservicio para la gestión de claves de es una herramienta de autoservicio que le permite generar y administrar tanto la clave de acceso como la clave secreta dentro del portal de la API de Incentives. Para administrar sus claves, abra el portal de la API de Incentives para su mercado nacional. En el portal, haga clic en Credenciales de seguridad de la API. Nota: Solo la cuenta con acceso de administrador puede ver la página de credenciales de seguridad de la API. Escriba a incentives-api@amazon.com para pedirnos que demos acceso de administrador a una cuenta concreta.


P: ¿Cuáles son las pautas para el almacenamiento de códigos de reclamación? ¿Qué información podemos almacenar?

R: Los socios no pueden almacenar códigos de reclamación. Consulte Gestión de los códigos de reclamación de los Cheques regalo.


P: ¿Cuál es el tiempo recomendado para la configuración del tiempo de espera?

R: El tiempo de espera recomendado es de seis segundos para la aplicación del cliente.


P: ¿Hay algún límite de tiempo para cancelar un código después de su creación?

R: No recomendamos cancelar los códigos una vez que se hayan emitido. Sin embargo, si cree que es necesario cancelar un código, la operación de cancelación debe realizarse dentro de los 15 minutos siguientes a la creación.

Preguntas frecuentes para desarrolladores

P. 1 Recibo el error "javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target” cuando ejecuto el código de muestra.

R. 1 Esto podría deberse a que no tiene los certificados de CA "VeriSign Class 3 Public Primary Certificate Authority – G5" o "Verisign Class 3 Secure Server CA – G3" (vea la siguiente captura de pantalla), que es el firmante de la entidad emisora de certificados raíz o intermedia del certificado SSL utilizado en nuestros puntos de conexión, en su almacén de claves de Java.

Resultado:

El certificado debería rellenarse automáticamente al instalar JRE/JDK en el equipo donde está instalado Eclipse (u otro IDE). Puede usar la herramienta de claves de Java incorporada (solo disponible en JDK, no en JRE) para importar el certificado en el almacén de claves de Java o ejecutar el código de muestra desde un equipo diferente con el certificado de firmante de CA raíz o intermedia instalado. La importación del certificado de CA está fuera del ámbito del soporte de AGCOD. Consulte los siguientes enlaces para obtener información adicional. También puede consultar la documentación de Java/Eclipse si necesita ayuda adicional sobre los siguientes métodos.

Método 1: este método puede suponer un reto, pero se ha demostrado que resuelve el problema.

Método 2: este es el método más fácil.

También puede importar el certificado en el almacén de claves de Java mediante una herramienta de claves de llamada de complemento de Eclipse:

Una vez que se haya instalado el complemento, configure la ubicación del almacén de claves (esta puede variar en función del sistema operativo o de la ubicación del almacén de claves). La contraseña predeterminada del almacén de claves es Changeit.


P. 2 Recibo el siguiente error: <Message>The security token included in the request is invalid.</Message>

R. 2 Esto podría deberse a una clave de acceso de seguridad no válida. Verifique que su clave de acceso sea correcta, que sea para el entorno correcto (sandbox o producción) y confirme la configuración regional del punto de conexión que se esté utilizando.


P. 3 Recibo este error: The String-to-Sign should have been 'AWS4-HMAC-SHA256/…./us-east-1/AGCODService/aws4_request…..'

R. 3 Esto podría deberse a una clave de acceso no válida. Verifique que la clave de acceso sea correcta, que sea para el entorno correcto (sandbox o producción) y confirme la configuración regional del punto de conexión que se esté utilizando. Además, asegúrese de poner el calificador de clave "AWS4" como prefijo de la clave secreta cuando genere la clave de firma derivada (kSecret), tal como se especifica en http://docs.aws.amazon.com/general/latest/gr/sigv4-calculate-signature.html.


P. 4 Recibo este error: <Message>Missing Authentication Token</Message>

R. 4 Esto puede deberse a una especificación incorrecta del punto de conexión (por ejemplo, https://agcod-v2.amazon.com en lugar de https://agocd-v2-gamma.amazon.com o el punto de conexión adecuado para su configuración regional). Verifique que el punto de conexión que se está utilizando sea preciso, y corresponda al entorno (sandbox o producción) y a la configuración regional correctos.


P. 5 Recibo este error: Estado HTTP 400: se produjo un error al procesar la solicitud. La solicitud no coincide con ninguno de los protocolos admitidos.

R. 5 A menudo, esto se produce al realizar una solicitud al punto de conexión incorrecto. Compruebe que está utilizando el punto de conexión correcto.


P. 6 ¿La API de Incentives admite operaciones HTTP GET?

R. 6 No, solo admite POST.


P. 7 Recibo el error "Request Id Must Start With Partner Name", pero lo he comprobado y tengo el nombre de socio correcto.

A. 7 El identificador de socio distingue entre mayúsculas de minúsculas. Asegúrese de que el punto de conexión o la configuración regional sean correctos (sandbox o producción, y NA o UE).


P. 8 ¿La API de Incentives admite SOAP o Query?

R. 8 No, solo admite solicitudes de RESTful.


P. 9 ¿Qué sucede si no tengo suficientes fondos en la cuenta para cubrir una solicitud?

R. 9 Si no hay fondos suficientes, la operación de la API de Incentives devolverá un error F300 y no activará el cheque regalo. Es importante que haga una previsión precisa de los volúmenes de sus cheques regalo y que mantenga un plan de contingencia para la demanda no anticipada. Trabaje con su administrador de cuenta para determinar el mejor enfoque.


P. 10 Aparece el error "F300 Issuance Cap Exceeded" cuando intento crear un código de reclamación de cheque regalo.

R. 10 Esto puede deberse a que se ha superado el límite de emisiones para los socios de prepago que no sean FPS, si no ha cambiado nada más por parte del socio. Si recibe este error en Producción, es probable que esté relacionado con el exceso de la cantidad de fondos que tiene en su cuenta. Para obtener más información, póngase en contacto con al administrador de cuenta. Si recibe este error en el entorno de sandbox, póngase en contacto con Amazon para obtener más ayuda.


P. 11 Aparece el error "Max Amount Exceeded" cuando intento crear un código de reclamación de cheque regalo

R. 11 Asegúrese de que el importe del cheque regalo que está activando no supere los 2000 $ en EE. UU.de acuerdo con las restricciones impuestas por la legislación (otros países podrían tener unos límites diferentes). Consulte una lista de límites de importes de transacciones en nueve países.


P. 12 Recibo este error: F200 Pre denomination Mismatch (Error de coincidencia de denominación previa F200)

R. 12 Con frecuencia, esto ocurre cuando se realiza una segunda llamada a CreateGiftCard mediante un valor creationRequestId que se utilizó anteriormente en una solicitud a CreateGiftCard que especificaba un valor de importe diferente. Si su solicitud utiliza el mismo creationRequestId y el mismo valor de importe, la llamada informa de una operación positiva y devuelve los resultados devueltos anteriormente por la solicitud original. Esto sucede porque este punto de conexión es "idempotent", por lo que varias llamadas idénticas al punto de conexión son equivalentes a una sola llamada.


P. 13 Recibo muchos errores F500/F200, pero no logro entender cuál es el problema. ¿Qué está pasando?

A. 13 Los errores F500 suelen deberse a errores de tiempo de espera por parte de Amazon. Si ve que esto se produce con regularidad, póngase en contacto con Amazon. Los errores F200 suelen ser el resultado de un envío que contiene información no válida. Si la información enviada se ha verificado, póngase en contacto con Amazon para obtener ayuda.