API 参考

API 快速开始

创建 MakePay API 密钥并发送第一个服务器请求。

选择团队和 API 密钥

登录后，可以从 MakeCrypto 门户或 API 测试标签创建 MakePay API 密钥。API 测试标签会加载你的团队、筛选 MakePay API 密钥；当所选团队还没有 MakePay 密钥时，它会打开创建密钥弹窗，并可以使用所选密钥 ID 和 secret 发送已认证请求。

基础 URL

所有 MakeCrypto 合作伙伴 API 路由都在生产源站下按版本组织。

https://www.makecrypto.io/api/partner/v1

本地开发时，使用你的本地 MakeCrypto 源站，并保持相同路径结构。

身份验证

服务器集成应在每个请求中发送 MakePay API key ID 和 API secret。secret 只会在创建 API 密钥时返回，因此请把它保存在服务器端密钥管理器中，绝不要发送到客户浏览器。

请求头	值	说明
`x-makecrypto-key-id`	MakePay API 密钥 ID	MakePay 支付 API 使用 `mk_makepay_` 前缀。
`x-makecrypto-key-secret`	一次性 API 密钥	只会在创建密钥时显示。请保存在服务器端密钥管理器中。

第一个读取请求

在创建真实支付链接前，先从读取请求开始。成功响应可以确认 key ID、secret、MakePay 产品范围和密钥所属公司都有效。

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"

第一个创建请求

当订单、发票或结账会话已准备好付款时，从你的服务器创建支付链接。

curl

curl -X POST "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 "Content-Type: application/json" \
  -d '{
  "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"
    }
  }
}'

运营检查清单

使用产品 makepay 创建 API 密钥。
在创建链接前配置公司的默认目标资产。
将 API secret 保存在源码控制和前端包之外。
支付链接 UID 可以作为公开标识符处理，但内部订单 ID 应放在 payload.orderId 或 payload.metadata 中。
在后端 Webhook 流程上线前，监听 Webhook，或从门户轮询支付链接/会话状态。