360 Secure SkillHub
360 安全技能中心

MoonPay Commerce (Helio) Accept Crypto Payments

面向商户的加密货币收款 Skill，封装 MoonPay Commerce（原 Helio）API：用 setup 脚本保存 API Key/Secret 并自动获取钱包 ID，再通过 helio.sh 或 curl 列出支持币种、创建 Pay Link、生成结账 URL、查询交易及启用/停用支付链接，支持多种模板与代币兑换，当前仅限 Solana。

mavagio
mavagio
热度 70.81
最近更新 2026-05-11 15:51:07
分类：营销依赖：代码执行 / 读写文件 / 第三方 API应用场景：API 集成 / 自动化脚本 / 财务 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add mpc-accept-crypto-payments
Metadata
name
mpc-accept-crypto-payments
description
Accept crypto payments on Solana via MoonPay Commerce (formerly Helio). Create Pay Links, generate checkout URLs, check transactions, and list supported currencies. Use when the user wants to accept crypto payments, create payment links, charge for products/services with crypto, or query payment transactions. Requires a MoonPay Commerce account with API key and secret.
metadata
{"openclaw":{"requires":{"bins":["jq","curl"],"env":["HELIO_API_KEY","HELIO_API_SECRET"]},"credentials":{"storage":"~/.mpc/helio/config","setup":"bash scripts/setup.sh","permissions":"600"}}}

MPC Accept Crypto Payments

Merchant-side skill for accepting crypto payments on Solana via MoonPay Commerce (formerly Helio).

Setup

Run the setup script with your API credentials (wallet ID is fetched automatically):

bash scripts/setup.sh

You'll need:

  • API Key — from https://app.hel.io → Settings → API Keys
  • API Secret — from the same page (save it when generated)

The setup script will:

  1. Validate your credentials against the API
  2. Fetch your Solana wallets automatically
  3. Select the PAYOUT wallet (or CONNECTED if no PAYOUT exists)
  4. Save everything to ~/.mpc/helio/config

If the user doesn't have an account, direct them to https://app.hel.io to sign up.

Config Management

bash scripts/setup.sh status   # Show current config
bash scripts/setup.sh clear    # Remove saved credentials

Quick Reference

Base URL: https://api.hel.io/v1

List Supported Currencies (no auth needed)

curl -s https://api.hel.io/v1/currency | jq '.[].symbol'

Create a Pay Link

curl -s -X POST "https://api.hel.io/v1/paylink/create/api-key?apiKey=$HELIO_API_KEY" \
  -H "Authorization: Bearer $HELIO_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Payment",
    "template": "OTHER",
    "pricingCurrency": "<CURRENCY_ID>",
    "price": "<AMOUNT_IN_BASE_UNITS>",
    "features": {
      "canChangePrice": false,
      "canChangeQuantity": false,
      "canSwapTokens": true
    },
    "recipients": [{
      "currencyId": "<CURRENCY_ID>",
      "walletId": "<YOUR_WALLET_ID>"
    }]
  }'

Defaults: Currency is USDC (6340313846e4f91b8abc519b). Token swapping is enabled so payers can pay with any supported Solana token (auto-converted to USDC).

Price format: price is in base units (int64 string). For USDC (6 decimals): "1000000" = 1 USDC. For SOL (9 decimals): "1000000000" = 1 SOL.

Create a Charge (Checkout URL)

curl -s -X POST "https://api.hel.io/v1/charge/api-key?apiKey=$HELIO_API_KEY" \
  -H "Authorization: Bearer $HELIO_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"paymentRequestId": "<PAYLINK_ID>"}'

Returns { "id": "...", "pageUrl": "https://..." } — share pageUrl with the payer.

Check Transactions

curl -s "https://api.hel.io/v1/paylink/<PAYLINK_ID>/transactions?apiKey=$HELIO_API_KEY" \
  -H "Authorization: Bearer $HELIO_API_SECRET"

Disable / Enable a Pay Link

curl -s -X PATCH "https://api.hel.io/v1/paylink/<PAYLINK_ID>/disable?apiKey=$HELIO_API_KEY&disabled=true" \
  -H "Authorization: Bearer $HELIO_API_SECRET"

Helper Script

# Setup (run first)
bash scripts/setup.sh

# Operations
bash scripts/helio.sh currencies
bash scripts/helio.sh create-paylink "Coffee" 5.00 USDC
bash scripts/helio.sh charge <paylink-id>
bash scripts/helio.sh transactions <paylink-id>
bash scripts/helio.sh disable <paylink-id>
bash scripts/helio.sh enable <paylink-id>

Templates

The template field controls Pay Link type:

  • OTHER — generic payment
  • PRODUCT — physical/digital product
  • INVOICE — invoice
  • SUBSCRIPTION — recurring (requires subscriptionDetails)
  • EVENT — event ticket

Credential Handling

When setting up credentials, run the setup script interactively:

bash scripts/setup.sh

The script prompts for credentials directly in the terminal — they are never stored in chat history or logs. Credentials are saved to ~/.mpc/helio/config (mode 600).

Advanced