Configure Wallet
Your settlement wallet is the BSC address where USDC lands after each successful checkout. You set it once on the Settings page and can change it at any time.
Where to find it
In the Shopify admin: Apps → AIOT Payments → Settings.
Screenshot:
/screenshots/settings-page.png— the Settings page with the wallet address field and network selector. (Placeholder; awaiting live capture.)
1. Pick your network
Two networks are supported:
| Network | Chain ID | Use when |
|---|---|---|
| BSC Mainnet | 56 | Production — real USDC, real money |
| BSC Testnet | 97 | Integration testing, staging |
Testnet and mainnet use different wallet addresses internally if you use a hardware wallet with a BIP-44 derivation quirk. Verify on BscScan and BscScan Testnet that the address you paste is the one you expect to hold the USDC.
2. Paste your wallet address
Accepted format: a 42-character 0x-prefixed BSC address. The Settings page validates checksums — a typo produces an inline error before you can save.
Recommended wallet sources:
- Hardware wallet (Ledger / Trezor) — highest security; the private key never touches a computer.
- Safe multisig — best for teams; requires multi-party signoff on withdrawals.
- MetaMask / Rabby — fine for testing and low-volume stores; single point of failure.
Do not use an exchange deposit address. Exchanges sweep USDC on a schedule, which can front-run your settlement and break the audit trail.
3. Save and verify
Click Save. The Settings page writes the address to your shop’s metafield namespace (aiot_payments.settings.wallet_address) via the Shopify Admin GraphQL API. You’ll see a success toast when it’s stored.
To verify, check that the address displayed on the Settings page matches what you expect, and click the “View on BscScan” link to open the address in the block explorer.
Changing the wallet later
You can change the settlement wallet at any time. In-flight payments (sessions that are in settling state) will land at the previous address — the wallet is locked into the session at creation time, not at completion. New checkouts created after the change land at the new address.
If you’re rotating wallets (for example, moving from a hot wallet to a multisig), wait 30 minutes after changing the address to let any in-flight sessions expire, then verify that new orders are landing at the new address before deleting the old wallet.
Related
- Install the Shopify app
- Admin dashboard
- Transactions & refunds — verify your first payout lands