En esta página
Valide antes de enviar
Utilice los límites del OpenAPI sin crear un segundo contrato en su aplicación. En la creación, external_id admite hasta 128 caracteres; Idempotency-Key, hasta 180; metadata, hasta 8 KB. Si se informa, expires_in_minutes varía entre 5 y 129600 minutos. Omitir un campo opcional no equivale a enviar un valor arbitrario.
Consulte países, locales, estados y códigos en la referencia vigente. Por ejemplo, el idioma en del sitio no permite sustituir automáticamente un enum de API por ese valor.
Controle el comportamiento del cliente
Defina timeouts de conexión y respuesta. Limite la concurrencia, supervise su cola y utilice espera progresiva ante fallos transitorios. Corrija errores de autenticación, permisos o payload antes de repetir. Evite consultas continuas sin intervalo para cada transacción.
Esta guía no publica una cuota universal de solicitudes ni un SLA. Confirme con el equipo responsable los límites operativos y comerciales aplicables a su integración.
Reduzca lo que debe proteger
Envíe únicamente los datos necesarios. No utilice metadata como depósito de documentos, secretos o cuerpos personales extensos. Evite registrar las solicitudes completas. Proteja los enlaces de recorrido y archivos descargados como accesos sensibles.
Combine webhooks con conciliación en lugar de depender solo de polling frecuente. Consulte la lista de producción para aplicar estas prácticas a su operación.