Skip to main content
Cuando tu integración funcione en el sandbox, revisa esta lista antes de cambiar a producción.

​
Lista de verificación

  1. Emites y recibes el resultado: facturas de los tipos que vas a usar llegan a accepted y manejas rejected mostrando statusMessage.
  2. Idempotencia: guardas la Idempotency-Key con cada documento y la reutilizas en los reintentos. Probaste un timeout: el reintento no duplica el comprobante.
  3. Webhooks: verificas la firma sobre el cuerpo crudo, rechazas entregas de más de 5 minutos, deduplicas por deliveryId y respondes 2xx en menos de 10 segundos.
  4. Errores: distingues los dos 429 (con y sin Retry-After) y reintentas solo lo que se puede reintentar. Ver Errores y límites.
  5. Notas y anulaciones: si las vas a usar, probaste una nota de crédito y una anulación.
  6. Trazabilidad: registras el X-Request-Id de cada respuesta en tus logs (nunca la llave).

​
El cambio

  1. Pide tu llave acpay_live_.... Guárdala en el gestor de secretos de tu servidor de producción, separada de la de pruebas.
  2. Cambia la URL base de https://e-cf.acpay.do/sandbox/v1 a https://e-cf.acpay.do/v1.
  3. Registra en producción las secuencias que te autorizó la DGII (POST /v1/sequences): las del sandbox no se copian. Ver Secuencias de e-NCF.
  4. Registra tus webhooks también en producción: los del sandbox no se copian, y cada uno tiene su propio secret.
Las llaves de prueba no funcionan en producción, ni al revés (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.