Bind wallet
Connect existing third-party wallets to customer accounts
Bind Wallet
Purpose: Connect existing wallets from third-party providers (MetaMask, Trust Wallet, Coinbase Wallet) to customer accounts.
Binded wallets are non-custodial - Your customers retain full control of their private keys. Swipelux tracks the wallet address and enables transfers, but cannot initiate payouts/withdrawals since we don't control the private keys.
When to Use Bind
Use wallet binding for:
- Users with existing MetaMask, Trust Wallet, or similar wallets
- Non-custodial wallet solutions
- Users who prefer to manage their own private keys
- Web3-native users who want to keep their existing wallets
For new users without wallets, see Create Wallet.
Important: Binded wallets do NOT support payout/withdrawal operations via the API. Users can only receive funds and initiate transfers. For withdrawals, users must use their wallet provider directly.
Quick Example
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address (must be valid address format for the network) |
chain | string | Yes | Blockchain network. See Supported Rails for all 41 supported networks |
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Wallet identifier (use for transfers) |
address | string | Blockchain address |
chain | string | Blockchain network |
currency | string | Supported currency (USDC) |
bound | boolean | Always true for binded wallets |
createdAt | string | ISO 8601 timestamp |
Language Examples
Key Differences from Created Wallets
| Feature | Created Wallet | Binded Wallet |
|---|---|---|
| Private Keys | Managed by Swipelux | Managed by user |
| Control | Custodial | Non-custodial |
| Receive Funds | Yes | Yes |
| Transfers (API) | Yes | Yes |
| Payouts (API) | Yes | No |
| Withdrawals | Via Swipelux API | Via user's wallet app |
| Use Case | New users | Web3-native users |
Error Responses
| Status | Error | Solution |
|---|---|---|
400 | Invalid address | Provide valid address format for the specified network |
400 | Invalid chain | Use supported chains. See Supported Rails for all 41 supported networks |
404 | Customer not found | Create the customer first using POST /v1/customers |
409 | Address already binded | This address is already associated with a customer |