Token inválido da 401; scope ausente 403. createInvoice exige amount (>0, 2 decimales) y acepta descripción 1–256, nota 160, payload, expires_in 60–86.400 (1.800 por defecto) y botón pospago. getInvoice busca primero payload; getInvoices devuelve 50/página; cancelInvoice cancela activa (deleteInvoice es alias); getStats consulta períodos.
Idempotency-Key admite 1–128 caracteres A-Z a-z 0-9 -_.:. Replay igual devuelve el original; distinto da 409. Errores: INVALID_AMOUNT, INVALID_PARAMS, ROUTE_NOT_AVAILABLE, INVOICE_NOT_FOUND, INVALID_STATUS. 402 account_not_serviceable usa error, message, billing arriba. Importes son strings; estados active, paid, expired, cancelled.