AIOT Payment x402 is in public beta. Install the skill for your AI agent.
GuidesFor MerchantsInstall the App

Install the App

The AIOT Payments app adds USDC-on-BSC as a checkout option for your Shopify store. Installation takes 2–3 minutes and requires no code.

1. Open the app listing

Navigate to the AIOT Payments listing on the Shopify App Store. Click the Install button in the top right of the page.

2. Authorize the app

Shopify will prompt you to authorize the app for your store. The app requests these scopes:

  • read_orders, write_orders — create draft orders and close them after settlement
  • read_products, read_draft_orders, write_draft_orders — power the draft-order flow that backs each checkout
  • read_customers — attach the payer’s email to the order for receipts
  • read_checkouts, write_checkouts — register the checkout extension
Why draft orders?

The AIOT x402 flow creates a Shopify draft order at session start, then completes and marks it paid only after the facilitator settles on-chain. This keeps your Shopify admin in perfect sync with on-chain state — if payment fails or the user abandons, the draft expires without ever appearing as a real order.

3. Land in the admin dashboard

After authorizing, Shopify redirects you into the AIOT Payments admin inside your store’s admin panel. You’ll see an onboarding checklist:

  1. Configure your settlement wallet
  2. Pick a network (BSC Mainnet vs Testnet)
  3. Enable x402 at checkout
  4. Place a test order

Screenshot: /screenshots/admin-dashboard.png — the AIOT Payments landing page inside the Shopify admin. (Placeholder; awaiting live capture from shopify-app/web/.)

Work through the checklist top-to-bottom — each step is covered in the guides below.

Common install issues

“App could not be installed” — usually means your store is on a plan that doesn’t allow external payment apps. Upgrade to Basic or higher and retry.

“Permission denied” — your user account doesn’t have the Manage apps permission. Ask the store owner to install it for you, or request the permission.

“Stuck on authorization screen” — clear third-party cookies for shopify.com, reload, and try again. Some privacy extensions block the Shopify auth flow.

Next steps

Error HandlingConfigure Wallet