Merchant Quickstart
Accept USDC on your Shopify store in under 5 minutes. No code required.
1. Install the AIOT Payments app
Visit the AIOT Payments app listing on the Shopify app store and click Install. Grant the admin API permissions when prompted — the app needs to read orders and write draft orders so it can close them when payment settles on-chain.
2. Configure your settlement wallet
After install, open Apps → AIOT Payments → Settings. Paste the BSC wallet address where you want USDC to land, then pick your network:
- BSC Mainnet (chain 56) — real USDC, production use
- BSC Testnet (chain 97) — testnet USDC, for integration testing
Use BSC Testnet until you’ve processed at least one successful test order. Testnet USDC is free from faucets; mainnet mistakes are permanent.
The wallet address is stored in your shop’s metafield and can be changed at any time from the settings page. Payments that are already in-flight when you change the wallet will still land at the original address.
3. Enable x402 at checkout
Still on the Settings page, toggle Enable x402 Payments. The AIOT checkout extension will appear as a payment option on your store’s checkout page. You can customize the label shoppers see under the same toggle.
4. Place a test order
From your store’s checkout page, select Pay with USDC (x402). The checkout extension walks the shopper through:
- Connecting a wallet (MetaMask, Rabby, or any injected provider)
- Switching to the correct BSC network
- Signing a single EIP-712 Permit2 message — no on-chain transaction
- Waiting for the facilitator to settle (usually 2–5 seconds)
When the order completes, you’ll see it in your Shopify admin and in the AIOT Payments dashboard, with the on-chain transaction hash linked to BscScan.
5. Watch it land
Open Apps → AIOT Payments → Transactions to see the order you just placed. Click the transaction hash to jump to BscScan and confirm the transfer is finalized on-chain.
Bookmark the transactions page. It’s the fastest way to sanity-check that settlement is healthy, and the CSV export is the fastest way to reconcile with your bookkeeper.
Next steps
- Install the Shopify app — detailed walkthrough
- Configure your wallet — network selection, wallet hygiene
- Admin dashboard tour — what every page shows you
- Transactions & refunds — issuing refunds through the RefundDialog
- Analytics + CSV export — charts, filtering, bookkeeping exports