Billeteras
Destinos USDT on-chain.
Las billeteras reciben retiros en USDT. El cuerpo de POST /crypto-beneficiaries usa camelCase (walletType, travelAddress). Cadenas: tron, eth o polygon. El activo es solo USDT.
Crear una billetera
/api/v1/crypto-beneficiaries
Alta de un destino USDT. Scope payouts:write.
Parámetros
AuthorizationstringObligatorioBearer $CLOBEPAY_API_KEY. También se acepta X-API-Key con el mismo valor. No envíes ambos.
namestringObligatorioTitular de la billetera.
chainstringObligatorioRed de la dirección.
tron · eth · polygon
assetstringObligatorioSolo USDT.
addressstringObligatorioDirección destino (TRON base58check o 0x… EVM).
walletTypestringOpcionalPor defecto self_hosted.
self_hosted · institution
travelAddressstringOpcionalTravel Rule: código ta…, solo si walletType es institution.
Respuestas
- HTTP 201Billetera creada. La dirección se guarda cifrada: la respuesta no la incluye, solo addressLast6 y addressMasked.
Errores
- HTTP 400
ambiguous_credentialsAuthorization: Bearer y X-API-Key traen llaves distintas. - HTTP 401
missing_credentialsNo enviaste la llave (Authorization: Bearer o X-API-Key). - HTTP 401
invalid_api_keyLa llave no existe, está mal formada o no coincide. - HTTP 401
api_key_revokedLa llave fue revocada. - HTTP 401
api_key_expiredLa llave expiró. - HTTP 401
api_key_wrong_environmentLa llave es de otro ambiente (llave de prueba en producción o al revés). - HTTP 403
insufficient_scopeLa llave no tiene el scope de esta ruta. - HTTP 429
rate_limitedDemasiadas peticiones. Respeta Retry-After. - HTTP 422
invalid_addressDirección o cadena inválida.
curl -X POST "$CLOBEPAY_API_BASE/crypto-beneficiaries" \ -H "Authorization: Bearer $CLOBEPAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"Atlas Creativo LLC","chain":"tron","asset":"USDT","address":"TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL","walletType":"self_hosted"}'Respuesta
HTTP 201{
"id": "a41c82e7-3b6d-4c90-9e2a-5f17d0b8c4e3",
"name": "Atlas Creativo LLC",
"chain": "tron",
"asset": "USDT",
"addressLast6": "1NYqeL",
"addressMasked": "…1NYqeL",
"walletType": "self_hosted"
}Listar billeteras
/api/v1/crypto-beneficiaries
Billeteras de tu comercio. Scope payouts:read.
Parámetros
AuthorizationstringObligatorioBearer $CLOBEPAY_API_KEY. También se acepta X-API-Key con el mismo valor. No envíes ambos.
Respuestas
- HTTP 200Listado.
Errores
- HTTP 400
ambiguous_credentialsAuthorization: Bearer y X-API-Key traen llaves distintas. - HTTP 401
missing_credentialsNo enviaste la llave (Authorization: Bearer o X-API-Key). - HTTP 401
invalid_api_keyLa llave no existe, está mal formada o no coincide. - HTTP 401
api_key_revokedLa llave fue revocada. - HTTP 401
api_key_expiredLa llave expiró. - HTTP 401
api_key_wrong_environmentLa llave es de otro ambiente (llave de prueba en producción o al revés). - HTTP 403
insufficient_scopeLa llave no tiene el scope de esta ruta. - HTTP 429
rate_limitedDemasiadas peticiones. Respeta Retry-After.
curl -X GET "$CLOBEPAY_API_BASE/crypto-beneficiaries" \ -H "Authorization: Bearer $CLOBEPAY_API_KEY"Respuesta
HTTP 200{
"items": []
}Consultar una billetera
/api/v1/crypto-beneficiaries/{walletId}
Detalle por UUID. Scope payouts:read.
Parámetros
AuthorizationstringObligatorioBearer $CLOBEPAY_API_KEY. También se acepta X-API-Key con el mismo valor. No envíes ambos.
walletIduuidObligatorioUUID de la billetera.
Respuestas
- HTTP 200Detalle (addressLast6 y addressMasked, sin la dirección completa).
Errores
- HTTP 400
ambiguous_credentialsAuthorization: Bearer y X-API-Key traen llaves distintas. - HTTP 401
missing_credentialsNo enviaste la llave (Authorization: Bearer o X-API-Key). - HTTP 401
invalid_api_keyLa llave no existe, está mal formada o no coincide. - HTTP 401
api_key_revokedLa llave fue revocada. - HTTP 401
api_key_expiredLa llave expiró. - HTTP 401
api_key_wrong_environmentLa llave es de otro ambiente (llave de prueba en producción o al revés). - HTTP 403
insufficient_scopeLa llave no tiene el scope de esta ruta. - HTTP 429
rate_limitedDemasiadas peticiones. Respeta Retry-After. - HTTP 404
not_foundNo existe o no es tuya. También si walletId no es un UUID.
curl -X GET "$CLOBEPAY_API_BASE/crypto-beneficiaries/a41c82e7-3b6d-4c90-9e2a-5f17d0b8c4e3" \ -H "Authorization: Bearer $CLOBEPAY_API_KEY"Respuesta
HTTP 200Detalle (addressLast6 y addressMasked, sin la dirección completa).