VALIDATION_FAILED | Falta un campo o tiene un formato no válido. | Corrija el cuerpo o la consulta. |
AMOUNT_MUST_BE_STRING | El importe monetario se envió como número. | Envíelo como cadena ("1500.00"). |
CONFLICTING_FIELDS | Se combinaron campos de modalidades distintas (p. ej., quoteId con amount). | Utilice una sola modalidad. |
PERMISSION_DENIED | El usuario de la API no tiene acceso a esta operación. | Contacte con XGate. |
COMPANY_BLOCKED | La empresa está bloqueada. | Contacte con soporte. |
ALLOWED_IPS_REQUIRED | La empresa no tiene una lista de IP permitidas. | Registre las IP en el Dashboard. |
CLIENT_IP_NOT_ALLOWED | La solicitud se realizó desde una IP que no está en la lista. | Autorice la IP en el Dashboard. |
CRYPTO_DISABLED | La cripto no está habilitada para la empresa. | Contacte con XGate. |
CRYPTO_API_DISABLED | El acceso a cripto mediante la API no está habilitado para la empresa. | Contacte con XGate. |
BUY_DISABLED | Las compras no están habilitadas para la empresa. | Contacte con XGate. |
PURCHASE_NOT_FOUND | El ID de compra no existe, tiene un formato no válido o pertenece a otra empresa. | Compruebe el id devuelto al crear la compra. |
SALE_NOT_FOUND | El ID de venta no existe, tiene un formato no válido o pertenece a otra empresa. | Compruebe el id recibido en el webhook. |
QUOTE_NOT_FOUND | quoteId no existe. | Genere una nueva cotización. |
QUOTE_EXPIRED | La cotización superó el valor de expiresAt. | Genere una nueva cotización. |
QUOTE_ALREADY_USED | La cotización ya se utilizó en otra compra. | Genere una nueva cotización. |
EXTERNAL_ID_CONFLICT | externalId ya se utilizó con un cuerpo diferente. | Utilice otro externalId. |
SAVED_ADDRESS_NOT_FOUND | addressId no existe. | Compruebe buy.addresses[]. |
SAVED_ADDRESS_NETWORK_MISMATCH | La dirección guardada pertenece a otra red. | Utilice una dirección de la red de la compra. |
ADDRESS_INVALID_FOR_NETWORK | La dirección no es válida para la red. | Compruebe la dirección. |
ADDRESS_NOT_SAVED | Está habilitada la restricción «solo direcciones guardadas» y la dirección no está guardada. | Guarde la dirección en el Dashboard o utilice addressId. |
ADDRESS_ON_HOLD | La dirección guardada aún está dentro del período de espera. | Espere hasta activeAt. |
ASSET_NOT_SUPPORTED | El activo no es compatible o no está habilitado. | Consulte GET /crypto/options. |
NETWORK_NOT_SUPPORTED | La red no es compatible con el activo. | Consulte GET /crypto/options. |
AMOUNT_BELOW_MIN | El importe es inferior a buy.minAmount. | Aumente el importe. |
AMOUNT_ABOVE_MAX | El importe supera buy.maxAmountPerTx. | Divídalo en compras más pequeñas. |
AMOUNT_TOO_LOW_FOR_NETWORK_FEE | El importe no cubre la tarifa y el gas de red. | Aumente el importe o elija otra red. |
INSUFFICIENT_BALANCE | Saldo BRL insuficiente. | Deposite BRL antes de comprar. |
PRICE_UNSTABLE | El precio es inestable en este momento. No se debitó ningún importe. | Vuelva a intentarlo en unos instantes. |
PRICE_STALE | El precio de referencia no está disponible. | Vuelva a intentarlo en unos instantes. |
NETWORK_FEE_UNAVAILABLE | No se pudo estimar el gas de red. | Vuelva a intentarlo o utilice otra red. |
RATE_LIMITED | Se realizaron demasiadas solicitudes por minuto. | Espere el tiempo indicado en Retry-After. |
DAILY_CAP_EXCEEDED | Se alcanzó el límite diario de compras. | Espere hasta el día siguiente o consulte buy.dailyRemaining. |
OUTFLOW_HOURLY_CAP_EXCEEDED | Se alcanzó el límite horario de salida de la tesorería. | Vuelva a intentarlo más tarde. |
CRYPTO_TEMPORARILY_UNAVAILABLE | La cripto no está disponible temporalmente. | Vuelva a intentarlo más tarde. |
FEATURE_DISCONTINUED | Ruta antigua de cripto, deshabilitada el 30/10/2026. | Utilice la API de compra y venta de cripto. |
FEATURE_STATUS_UNAVAILABLE | No se pudo verificar el estado de la discontinuación. | Vuelva a intentarlo. |