Referencia de la API

{"enum":["crypto_usdt"]}

{"enum":["deducted"]}

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

{"enum":["crypto_usdt"]}

{"pattern":"^\\d{1,9}(?:\\.\\d{1,2})?$"}

{"enum":["USDT","USDC"]}

{"enum":["polygon","bsc","tron","eth","arbitrum","optimism","base","avalanche","solana"]}

{"enum":["crypto_usdt"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"enum":["USDT","USDC"]}

{"enum":["polygon","bsc","tron","eth","arbitrum","optimism","base","avalanche","solana"]}

{"pattern":"^uq_[a-f0-9]{24}$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"enum":["deducted"]}

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

{"enum":["crypto_usdt"]}

{"pattern":"^uq_[a-f0-9]{24}$"}

{"pattern":"^[a-zA-Z0-9][a-zA-Z0-9_.:-]{7,63}$"}

{"enum":["crypto_usdt"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"enum":["USDT","USDC"]}

{"enum":["polygon","bsc","tron","eth","arbitrum","optimism","base","avalanche","solana"]}

{"pattern":"^uq_[a-f0-9]{24}$"}

{"enum":["reserved","funding","converting","processing","under_review","completed","failed"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"enum":["crypto_usdt"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"enum":["USDT","USDC"]}

{"enum":["polygon","bsc","tron","eth","arbitrum","optimism","base","avalanche","solana"]}

{"pattern":"^uq_[a-f0-9]{24}$"}

{"enum":["reserved","funding","converting","processing","under_review","completed","failed"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

{"enum":["crypto_usdt"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"enum":["USDT","USDC"]}

{"enum":["polygon","bsc","tron","eth","arbitrum","optimism","base","avalanche","solana"]}

{"pattern":"^uq_[a-f0-9]{24}$"}

{"enum":["reserved","funding","converting","processing","under_review","completed","failed"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

{"enum":["crypto_usdt"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"enum":["USDT","USDC"]}

{"enum":["polygon","bsc","tron","eth","arbitrum","optimism","base","avalanche","solana"]}

{"pattern":"^uq_[a-f0-9]{24}$"}

{"enum":["reserved","funding","converting","processing","under_review","completed","failed"]}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

{"pattern":"^\\d+(?:\\.\\d{1,6})?$"}

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

{"maxLength":200}

{"maxLength":120}

{"maxLength":120}

{"maxLength":40}

{"maxLength":1000}

{"enum":["cashin","cashout","cashin_cashout","payout","outro","custody"]}

{"maxLength":60}

{"maxLength":60}

{"maxLength":60}

Fuente declarada por la persona, separada del UTM. Ej.: chatgpt, google, indicacao.

Confirma que la persona facilitó sus datos de contacto para recibir una respuesta a esta solicitud.

{"const":true}

Página o contexto donde se inició la solicitud.

Honeypot: los clientes legítimos deben omitirlo o enviarlo vacío.

{"const":true}

Token opaco de atribución devuelto con consentimiento explícito. Envíalo solo en POST /keys, POST /keys/sandbox o lunium_start_sandbox_demo. Nunca lo incluyas en URLs ni registros.

{"minLength":47,"maxLength":47,"pattern":"^ldt_[A-Za-z0-9_-]{43}$"}

Inicia inmediatamente la integración de autoservicio; el contacto humano es opcional.

{"const":true}

Token opaco de atribución devuelto con consentimiento explícito. Envíalo solo en POST /keys, POST /keys/sandbox o lunium_start_sandbox_demo. Nunca lo incluyas en URLs ni registros.

{"minLength":47,"maxLength":47,"pattern":"^ldt_[A-Za-z0-9_-]{43}$"}

Inicia inmediatamente la integración de autoservicio; el contacto humano es opcional.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Identificador del Banco Central: E + 32 caracteres.

Identificador de extremo a extremo del Banco Central, repetido en la respuesta (letra E + código del comprobante). Cualquier tercero puede volver a validarlo en este mismo endpoint.

ISO 8601 CON offset (hora de Brasilia). Nunca presupongas UTC ni la hora local: el offset es explícito. / (es) ISO 8601 con offset explícito (hora de Brasilia).

Pares disponibles en la vía FAST. El tiempo de depósito/PIX depende de la operación; no es un SLA fijo. Desde el 24/09/2026 incluye DEPIX/liquid, vía de la plataforma: esta fila tiene su propio min, max, tarifa y plazo.

Tokens de baja demanda mediante DEX: chains y nota.

Mediante exchange: una entrada por activo con las redes aceptadas. Incluye solana y tron (06/09/2026) y las redes de dirección compartida (XRP, XLM, ATOM, HBAR, KAVA, HIVE, STEEM, IOST); en ellas, la aceptación devuelve deposit_tag.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Activo vendido. Usa el id EXACTO de GET /catalog (ej.: "usdt"). Combínalo con network: el par (asset, network) debe existir en el catálogo.

Red de entrada de criptomonedas publicada en GET /catalog. No la confundas con las redes de entrega de /cashin/catalog.

Cantidad de cripto en cadena decimal ("50"), nunca float. No la combines con brl_amount ni br_code. Al crear la orden, este modo exige pix_key.

Objetivo en reales brasileños para la cotización inversa, en cadena decimal con hasta 2 decimales ("250.00"). No lo combines con amount ni br_code. Al crear la orden, este modo exige pix_key. La respuesta indica la cantidad exacta de cripto que depositar y el importe efectivo en reales brasileños, que puede diferir del objetivo por redondeo. Muestra los valores devueltos antes de aceptar. Los mínimos y límites dependen de la ruta, la clave y el destinatario; consulta los valores vigentes. (es) Importe BRL objetivo; revisa el BRL efectivo cotizado y la cantidad exacta de depósito de cripto antes de aceptar.

Clave que recibirá los reales brasileños. Formatos aceptados (normalizados por la API al formato exacto del liquidador; fuera de ellos → 400 pix_key_invalida antes de que exista un depósito): CPF 11 dígitos · CNPJ 14 dígitos · teléfono internacional +55DDDNÚMERO (+5548996005588) · correo electrónico · clave aleatoria en UUID (6602ede6-b1a9-4e63-9178-c6883fd0095e). (es) Clave que recibe los reales brasileños. Formatos aceptados: CPF 11 dígitos · CNPJ 14 dígitos · teléfono +55 + prefijo de zona + número · correo electrónico · clave aleatoria como UUID.

Opcional: se deduce del formato de la clave (correo, CNPJ, UUID o teléfono con +55). Solo es obligatorio cuando la clave tiene 11 dígitos puros, donde CPF y teléfono son indistinguibles; en ese caso, la API rechaza con el error tipo_ambiguo en lugar de adivinar.

{"enum":["cpf","cnpj","phone","email","random"]}

Dirección/mint exacto. Necesario para los tokens de /catalog/dex, donde los símbolos se repiten.

Identificador persistente por intención, de hasta 64 caracteres. Repetir el mismo cuerpo reutiliza la orden. Cambiar la red, activo, token, destino, tipo PIX, importe o billetera de retorno genera un conflicto 409; recupera la original antes de decidir una operación nueva. Las órdenes antiguas sin identidad verificable pueden exigir recuperación por cashout_id/external_id.

{"maxLength":64}

Billetera de devolución del cliente, compatible con la red y confirmada por él. No la deduzcas del origen on-chain. Sin billetera, el flujo puede detenerse en AWAITING_REFUND_ADDRESS; consulta refund_asset, refund_network y refund_amount cuando se devuelvan. En la venta de DePix, es opcional desde la 1.44.0 (antes era obligatoria); si se indica, debe ser una dirección Liquid válida (lq1…) del cliente, también en el sandbox.

Copia y Pega de una solicitud de cobro PIX con importe definido, cuando la función esté disponible. USDT/USDC; sustituye a pix_key, amount y brl_amount. Puede devolver 503 br_code_indisponivel en producción. El amount cotizado incluye una reserva fija de R$ 1,00 (reserve_brl; equivalente en USDT en el campo copia_e_cola_buffer_usd) que garantiza el PIX por el importe exacto del QR; el sobrante queda en Lunium como reserva de corrección y no se devuelve. Si el cliente pegó o escaneó un QR con importe —estático o dinámico—, envía br_code completo, nunca pix_key + brl_amount extraídos de él: solo así se envía el PIX por el importe exacto y como pago de esa solicitud de cobro (con el txid). Al pagar por clave, el importe puede variar en centavos y el destinatario no lo reconoce.

{"minLength":40,"maxLength":512}

Solo DePix/Liquid en sandbox. Prevalece sobre los activadores por centavos. Sin escenario explícito, los activadores .01 a .08 siguen activos. Una clave de producción devuelve 403 sandbox_only. Consulta GET /sandbox para ver los escenarios por flujo.

{"enum":["success","delayed","failed","expired","refunded","settlement_uncertain","provider_unavailable","route_unavailable","no_deposit"]}

DePix/Liquid: CPF (11 dígitos) o CNPJ (14 dígitos) del destinatario. Obligatorio para claves PIX email, phone o random. Para claves cpf/cnpj, se usa el documento de la propia clave. Nunca uses documentos sintéticos en producción.

Identificador opaco de la orden. En producción puede ser UUID; en sandbox comienza por sbx_. Consérvalo sin convertirlo.

Estado de la orden. COMPLETED confirma el PIX. Las etapas intermedias varían según la vía. DELAYED pertenece al escenario de sandbox. AWAITING_REFUND_ADDRESS: la orden requiere una devolución y no tiene billetera de retorno; indícala en POST /cash-outs/{cashout_id}/refund-address (venta de cripto y, desde la 1.44.0, venta de DePix). Venta de DePix: QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED; si no se puede pagar el Pix, REFUNDING → REFUNDED, o AWAITING_REFUND_ADDRESS cuando falta la billetera. El DePix ya transferido al proveedor solo se devuelve después de confirmar el retorno: hasta entonces, la orden permanece en MANUAL_REVIEW y la devolución es como máximo lo que regresó.

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

Vía FAST, DEX o CONVERT. Los plazos dependen de la ruta, las confirmaciones y el procesamiento. DePix/Liquid usa depix_liquid.

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

Activo vendido. Usa el id EXACTO de GET /catalog (ej.: "usdt"). Combínalo con network: el par (asset, network) debe existir en el catálogo.

Red blockchain del depósito, tal como aparece en el catálogo (ej.: "polygon"). La dirección de depósito devuelta solo es válida en esta red.

Cantidad de cripto, en cadena decimal. Nunca float.

Importe en reales brasileños (BRL) que recibirá la clave PIX. (es) Reales brasileños que recibirá la clave PIX.

Clave PIX enmascarada del destinatario en la respuesta. La entrada acepta la clave completa; no compares literalmente la respuesta enmascarada con la entrada.

Normalmente, omítelo: el tipo se deduce de la clave para correos electrónicos, CNPJs, claves aleatorias y teléfonos escritos con el código de país +55. Solo es obligatorio cuando la clave contiene 11 dígitos sin formato, porque un CPF y un teléfono tienen la misma longitud y adivinar podría pagar a la persona equivocada. Un tipo explícito siempre prevalece sobre la deducción.

{"enum":["cpf","cnpj","phone","email","random"]}

Adonde el cliente envía la cripto. Solo existe después de accept. En sandbox, DePix es un marcador que no admite pagos SANDBOX:LIQUID:NAO_ENVIAR:...; no envíes monedas.

Memo/tag que debe acompañar al depósito cuando lo devuelve la aceptación. Usa solo las redes presentes en GET /catalog.

Identificador persistente por intención, de hasta 64 caracteres. Repetir el mismo cuerpo reutiliza la orden. Cambiar la red, activo, token, destino, tipo PIX, importe o billetera de retorno genera un conflicto 409; recupera la original antes de decidir una operación nueva. Las órdenes antiguas sin identidad verificable pueden exigir recuperación por cashout_id/external_id.

{"maxLength":64}

Billetera de retorno confirmada por el cliente. Su ausencia no autoriza a usar deposit_from; la orden puede solicitar una dirección en AWAITING_REFUND_ADDRESS. También se aplica a la venta de DePix (dirección Liquid lq1…) desde la 1.44.0.

Hash de la devolución cuando se completa; no implica un importe/plazo fijo de reversión para todos los casos.

Origen on-chain del depósito, solo informativo. Puede ser una billetera compartida de un exchange; nunca lo elijas automáticamente como destino de devolución.

Código Copia y Pega indicado al cotizar (solicitud de cobro), cuando exista. brl_amount es el importe del QR. (es) Cadena de copia y pega indicada al cotizar (solicitud de cobro), si existe. brl_amount es el importe del QR.

Nombre del destinatario leído del QR (solicitud de cobro). (es) Nombre del destinatario leído del QR (solicitud de cobro).

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Instante en que caduca la cotización, ISO 8601 en UTC (ej.: 2026-09-02T14:03:00Z). Las aceptaciones posteriores fallan con erro=cotacao_expirada: vuelve a cotizar en lugar de insistir.

Identificador de extremo a extremo del Banco Central del PIX completado. Cualquiera puede verificarlo en GET /v1/verificar/{e2e}, sin clave. (es) Identificador oficial del PIX en el Banco Central. Es la prueba: entrégala a tu cliente final. En sandbox es ficticio, con ISPB 00000000; no acredita un pago bancario.

Página compartible del comprobante, cuando esté lista. Puede seguir siendo null en el evento cashout.completed; cashout.receipt_ready y la consulta de la misma orden proporcionan el enlace después.

Comprobante como ARCHIVO PDF: adjúntalo a una consulta de soporte, envíalo por WhatsApp y guárdalo para la contabilidad. No depende de que nuestra página esté disponible el día de la comprobación. Incluye nombre, documento fiscal e institución del destinatario, importe, fecha, E2E y enlace de verificación. (es) Comprobante en ARCHIVO PDF. Es lo que se adjunta a una consulta de soporte, se envía por WhatsApp al cliente final y se conserva en la contabilidad; no depende de que la página esté disponible el día de la revisión. Incluye nombre, documento e institución del destinatario, importe, fecha, E2E y enlace de verificación. Se genera a partir de la MISMA fuente de datos de la página: ambos nunca difieren. Es null mientras la orden no haya alcanzado el estado que lo completa. Comprobante oficial: qué contiene y por dónde llega (API, webhook, panel del socio, Telegram): https://docs.luniumpay.com/manual#comprovante

{"nullable":true}

Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin confiar en ti ni en nosotros. Nunca expone la clave PIX, el nombre completo ni el documento fiscal. (es) Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin tener que confiar en ti ni en nosotros. No expone la clave PIX, el nombre completo ni el documento. Es null mientras la orden no haya alcanzado el estado que lo completa.

{"nullable":true}

Línea de tiempo marcada por el SERVIDOR en cada transición (hora del gateway, no de tus consultas periódicas): AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED → (SELLING → SOLD → FORWARDING, solo en el exchange) → PAYING_OUT → COMPLETED. Úsala para el seguimiento del cliente.

Confirmaciones del depósito ya observadas, EN VIVO. Solo aparece mientras la orden se está confirmando y no se guarda: el número cambia con cada bloque. Úsalo con confirmations_required para mostrar el progreso en lugar de un “esperando” sin fin.

Confirmaciones que exige el exchange antes de acreditar el depósito de esta red.

Motivo del fallo cuando se devuelve, también en los escenarios de sandbox.

True para operaciones ficticias de sandbox.

Comisión adicional del socio congelada en esta venta (bps); null en las órdenes anteriores al campo o las ventas DePix.

{"nullable":true}

Parte del socio en centavos, fijada al confirmar el PIX; es el importe acreditado en el libro de comisiones.

{"nullable":true}

true en AWAITING_REFUND_ADDRESS: consulta los datos de la devolución e indica una billetera confirmada por el cliente en POST /cash-outs/{cashout_id}/refund-address.

Cantidad efectiva que se devolverá, cuando esté calculada; no presupongas la cantidad original. Venta de DePix: con todo el DePix en Lunium, refund_amount, refund_asset (DEPIX) y refund_network (liquid) ya se devuelven completados en AWAITING_REFUND_ADDRESS. Si el DePix ya se había transferido al proveedor, estos campos permanecen null en MANUAL_REVIEW hasta confirmar el retorno; después, refund_amount es como máximo lo que regresó (más la parte que no llegó a transferirse, hasta el importe de la orden).

Activo efectivo de la devolución; puede diferir del activo depositado.

Red efectiva de la devolución; usa una billetera compatible confirmada por el cliente.

Referencia de la devolución del socio a Lunium; no es prueba de una reversión al cliente.

Porcentaje de la venta de DePix en puntos básicos.

Parte fija de la venta de DePix, en centavos.

Tarifa total, en centavos; disponible en la cotización DePix y en la orden simulada.

PIX neto, en centavos; disponible en la cotización DePix y en la orden simulada.

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Reserva operativa fija de R$1 en las órdenes nuevas, ya incluida en el total. Las antiguas conservan la reserva original. / Reserva operativa fija de BRL 1 en las órdenes nuevas, ya incluida en el total; las órdenes existentes conservan su reserva original.

Identificador opaco de la orden. En producción puede ser UUID; en sandbox comienza por sbx_. Consérvalo sin convertirlo.

Estado de la orden. COMPLETED confirma el PIX. Las etapas intermedias varían según la vía. DELAYED pertenece al escenario de sandbox. AWAITING_REFUND_ADDRESS: la orden requiere una devolución y no tiene billetera de retorno; indícala en POST /cash-outs/{cashout_id}/refund-address (venta de cripto y, desde la 1.44.0, venta de DePix). Venta de DePix: QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED; si no se puede pagar el Pix, REFUNDING → REFUNDED, o AWAITING_REFUND_ADDRESS cuando falta la billetera. El DePix ya transferido al proveedor solo se devuelve después de confirmar el retorno: hasta entonces, la orden permanece en MANUAL_REVIEW y la devolución es como máximo lo que regresó.

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

Vía FAST, DEX o CONVERT. Los plazos dependen de la ruta, las confirmaciones y el procesamiento. DePix/Liquid usa depix_liquid.

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

Activo vendido. Usa el id EXACTO de GET /catalog (ej.: "usdt"). Combínalo con network: el par (asset, network) debe existir en el catálogo.

Red blockchain del depósito, tal como aparece en el catálogo (ej.: "polygon"). La dirección de depósito devuelta solo es válida en esta red.

Cantidad de cripto, en cadena decimal. Nunca float.

Importe en reales brasileños (BRL) que recibirá la clave PIX. (es) Reales brasileños que recibirá la clave PIX.

Clave PIX enmascarada del destinatario en la respuesta. La entrada acepta la clave completa; no compares literalmente la respuesta enmascarada con la entrada.

Normalmente, omítelo: el tipo se deduce de la clave para correos electrónicos, CNPJs, claves aleatorias y teléfonos escritos con el código de país +55. Solo es obligatorio cuando la clave contiene 11 dígitos sin formato, porque un CPF y un teléfono tienen la misma longitud y adivinar podría pagar a la persona equivocada. Un tipo explícito siempre prevalece sobre la deducción.

{"enum":["cpf","cnpj","phone","email","random"]}

Adonde el cliente envía la cripto. Solo existe después de accept. En sandbox, DePix es un marcador que no admite pagos SANDBOX:LIQUID:NAO_ENVIAR:...; no envíes monedas.

Memo/tag que debe acompañar al depósito cuando lo devuelve la aceptación. Usa solo las redes presentes en GET /catalog.

Identificador persistente por intención, de hasta 64 caracteres. Repetir el mismo cuerpo reutiliza la orden. Cambiar la red, activo, token, destino, tipo PIX, importe o billetera de retorno genera un conflicto 409; recupera la original antes de decidir una operación nueva. Las órdenes antiguas sin identidad verificable pueden exigir recuperación por cashout_id/external_id.

{"maxLength":64}

Billetera de retorno confirmada por el cliente. Su ausencia no autoriza a usar deposit_from; la orden puede solicitar una dirección en AWAITING_REFUND_ADDRESS. También se aplica a la venta de DePix (dirección Liquid lq1…) desde la 1.44.0.

Hash de la devolución cuando se completa; no implica un importe/plazo fijo de reversión para todos los casos.

Origen on-chain del depósito, solo informativo. Puede ser una billetera compartida de un exchange; nunca lo elijas automáticamente como destino de devolución.

Código Copia y Pega indicado al cotizar (solicitud de cobro), cuando exista. brl_amount es el importe del QR. (es) Cadena de copia y pega indicada al cotizar (solicitud de cobro), si existe. brl_amount es el importe del QR.

Nombre del destinatario leído del QR (solicitud de cobro). (es) Nombre del destinatario leído del QR (solicitud de cobro).

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Instante en que caduca la cotización, ISO 8601 en UTC (ej.: 2026-09-02T14:03:00Z). Las aceptaciones posteriores fallan con erro=cotacao_expirada: vuelve a cotizar en lugar de insistir.

Identificador de extremo a extremo del Banco Central del PIX completado. Cualquiera puede verificarlo en GET /v1/verificar/{e2e}, sin clave. (es) Identificador oficial del PIX en el Banco Central. Es la prueba: entrégala a tu cliente final. En sandbox es ficticio, con ISPB 00000000; no acredita un pago bancario.

Página compartible del comprobante, cuando esté lista. Puede seguir siendo null en el evento cashout.completed; cashout.receipt_ready y la consulta de la misma orden proporcionan el enlace después.

Comprobante como ARCHIVO PDF: adjúntalo a una consulta de soporte, envíalo por WhatsApp y guárdalo para la contabilidad. No depende de que nuestra página esté disponible el día de la comprobación. Incluye nombre, documento fiscal e institución del destinatario, importe, fecha, E2E y enlace de verificación. (es) Comprobante en ARCHIVO PDF. Es lo que se adjunta a una consulta de soporte, se envía por WhatsApp al cliente final y se conserva en la contabilidad; no depende de que la página esté disponible el día de la revisión. Incluye nombre, documento e institución del destinatario, importe, fecha, E2E y enlace de verificación. Se genera a partir de la MISMA fuente de datos de la página: ambos nunca difieren. Es null mientras la orden no haya alcanzado el estado que lo completa. Comprobante oficial: qué contiene y por dónde llega (API, webhook, panel del socio, Telegram): https://docs.luniumpay.com/manual#comprovante

{"nullable":true}

Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin confiar en ti ni en nosotros. Nunca expone la clave PIX, el nombre completo ni el documento fiscal. (es) Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin tener que confiar en ti ni en nosotros. No expone la clave PIX, el nombre completo ni el documento. Es null mientras la orden no haya alcanzado el estado que lo completa.

{"nullable":true}

Línea de tiempo marcada por el SERVIDOR en cada transición (hora del gateway, no de tus consultas periódicas): AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED → (SELLING → SOLD → FORWARDING, solo en el exchange) → PAYING_OUT → COMPLETED. Úsala para el seguimiento del cliente.

Confirmaciones del depósito ya observadas, EN VIVO. Solo aparece mientras la orden se está confirmando y no se guarda: el número cambia con cada bloque. Úsalo con confirmations_required para mostrar el progreso en lugar de un “esperando” sin fin.

Confirmaciones que exige el exchange antes de acreditar el depósito de esta red.

Motivo del fallo cuando se devuelve, también en los escenarios de sandbox.

True para operaciones ficticias de sandbox.

Comisión adicional del socio congelada en esta venta (bps); null en las órdenes anteriores al campo o las ventas DePix.

{"nullable":true}

Parte del socio en centavos, fijada al confirmar el PIX; es el importe acreditado en el libro de comisiones.

{"nullable":true}

true en AWAITING_REFUND_ADDRESS: consulta los datos de la devolución e indica una billetera confirmada por el cliente en POST /cash-outs/{cashout_id}/refund-address.

Cantidad efectiva que se devolverá, cuando esté calculada; no presupongas la cantidad original. Venta de DePix: con todo el DePix en Lunium, refund_amount, refund_asset (DEPIX) y refund_network (liquid) ya se devuelven completados en AWAITING_REFUND_ADDRESS. Si el DePix ya se había transferido al proveedor, estos campos permanecen null en MANUAL_REVIEW hasta confirmar el retorno; después, refund_amount es como máximo lo que regresó (más la parte que no llegó a transferirse, hasta el importe de la orden).

Activo efectivo de la devolución; puede diferir del activo depositado.

Red efectiva de la devolución; usa una billetera compatible confirmada por el cliente.

Referencia de la devolución del socio a Lunium; no es prueba de una reversión al cliente.

Porcentaje de la venta de DePix en puntos básicos.

Parte fija de la venta de DePix, en centavos.

Tarifa total, en centavos; disponible en la cotización DePix y en la orden simulada.

PIX neto, en centavos; disponible en la cotización DePix y en la orden simulada.

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Reserva operativa fija de R$1 en las órdenes nuevas, ya incluida en el total. Las antiguas conservan la reserva original. / Reserva operativa fija de BRL 1 en las órdenes nuevas, ya incluida en el total; las órdenes existentes conservan su reserva original.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Recuperación idempotente: devuelve la operación con este external_id (0 o 1). Único por clave y producto, distingue mayúsculas y minúsculas y se conserva de forma permanente.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Identificador opaco de la orden. En producción puede ser UUID; en sandbox comienza por sbx_. Consérvalo sin convertirlo.

Estado de la orden. COMPLETED confirma el PIX. Las etapas intermedias varían según la vía. DELAYED pertenece al escenario de sandbox. AWAITING_REFUND_ADDRESS: la orden requiere una devolución y no tiene billetera de retorno; indícala en POST /cash-outs/{cashout_id}/refund-address (venta de cripto y, desde la 1.44.0, venta de DePix). Venta de DePix: QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED; si no se puede pagar el Pix, REFUNDING → REFUNDED, o AWAITING_REFUND_ADDRESS cuando falta la billetera. El DePix ya transferido al proveedor solo se devuelve después de confirmar el retorno: hasta entonces, la orden permanece en MANUAL_REVIEW y la devolución es como máximo lo que regresó.

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

Vía FAST, DEX o CONVERT. Los plazos dependen de la ruta, las confirmaciones y el procesamiento. DePix/Liquid usa depix_liquid.

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

Activo vendido. Usa el id EXACTO de GET /catalog (ej.: "usdt"). Combínalo con network: el par (asset, network) debe existir en el catálogo.

Red blockchain del depósito, tal como aparece en el catálogo (ej.: "polygon"). La dirección de depósito devuelta solo es válida en esta red.

Cantidad de cripto, en cadena decimal. Nunca float.

Importe en reales brasileños (BRL) que recibirá la clave PIX. (es) Reales brasileños que recibirá la clave PIX.

Clave PIX enmascarada del destinatario en la respuesta. La entrada acepta la clave completa; no compares literalmente la respuesta enmascarada con la entrada.

Normalmente, omítelo: el tipo se deduce de la clave para correos electrónicos, CNPJs, claves aleatorias y teléfonos escritos con el código de país +55. Solo es obligatorio cuando la clave contiene 11 dígitos sin formato, porque un CPF y un teléfono tienen la misma longitud y adivinar podría pagar a la persona equivocada. Un tipo explícito siempre prevalece sobre la deducción.

{"enum":["cpf","cnpj","phone","email","random"]}

Adonde el cliente envía la cripto. Solo existe después de accept. En sandbox, DePix es un marcador que no admite pagos SANDBOX:LIQUID:NAO_ENVIAR:...; no envíes monedas.

Memo/tag que debe acompañar al depósito cuando lo devuelve la aceptación. Usa solo las redes presentes en GET /catalog.

Identificador persistente por intención, de hasta 64 caracteres. Repetir el mismo cuerpo reutiliza la orden. Cambiar la red, activo, token, destino, tipo PIX, importe o billetera de retorno genera un conflicto 409; recupera la original antes de decidir una operación nueva. Las órdenes antiguas sin identidad verificable pueden exigir recuperación por cashout_id/external_id.

{"maxLength":64}

Billetera de retorno confirmada por el cliente. Su ausencia no autoriza a usar deposit_from; la orden puede solicitar una dirección en AWAITING_REFUND_ADDRESS. También se aplica a la venta de DePix (dirección Liquid lq1…) desde la 1.44.0.

Hash de la devolución cuando se completa; no implica un importe/plazo fijo de reversión para todos los casos.

Origen on-chain del depósito, solo informativo. Puede ser una billetera compartida de un exchange; nunca lo elijas automáticamente como destino de devolución.

Código Copia y Pega indicado al cotizar (solicitud de cobro), cuando exista. brl_amount es el importe del QR. (es) Cadena de copia y pega indicada al cotizar (solicitud de cobro), si existe. brl_amount es el importe del QR.

Nombre del destinatario leído del QR (solicitud de cobro). (es) Nombre del destinatario leído del QR (solicitud de cobro).

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Instante en que caduca la cotización, ISO 8601 en UTC (ej.: 2026-09-02T14:03:00Z). Las aceptaciones posteriores fallan con erro=cotacao_expirada: vuelve a cotizar en lugar de insistir.

Identificador de extremo a extremo del Banco Central del PIX completado. Cualquiera puede verificarlo en GET /v1/verificar/{e2e}, sin clave. (es) Identificador oficial del PIX en el Banco Central. Es la prueba: entrégala a tu cliente final. En sandbox es ficticio, con ISPB 00000000; no acredita un pago bancario.

Página compartible del comprobante, cuando esté lista. Puede seguir siendo null en el evento cashout.completed; cashout.receipt_ready y la consulta de la misma orden proporcionan el enlace después.

Comprobante como ARCHIVO PDF: adjúntalo a una consulta de soporte, envíalo por WhatsApp y guárdalo para la contabilidad. No depende de que nuestra página esté disponible el día de la comprobación. Incluye nombre, documento fiscal e institución del destinatario, importe, fecha, E2E y enlace de verificación. (es) Comprobante en ARCHIVO PDF. Es lo que se adjunta a una consulta de soporte, se envía por WhatsApp al cliente final y se conserva en la contabilidad; no depende de que la página esté disponible el día de la revisión. Incluye nombre, documento e institución del destinatario, importe, fecha, E2E y enlace de verificación. Se genera a partir de la MISMA fuente de datos de la página: ambos nunca difieren. Es null mientras la orden no haya alcanzado el estado que lo completa. Comprobante oficial: qué contiene y por dónde llega (API, webhook, panel del socio, Telegram): https://docs.luniumpay.com/manual#comprovante

{"nullable":true}

Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin confiar en ti ni en nosotros. Nunca expone la clave PIX, el nombre completo ni el documento fiscal. (es) Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin tener que confiar en ti ni en nosotros. No expone la clave PIX, el nombre completo ni el documento. Es null mientras la orden no haya alcanzado el estado que lo completa.

{"nullable":true}

Línea de tiempo marcada por el SERVIDOR en cada transición (hora del gateway, no de tus consultas periódicas): AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED → (SELLING → SOLD → FORWARDING, solo en el exchange) → PAYING_OUT → COMPLETED. Úsala para el seguimiento del cliente.

Confirmaciones del depósito ya observadas, EN VIVO. Solo aparece mientras la orden se está confirmando y no se guarda: el número cambia con cada bloque. Úsalo con confirmations_required para mostrar el progreso en lugar de un “esperando” sin fin.

Confirmaciones que exige el exchange antes de acreditar el depósito de esta red.

Motivo del fallo cuando se devuelve, también en los escenarios de sandbox.

True para operaciones ficticias de sandbox.

Comisión adicional del socio congelada en esta venta (bps); null en las órdenes anteriores al campo o las ventas DePix.

{"nullable":true}

Parte del socio en centavos, fijada al confirmar el PIX; es el importe acreditado en el libro de comisiones.

{"nullable":true}

true en AWAITING_REFUND_ADDRESS: consulta los datos de la devolución e indica una billetera confirmada por el cliente en POST /cash-outs/{cashout_id}/refund-address.

Cantidad efectiva que se devolverá, cuando esté calculada; no presupongas la cantidad original. Venta de DePix: con todo el DePix en Lunium, refund_amount, refund_asset (DEPIX) y refund_network (liquid) ya se devuelven completados en AWAITING_REFUND_ADDRESS. Si el DePix ya se había transferido al proveedor, estos campos permanecen null en MANUAL_REVIEW hasta confirmar el retorno; después, refund_amount es como máximo lo que regresó (más la parte que no llegó a transferirse, hasta el importe de la orden).

Activo efectivo de la devolución; puede diferir del activo depositado.

Red efectiva de la devolución; usa una billetera compatible confirmada por el cliente.

Referencia de la devolución del socio a Lunium; no es prueba de una reversión al cliente.

Porcentaje de la venta de DePix en puntos básicos.

Parte fija de la venta de DePix, en centavos.

Tarifa total, en centavos; disponible en la cotización DePix y en la orden simulada.

PIX neto, en centavos; disponible en la cotización DePix y en la orden simulada.

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Reserva operativa fija de R$1 en las órdenes nuevas, ya incluida en el total. Las antiguas conservan la reserva original. / Reserva operativa fija de BRL 1 en las órdenes nuevas, ya incluida en el total; las órdenes existentes conservan su reserva original.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Identificador opaco de la orden. En producción puede ser UUID; en sandbox comienza por sbx_. Consérvalo sin convertirlo.

Estado de la orden. COMPLETED confirma el PIX. Las etapas intermedias varían según la vía. DELAYED pertenece al escenario de sandbox. AWAITING_REFUND_ADDRESS: la orden requiere una devolución y no tiene billetera de retorno; indícala en POST /cash-outs/{cashout_id}/refund-address (venta de cripto y, desde la 1.44.0, venta de DePix). Venta de DePix: QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED; si no se puede pagar el Pix, REFUNDING → REFUNDED, o AWAITING_REFUND_ADDRESS cuando falta la billetera. El DePix ya transferido al proveedor solo se devuelve después de confirmar el retorno: hasta entonces, la orden permanece en MANUAL_REVIEW y la devolución es como máximo lo que regresó.

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

Vía FAST, DEX o CONVERT. Los plazos dependen de la ruta, las confirmaciones y el procesamiento. DePix/Liquid usa depix_liquid.

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

Activo vendido. Usa el id EXACTO de GET /catalog (ej.: "usdt"). Combínalo con network: el par (asset, network) debe existir en el catálogo.

Red blockchain del depósito, tal como aparece en el catálogo (ej.: "polygon"). La dirección de depósito devuelta solo es válida en esta red.

Cantidad de cripto, en cadena decimal. Nunca float.

Importe en reales brasileños (BRL) que recibirá la clave PIX. (es) Reales brasileños que recibirá la clave PIX.

Clave PIX enmascarada del destinatario en la respuesta. La entrada acepta la clave completa; no compares literalmente la respuesta enmascarada con la entrada.

Normalmente, omítelo: el tipo se deduce de la clave para correos electrónicos, CNPJs, claves aleatorias y teléfonos escritos con el código de país +55. Solo es obligatorio cuando la clave contiene 11 dígitos sin formato, porque un CPF y un teléfono tienen la misma longitud y adivinar podría pagar a la persona equivocada. Un tipo explícito siempre prevalece sobre la deducción.

{"enum":["cpf","cnpj","phone","email","random"]}

Adonde el cliente envía la cripto. Solo existe después de accept. En sandbox, DePix es un marcador que no admite pagos SANDBOX:LIQUID:NAO_ENVIAR:...; no envíes monedas.

Memo/tag que debe acompañar al depósito cuando lo devuelve la aceptación. Usa solo las redes presentes en GET /catalog.

Identificador persistente por intención, de hasta 64 caracteres. Repetir el mismo cuerpo reutiliza la orden. Cambiar la red, activo, token, destino, tipo PIX, importe o billetera de retorno genera un conflicto 409; recupera la original antes de decidir una operación nueva. Las órdenes antiguas sin identidad verificable pueden exigir recuperación por cashout_id/external_id.

{"maxLength":64}

Billetera de retorno confirmada por el cliente. Su ausencia no autoriza a usar deposit_from; la orden puede solicitar una dirección en AWAITING_REFUND_ADDRESS. También se aplica a la venta de DePix (dirección Liquid lq1…) desde la 1.44.0.

Hash de la devolución cuando se completa; no implica un importe/plazo fijo de reversión para todos los casos.

Origen on-chain del depósito, solo informativo. Puede ser una billetera compartida de un exchange; nunca lo elijas automáticamente como destino de devolución.

Código Copia y Pega indicado al cotizar (solicitud de cobro), cuando exista. brl_amount es el importe del QR. (es) Cadena de copia y pega indicada al cotizar (solicitud de cobro), si existe. brl_amount es el importe del QR.

Nombre del destinatario leído del QR (solicitud de cobro). (es) Nombre del destinatario leído del QR (solicitud de cobro).

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Instante en que caduca la cotización, ISO 8601 en UTC (ej.: 2026-09-02T14:03:00Z). Las aceptaciones posteriores fallan con erro=cotacao_expirada: vuelve a cotizar en lugar de insistir.

Identificador de extremo a extremo del Banco Central del PIX completado. Cualquiera puede verificarlo en GET /v1/verificar/{e2e}, sin clave. (es) Identificador oficial del PIX en el Banco Central. Es la prueba: entrégala a tu cliente final. En sandbox es ficticio, con ISPB 00000000; no acredita un pago bancario.

Página compartible del comprobante, cuando esté lista. Puede seguir siendo null en el evento cashout.completed; cashout.receipt_ready y la consulta de la misma orden proporcionan el enlace después.

Comprobante como ARCHIVO PDF: adjúntalo a una consulta de soporte, envíalo por WhatsApp y guárdalo para la contabilidad. No depende de que nuestra página esté disponible el día de la comprobación. Incluye nombre, documento fiscal e institución del destinatario, importe, fecha, E2E y enlace de verificación. (es) Comprobante en ARCHIVO PDF. Es lo que se adjunta a una consulta de soporte, se envía por WhatsApp al cliente final y se conserva en la contabilidad; no depende de que la página esté disponible el día de la revisión. Incluye nombre, documento e institución del destinatario, importe, fecha, E2E y enlace de verificación. Se genera a partir de la MISMA fuente de datos de la página: ambos nunca difieren. Es null mientras la orden no haya alcanzado el estado que lo completa. Comprobante oficial: qué contiene y por dónde llega (API, webhook, panel del socio, Telegram): https://docs.luniumpay.com/manual#comprovante

{"nullable":true}

Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin confiar en ti ni en nosotros. Nunca expone la clave PIX, el nombre completo ni el documento fiscal. (es) Enlace directo a la verificación ABIERTA (sin clave). Entrégalo a tu contraparte para que confirme el pago por sí misma, sin tener que confiar en ti ni en nosotros. No expone la clave PIX, el nombre completo ni el documento. Es null mientras la orden no haya alcanzado el estado que lo completa.

{"nullable":true}

Línea de tiempo marcada por el SERVIDOR en cada transición (hora del gateway, no de tus consultas periódicas): AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED → (SELLING → SOLD → FORWARDING, solo en el exchange) → PAYING_OUT → COMPLETED. Úsala para el seguimiento del cliente.

Confirmaciones del depósito ya observadas, EN VIVO. Solo aparece mientras la orden se está confirmando y no se guarda: el número cambia con cada bloque. Úsalo con confirmations_required para mostrar el progreso en lugar de un “esperando” sin fin.

Confirmaciones que exige el exchange antes de acreditar el depósito de esta red.

Motivo del fallo cuando se devuelve, también en los escenarios de sandbox.

True para operaciones ficticias de sandbox.

Comisión adicional del socio congelada en esta venta (bps); null en las órdenes anteriores al campo o las ventas DePix.

{"nullable":true}

Parte del socio en centavos, fijada al confirmar el PIX; es el importe acreditado en el libro de comisiones.

{"nullable":true}

true en AWAITING_REFUND_ADDRESS: consulta los datos de la devolución e indica una billetera confirmada por el cliente en POST /cash-outs/{cashout_id}/refund-address.

Cantidad efectiva que se devolverá, cuando esté calculada; no presupongas la cantidad original. Venta de DePix: con todo el DePix en Lunium, refund_amount, refund_asset (DEPIX) y refund_network (liquid) ya se devuelven completados en AWAITING_REFUND_ADDRESS. Si el DePix ya se había transferido al proveedor, estos campos permanecen null en MANUAL_REVIEW hasta confirmar el retorno; después, refund_amount es como máximo lo que regresó (más la parte que no llegó a transferirse, hasta el importe de la orden).

Activo efectivo de la devolución; puede diferir del activo depositado.

Red efectiva de la devolución; usa una billetera compatible confirmada por el cliente.

Referencia de la devolución del socio a Lunium; no es prueba de una reversión al cliente.

Porcentaje de la venta de DePix en puntos básicos.

Parte fija de la venta de DePix, en centavos.

Tarifa total, en centavos; disponible en la cotización DePix y en la orden simulada.

PIX neto, en centavos; disponible en la cotización DePix y en la orden simulada.

Equivalente en USDT de la reserva operativa de R$1, convertido al cotizar y ya incluido en el total; no lo sumes de nuevo. Las órdenes antiguas conservan su valor original. / Equivalente en USDT de la reserva operativa de BRL 1, convertido al cotizar y ya incluido en el total; no lo añadas de nuevo. Las órdenes existentes conservan su valor original.

Reserva operativa fija de R$1 en las órdenes nuevas, ya incluida en el total. Las antiguas conservan la reserva original. / Reserva operativa fija de BRL 1 en las órdenes nuevas, ya incluida en el total; las órdenes existentes conservan su reserva original.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Importe de la solicitud de cobro en CENTAVOS de real, entero (ej.: 15000 = R$ 150,00). Consulta GET /cashin/limits antes de crear; publica los tramos vigentes sin retención y con retención para el pagador.

Red de la ruta de entrega. Usa el network del catálogo en este campo chain.

{"default":"polygon"}

Activo de la ruta disponible para entrega en GET /cashin/catalog; no se limita a stablecoins.

{"default":"usdt"}

Billetera por solicitud de cobro para destino=cripto; si se omite, puede usar settlement_address de la clave. Omitir para destino=saldo. La dirección debe corresponder a la red elegida.

CPF (11 dígitos) o CNPJ (14 dígitos) del pagador, solo números. Identifica al pagador y se usa para los límites y las retenciones antifraude publicados por GET /cashin/limits.

Identificador idempotente de hasta 64 caracteres. Conserva el mismo identificador y todos los parámetros en los reintentos. La comparación de diferencias varía según la ruta; no uses el replay para cambiar una operación. 409 external_id_divergente indica un conflicto detectado.

{"maxLength":64}

saldo acredita custodia BRL neta de tarifas, sin billetera. cripto (predeterminado) entrega en la billetera indicada o configurada. Consulta las tarifas/el período de espera en GET /saldo y la retención en la solicitud de cobro/estado.

{"enum":["cripto","saldo"],"default":"cripto"}

Subcuenta opcional del saldo (el id de tu cliente final). Con destino: "saldo", el crédito se abona en esta subcuenta; GET /saldo?customer_ref= lo consulta y POST /payouts con el mismo customer_ref lo gasta. Omítela para usar el saldo principal de la clave.

{"maxLength":80}

false rechaza cuando los límites del pagador requieren retención. No elimina otras retenciones/bloqueos de la clave. true u omitido permite la retención aplicable. Consulta held_hours Y hold_hours/liberar_em.

{"default":true}

Memo/tag del destino. OBLIGATORIO en las redes colectivas —XRP, XLM, TON, ATOM, HBAR, ALGO, EOS, KAVA, LUNA— donde la billetera de destino es compartida y el memo identifica al titular. Sin él, la API responde 400 memo_obrigatorio antes de crear cualquier solicitud de cobro. En XRP es la destination tag: entero de 0 a 4294967295. Alias aceptados: memo, tag, destination_tag. El catálogo marca estas rutas con memoRequired: true. Alias aceptados: memo, tag, destination_tag.

{"maxLength":120}

Nombre del pagador, cuando se indica.

Solo para una clave de sandbox. GET /sandbox proporciona la matriz de escenarios por flujo. Omitir en producción. Todos los precios, pagos y retiros siguen siendo ficticios.

{"enum":["success","delayed","held","expired","refunded","failed","payer_mismatch","settlement_failed","settlement_uncertain","route_unavailable","provider_unavailable"]}

Solo para chain="liquid" (DePix). "full" (predeterminado) entrega el DePix directamente a la billetera indicada, por el importe completo: no se descuenta la tarifa de la clave. "split" realiza el recorrido de recibir y reenviar: Lunium recibe el DePix, descuenta la tarifa de la clave (fija + porcentaje) y envía el neto a payout_address; net_cents en la respuesta es exactamente lo que recibe el destinatario. En split, payout_address es obligatorio. Sin el campo, se aplica el valor predeterminado de tu clave.

{"enum":["full","split"],"default":"full"}

Identificador de la solicitud de cobro (ci_…).

Estado del PIX. paid no acredita por sí solo el crédito/entrega; lee settlement_status.

{"enum":["pending","delayed","under_review","paid","expired","refunded","failed"]}

Importe del PIX en centavos.

cripto (entrega on-chain) o saldo (acredita la custodia BRL de la clave, utilizable en POST /payouts y POST /saldo/sacar-cripto).

{"enum":["cripto","saldo"]}

Origen del importe al crear: PIX o retiro del saldo.

{"enum":["pix","saldo"]}

Tu referencia del cliente final (subcuenta en el saldo).

{"maxLength":80}

Billetera que recibe la cripto (destino=cripto).

Memo/tag de la billetera de destino en redes colectivas (destino=cripto).

Red de entrega (id de GET /cashin/catalog).

Activo entregado (usdt, usdc, btc, …).

Tarifa porcentual congelada en la solicitud de cobro, en bps.

Parte fija congelada en la solicitud de cobro, en centavos.

Comisión adicional congelada en la solicitud de cobro.

PIX Copia y Pega al crear; null en el retiro de custodia.

Imagen del QR (PNG): solo en la respuesta de creación.

Identificador idempotente de hasta 64 caracteres. Conserva el mismo identificador y todos los parámetros en los reintentos. La comparación de diferencias varía según la ruta; no uses el replay para cambiar una operación. 409 external_id_divergente indica un conflicto detectado.

{"maxLength":64}

Validez de la propia solicitud de cobro; lee este timestamp, también para la validez ampliada por el bot.

Instante de liberación indicado para la retención del proveedor, cuando esté disponible.

Cuándo el crédito en saldo sale del período de espera. null cuando ya entra disponible (predeterminado desde el 16/09/2026).

Retención local de la solicitud de cobro en horas. No es un alias de held_hours ni del período de espera general del saldo.

Retención solicitada al proveedor. Puede ser cero mientras existe una retención local (hold_hours/liberar_em).

true cuando held_hours > 0. Por sí solo no revela la retención local.

True para operaciones ficticias de sandbox.

Solo en chain="liquid": cómo se entregó el DePix. Ausente en las demás redes.

{"enum":["full","split"]}

Solo en chain="liquid" con delivery_mode="split": cuánto recibe el destinatario en DePix, ya sin la tarifa. Es este importe el que Lunium envía on-chain.

Solo en chain="liquid" con delivery_mode="split": todo lo descontado del bruto (tarifa fija + porcentaje). net_cents + fee_total_cents == amount_cents.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Nombre del negocio (aparece en el panel y en los avisos).

{"minLength":2,"maxLength":80}

Recomendado: la clave recién creada se envía a este correo, además de aparecer en la respuesta.

Billetera EVM (Polygon) de liquidación. Opcional; puede definirse después.

URL HTTPS para los eventos. Opcional.

Token opaco ldt_… devuelto por POST /leads cuando la persona autorizó el contacto técnico (consentimiento). Vincula esta clave con el lead. Solo en el cuerpo, nunca en la URL. Opcional; su ausencia o un token no válido no impiden la creación.

{"minLength":47,"maxLength":47,"pattern":"^ldt_[A-Za-z0-9_-]{43}$"}

La clave en claro: aparece SOLO en esta respuesta (solo guardamos el hash).

true cuando se envió una copia de la clave al email indicado. false si no se proporcionó correo o falló el envío.

Presente cuando se indicó webhook_url.

Vista pública de la clave (prefix, name, flags).

Límites vigentes.

Monitor en vivo, de solo lectura, del flujo de esta clave.

Resultado de la atribución cuando se envía un lead_token con consentimiento. Nunca bloquea la creación de la clave.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.

Presente en los errores de límite, ya convertido a la moneda de la orden.

Identificador de esta solicitud. También se devuelve en la cabecera X-Request-ID y es el que debes citar a soporte. Si envías X-Request-ID con el formato [A-Za-z0-9._:-]{8,64}, se conserva de extremo a extremo.

Alias ANTIGUO de erro — RETIRADA: deja de enviarse el 2026-11-09. NO decidas la lógica según él; usa erro (canónico). Nunca aparece sin erro.

Código estable de error. Decide la lógica según él, nunca según el texto de detail. Esta lista se genera a partir de los códigos que realmente emite la API.

corrigir = la solicitud es incorrecta, repetirla idéntica nunca funciona · repetir = fallo transitorio nuestro, inténtalo de nuevo · esperar = la cuota se renueva, vuelve más tarde · parar = no repitas, habla con nosotros · falar_com_suporte = no repitas en bucle; conserva request_id y external_id y deriva el caso a Lunium (ej.: config_provedor).

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

Texto para personas. Nunca decidas la lógica según él.