moonpay-virtual-account

虚拟账户（法币入金与出金）

目标

设置并使用 MoonPay 虚拟账户，在 Solana、Ethereum、Polygon、Base 或 Arbitrum 上兑换法币（USD/EUR）和稳定币（USDC/USDT/EURC）。

设置流程

1. 创建账户并开始 KYC

mp virtual-account create

这会创建账户并自动开始 KYC 验证，并返回一个用于完成身份验证的网址。

2. 查看账户状态

mp virtual-account retrieve

status 字段会显示当前进度。nextStep 字段会告诉你接下来要做什么。

3. KYC 验证

# Check KYC status or get the verification link again
mp virtual-account kyc continue

# Restart KYC if something went wrong
mp virtual-account kyc restart

4. 接受必需的协议

# List agreements that need to be accepted — shows name and URL for each
mp virtual-account agreement list

重要： 接受任何协议前，请向用户展示列表输出中的协议名称和 URL，并要求他们打开并审阅。只有在用户明确确认已阅读并同意条款后，才能继续。

# Accept an agreement (only after user confirms they have reviewed the URL)
mp virtual-account agreement accept --contentId <content-id>

# View previously accepted agreements
mp virtual-account agreement list --status accepted

5. 注册钱包

mp virtual-account wallet register --wallet main --chain solana

此命令会一次性完成创建验证消息、本地签名和注册。支持的链：solana、ethereum、polygon、base、arbitrum。

# List registered wallets
mp virtual-account wallet list

入金（法币兑换为稳定币）

# Create an onramp — returns deposit account (bank IBAN or account number)
mp virtual-account onramp create \
  --name "My Onramp" \
  --fiat USD \
  --stablecoin USDC \
  --wallet <registered-wallet-address> \
  --chain solana

# Get onramp details (includes deposit account, fees, legal disclaimer)
mp virtual-account onramp retrieve --onrampId <id>

# List onramps
mp virtual-account onramp list

# Update an onramp (change wallet, chain, or stablecoin)
mp virtual-account onramp update --onrampId <id> --chain ethereum

# Cancel an onramp
mp virtual-account onramp cancel --onrampId <id>

# Create an open banking payment
mp virtual-account onramp payment create \
  --onrampId <id> \
  --amount 100 \
  --fiat USD

# Check payment status
mp virtual-account onramp payment retrieve \
  --onrampId <id> \
  --paymentId <payment-id>

出金（稳定币兑换为法币）

先注册银行账户

# Register a USD bank account (ACH)
mp virtual-account bank-account register \
  --currency USD \
  --type ACH \
  --accountNumber <number> \
  --routingNumber <number> \
  --providerName "Chase" \
  --providerCountry US \
  --givenName John \
  --familyName Doe \
  --email [email protected] \
  --phoneNumber +14155551234 \
  --address.street "123 Main St" \
  --address.city "New York" \
  --address.state NY \
  --address.country US \
  --address.postalCode 10001

# List registered bank accounts
mp virtual-account bank-account list

# Delete a bank account
mp virtual-account bank-account delete --bankAccountId <id>

创建并使用出金

# Create an offramp
mp virtual-account offramp create \
  --name "My Offramp" \
  --bankAccountId <bank-account-id> \
  --stablecoin USDC \
  --chain solana

# List offramps
mp virtual-account offramp list

# Get offramp details
mp virtual-account offramp retrieve --offrampId <id>

# Update an offramp (change fiat currency / bank account)
mp virtual-account offramp update --offrampId <id> --fiat EUR

# Cancel an offramp
mp virtual-account offramp cancel --offrampId <id>

# Send stablecoin to an approved offramp (signs and broadcasts locally)
mp virtual-account offramp initiate \
  --wallet main \
  --offrampId <id> \
  --amount 100

其他命令

# List transactions
mp virtual-account transaction list

相关技能

• moonpay-auth — 登录和钱包设置（使用虚拟账户前必需）
• moonpay-check-wallet — 查看稳定币余额
• moonpay-swap-tokens — 入金后兑换或跨链转移稳定币