Puesta en marcha

1. Generá tus credenciales de QA desde Configuraciones → Integraciones en https://qa.soydrop.com y guardá el secreto en tu gestor.
2. Sincronizá tu reloj por NTP y verificá el desfase contra el serverTime de GET /ping.
3. Llamá GET /ping hasta obtener 200. Si falla acá, el problema es la firma, no el resto del API.
4. Cacheá la geografía: países y departamentos/municipios cambian poco.
5. Recorré el catálogo y guardá los id que vas a usar como catalogId. Ojo con las variantes: el id es el de la variante.
6. Creá una orden de prueba y verificá que un reintento con el mismo externalOrderId devuelve la misma orden y no una nueva.
7. Exponé tu endpoint de webhooks y registrá la URL en la tarjeta «Notificaciones» de esa misma pestaña. Tiene que empezar con https://. Guardala y usá «Enviar evento de prueba» para confirmar que responde. Acordate de descartar el evento con test: true, ver El evento de prueba. Verificá la firma con el «Secret del webhook» que aparece ahí y deduplicá por X-Drop-Event-Id.
8. Programá una reconciliación periódica con GET /orders?updatedSince= para cubrir cualquier webhook perdido.
9. Generá las credenciales de producción desde tu cuenta en https://app.soydrop.com. Son distintas de las de QA.

Antes de salir a producción

• Reintentás los 429 respetando Retry-After
• Reintentás los 5xx con el mismo externalOrderId
• No reintentás 401/403/422
• Guardás el X-Request-Id de cada respuesta en tus logs
• Verificás la firma de todo webhook antes de procesarlo
• Tu endpoint de webhooks responde en menos de 10 segundos
• Tenés una reconciliación periódica con GET /orders?updatedSince=
• Tu cliente ignora campos y estados que no conoce

Soporte

Cuando reportes un problema, incluí el requestId (viaja en el header X-Request-Id y dentro de error.requestId) y la hora aproximada. Con eso ubicamos tu petición exacta.

Si el error es INVALID_SIGNATURE, mandá además la cadena canónica que firmaste, con los saltos de línea visibles. La comparamos contra la nuestra carácter por carácter.