Enviar feedback o una sugerencia
Crea una Sugerencia desde una integración o agente, sin iniciar una sesión web. Requiere una llave de cuenta con permiso de escritura; no necesita permiso para mover dinero. Las llaves de solo lectura y de organización reciben 403.
La cuenta se determina por la llave y, opcionalmente, X-ACCOUNT-ID para una hija directamente conectada. El contacto asociado es el creador de esa cuenta, no una identidad humana autenticada por el agente. No acepta user_id ni account_id en el cuerpo. En LIVE encola la misma notificación interna de Sugerencias; en Sandbox solo guarda el registro aislado, sin notificar.
Envía category (feature, bug u other) y una description no vacía. La descripción usa el mismo texto enriquecido y sanitización de Sugerencias; la respuesta devuelve texto plano. No incluyas credenciales ni datos de pago sensibles.
Usa Idempotency-Key al reintentar: durante 24 horas, la misma llave y cuerpo devuelven la respuesta original sin crear otra sugerencia. Sin esa cabecera, el texto repetido para la misma cuenta y contacto en cinco minutos recibe 400, incluso si cambias la categoría. Un 201 confirma recepción, no una promesa de implementación. No hay endpoints para listar, editar o borrar feedback.
Authentication
Tu clave secreta de API.
Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.
La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).
Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.
Headers
Clave de idempotencia para reintentos seguros de operaciones críticas, especialmente las que mueven dinero o cambian estado operativo. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original (header Idempotency-Replayed: true); reusarla con parámetros distintos devuelve 409.
Request
Tipo de feedback: feature (función nueva), bug (error) u other (otro comentario).
Qué ocurrió, qué esperabas y los pasos para reproducirlo, o la función que necesitas.
Response
Descripción sanitizada en texto plano.