Registers a wallet you already control so that AUDD can mint to it or accept a burn from it. AUDD never holds the keys: you supply the address and keep custody.
The wallet and the AUDD asset you intend to mint must be on the same network, so choose the network first with GET /networks and pass one of its subNetworks values.
A newly registered wallet is returned ACTIVE on networks where the address alone is enough. On networks that require the account to exist on chain it stays INACTIVE until it has a balance or some activity; fund it with a small amount of the network's native coin and call PUT /wallets/{id}/sync to re-check.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Invalid input. The body carries a messageKey identifying the rule that failed: wallet.company_id_required, wallet.nick_name_required, wallet.type_required, wallet.network_required, and wallet.invalid_external_wallet_type when type is anything other than DISTRIBUTOR or CUSTOMER. A missing publicKey is rejected with the plain message "must not be blank" and no messageKey, and a network or type outside the allowed values is rejected without a messageKey as well.
Unauthorized. The bearer token is missing, expired or invalid.
Forbidden. The token lacks the role needed to register an external wallet.
Not found. The companyId does not resolve to a company you can see.
Internal server error