moonpay-virtual-account

バーチャルアカウント（法定通貨のオンランプとオフランプ）

目的

MoonPay バーチャルアカウントを設定して使用し、Solana、Ethereum、Polygon、Base、Arbitrum 上で法定通貨（USD/EUR）とステーブルコイン（USDC/USDT/EURC）を交換します。

セットアップの手順

1. アカウントを作成して KYC を開始する

mp virtual-account create

これによりアカウントが作成され、KYC 認証が自動的に開始されます。本人確認を完了するための URL が返されます。

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 — オンランプ後にステーブルコインをスワップまたはブリッジする