Wallets
Wallets hold customer stablecoin balances and connect money movement to blockchain rails.
Wallets belong to customers and hold stablecoin balances. Use them as the source or destination for pay-ins, payouts, balance checks, and transfer tracking.
Swipelux supports two wallet patterns:
- Custodial wallets: Created with
POST /v1/customers/{customerId}/walletsand managed by Swipelux. Use these wallets when fiat bank-transfer pay-ins or virtual accounts need a destination stablecoin balance. - Imported external wallets: Registered with
POST /v1/customers/{customerId}/wallets/import. Use these wallets for supported external wallet and on-chain recipient flows, such as sending funds to a verified self-custody destination.
Fiat bank-transfer pay-ins, including ACH, Fedwire, SEPA, SWIFT, PIX, SPEI, and PSE flows, currently require a Swipelux-created custodial wallet as the destination. Do not pass an imported external wallet as the to wallet for a fiat bank-transfer pay-in quote or execution.
If funds ultimately need to reach an external wallet, first receive the fiat pay-in into the customer's custodial wallet. After the pay-in settles, move funds onward through the supported transfer or payout flow for that destination.
API Reference
| Operation | Use it for |
|---|---|
POST /v1/customers/{customerId}/wallets | Create wallets for a customer. |
GET /v1/customers/{customerId}/wallets | List customer wallets. |
POST /v1/customers/{customerId}/wallets/import | Import an external wallet. |
GET /v1/customers/{customerId}/wallets/{walletId} | Retrieve wallet details and balance. |
DELETE /v1/customers/{customerId}/wallets/{walletId} | Delete a customer wallet. |
GET /v1/customers/{id}/balances | Retrieve customer balances. |