Create a wallet
Creates a wallet for a customer. Polymorphic on type: fiat and custodial are implemented — noncustodial is accepted by the request discriminator but rejected with 501 WalletTypeNotSupported. Pass an Idempotency-Key header to safely retry without provisioning duplicates; a replay returns the same response, including the same operation Location.
A fiat create requires the project to be configured for fiat wallets at “Erebor Bank, N.A.” (403 EreborConfigMissing), the fiat-wallet book-transfer rail enabled for the project (403 DestinationRailNotAllowed), and the customer registered with that bank (400 EreborCustomerNotMapped); the wallet starts pending and becomes active once the bank opens the backing account. The customerWallet.created webhook fires when the wallet is first recorded and carries pending; customerWallet.statusChanged to active follows when the bank opens the account. A custodial create requires the project and the customer to be enrolled with the custody provider (422 ProjectMissingCoinmeID, 422 ProviderUserAccountNotFound), an active cryptoCustody endorsement when the project requires one (400 CryptoCustodyInactive), and an asset/network pair that provider supports (422 UnsupportedAsset); it returns 201 with the wallet when the wallet already exists or the provider confirms it synchronously, and 202 with a Location header pointing at the wallet-provisioning operation — poll GET /wallets/operations/{operationId} — when confirmation arrives asynchronously. A durable provider rejection is 422 WalletProvisioningRejected.
Headers
Body
- Custodial wallet
- Non-custodial wallet
- Fiat wallet
Create a custodial crypto wallet. Not yet implemented — returns 501.
Response
The request has succeeded and a new resource has been created as a result.
- Crypto wallet
- Fiat wallet
The walletCrypto variant — one crypto asset on one network, held on the customer's behalf by the custody provider, currently "Coinme Inc.". address is the on-chain deposit address and is omitted until the provider reports one.