MakeCrypto

API 参考

支付链接 API

创建、列出、查看、暂停、归档和邮件发送 MakePay 支付链接。

路由

使用这些路由从 MakeCrypto 创建和管理托管 MakePay 支付链接。

方法路由
GET/api/partner/v1/companies

认证

会话

用途

列出用户公司

返回已登录 MakeCrypto 用户可用于门户工具的团队。

POST/api/partner/v1/onboarding/company

认证

合作伙伴入驻密钥

用途

创建公司入驻链接

创建由合作伙伴预填的公司入驻草稿并返回商户领取 URL。可包含 oauth 区块，在商户完成入驻后自动连接已验证的 OAuth 应用。

GET/api/partner/v1/makepay/payment-links

认证

MakePay API 密钥

用途

列出或创建支付链接

读取 API 密钥所属公司的支付链接，或创建托管 MakePay 结账链接。

POST/api/partner/v1/makepay/payment-links

认证

MakePay API 密钥或公开

用途

列出或创建支付链接

读取 API 密钥所属公司的支付链接，或创建托管 MakePay 结账链接。

POST/gateway/pay/{makepayKeyId}

认证

公开表单密钥

用途

提交 HTML 支付表单

接收浏览器表单字段，创建托管支付链接，并将客户重定向到结账页。

GET/api/partner/v1/makepay/payment-links/{uid}

认证

MakePay API 密钥

用途

获取或更新支付链接

读取一个支付链接详情，或将支付链接设为 active、paused 或 archived。

PATCH/api/partner/v1/makepay/payment-links/{uid}

认证

MakePay API 密钥

用途

获取或更新支付链接

读取一个支付链接详情，或将支付链接设为 active、paused 或 archived。

POST/api/partner/v1/makepay/payment-links/{uid}/send-request-email

认证

MakePay API 密钥

用途

发送支付请求

将托管支付链接发送或重新发送到客户邮箱。

GET/api/partner/v1/makepay/subscriptions

认证

MakePay API 密钥

用途

列出或创建订阅

返回周期性 MakePay 订阅计划，或创建订阅和第一张发票。

POST/api/partner/v1/makepay/subscriptions

认证

MakePay API 密钥

用途

列出或创建订阅

返回周期性 MakePay 订阅计划，或创建订阅和第一张发票。

GET/api/partner/v1/makepay/customers

认证

MakePay API 密钥

用途

列出或更新客户

返回 MakePay 客户资料，或按邮箱创建/更新客户。

POST/api/partner/v1/makepay/customers

认证

MakePay API 密钥

用途

列出或更新客户

返回 MakePay 客户资料，或按邮箱创建/更新客户。

POST/api/partner/v1/makepay/customers/{customerId}/portal

认证

MakePay API 密钥

用途

创建客户门户链接

按需生成 24 小时有效的签名 MakePay 客户门户 URL。

GET/api/partner/v1/timezones

认证

公开

用途

列出时区

返回支持的 IANA 时区标识符。

GET/api/partner/v1/makepay/settings

认证

MakePay API 密钥

用途

读取或更新 MakePay 设置

读取或更新结算、重定向、费用和少付处理设置。

PUT/api/partner/v1/makepay/settings

认证

MakePay API 密钥

用途

读取或更新 MakePay 设置

读取或更新结算、重定向、费用和少付处理设置。

GET/api/partner/v1/makepay/destination-assets

认证

MakePay API 密钥

用途

列出目标资产

返回支持的结算资产和当前默认资产。

GET/api/partner/v1/makepay/webhook-requests

认证

MakePay API 密钥

用途

列出 Webhook 投递

查看支付和订阅 Webhook 投递尝试及重试状态。

创建支付链接

创建路由会插入 MakePay 支付链接，解析商户品牌和结算默认值，注入运行时计费字段，并返回公开结账 URL。

POST /api/partner/v1/makepay/payment-links
json
{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "returnUrl": "https://merchant.example/orders/1042",
    "successUrl": "https://merchant.example/orders/1042/success",
    "failureUrl": "https://merchant.example/orders/1042/failure",
    "expirationTime": "12h",
    "metadata": {
      "cartId": "cart_7M2V",
      "source": "api"
    }
  }
}

如果需要无代码或低代码的浏览器结账按钮，请参阅表单提交支付。它接受普通 HTML POST，创建同类托管支付链接，并把购物者重定向到 MakePay 结账。

必要设置

公司必须有 MakePay 默认目标资产。如果未配置结算，路由会返回 409 和 errorCode: "onboarding_required"。

金额和资产字段

使用 payload.amount 表示面向客户的金额。可以传入 payload.asset 指定精确目标资产，也可以在公司默认目标资产能解析链时传入 payload.currency。如果同一币种在多条链上启用且没有可匹配的公司默认链，请显式传入 payload.asset。

过期时间

payload.expirationTime 支持 15m、1h、12h、24h、72h 或 never。API 会把解析后的 expires_at 时间戳保存在支付链接上。

创建响应

json
{
  "ok": true,
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "status": "active",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "payload": {
      "title": "Website order #1042",
      "description": "Checkout for order #1042",
      "amount": "129.99",
      "fiatCurrency": "USD",
      "currency": "USDT",
      "orderId": "order_1042",
      "customerEmail": "buyer@example.com",
      "returnUrl": "https://merchant.example/orders/1042",
      "successUrl": "https://merchant.example/orders/1042/success",
      "failureUrl": "https://merchant.example/orders/1042/failure",
      "expirationTime": "12h",
      "metadata": {
        "cartId": "cart_7M2V",
        "source": "api"
      },
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system"
    }
  }
}

列出支付链接

列表路由适用于后台对账、仪表盘和冒烟测试。

curl
curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

获取支付链接详情

当你已有支付链接 UID，并需要规范化链接、公开结账 URL、最新支付会话和时间线事件时，使用详情路由。

curl
curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

暂停或归档支付链接

使用状态路由阻止链接继续被支付，或将其从活跃操作中隐藏。

curl
curl -X PATCH "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"status":"paused"}'

status 必须是 active、paused 或 archived。

发送支付请求邮件

MakeCrypto 可以把托管链接直接发送到支付链接载荷中的客户邮箱，也可以发送到请求体里覆盖指定的邮箱。

curl
curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID/send-request-email" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"email":"buyer@example.com"}'

只有 active 支付链接可以发送邮件。已完成支付的链接不能重新发送。

需要合作伙伴设置帮助？

在 MakeCrypto 中打开支付链接详情，复制真实支付 UID 的生成代码片段；也可以返回门户管理商户设置。

打开门户