Lista de verificación
- Emites y recibes el resultado: facturas de los tipos que vas a usar llegan a
acceptedy manejasrejectedmostrandostatusMessage. - Idempotencia: guardas la
Idempotency-Keycon cada documento y la reutilizas en los reintentos. Probaste un timeout: el reintento no duplica el comprobante. - Webhooks: verificas la firma sobre el cuerpo crudo, rechazas entregas de más de 5 minutos, deduplicas por
deliveryIdy respondes2xxen menos de 10 segundos. - Errores: distingues los dos
429(con y sinRetry-After) y reintentas solo lo que se puede reintentar. Ver Errores y límites. - Notas y anulaciones: si las vas a usar, probaste una nota de crédito y una anulación.
- Trazabilidad: registras el
X-Request-Idde cada respuesta en tus logs (nunca la llave).
El cambio
- Pide tu llave
acpay_live_.... Guárdala en el gestor de secretos de tu servidor de producción, separada de la de pruebas. - Cambia la URL base de
https://e-cf.acpay.do/sandbox/v1ahttps://e-cf.acpay.do/v1. - Registra tus webhooks también en producción: los del sandbox no se copian, y cada uno tiene su propio
secret.
401). Los documentos del sandbox no tienen validez fiscal y no pasan a producción.
Cuida tu llave
- Solo en tu servidor. Nunca en una aplicación web o móvil, en un repositorio ni en un mensaje.
- Si crees que se expuso, pide revocarla de inmediato y usa una nueva.
- No la pegues en sitios web. El panel de pruebas de este portal solo llama al sandbox: úsalo únicamente con tu llave de prueba.