集成

加密货币支付 API。一个端点即可用加密货币收款。

用单一的 REST API 创建支付链接、接收 webhook 事件,并将资金结算到任意钱包地址。适用于任何语言或框架。前 30 笔支付免费。

你将获得什么

为追求简单的商户而构建。

REST API

标准的 JSON REST API。用任何语言或框架以编程方式创建支付、查看状态并管理你的账户。

Webhooks

在支付被确认、完成或失败时接收实时事件通知。针对漏投递提供可配置的重试逻辑。

多种费用模式

为每笔支付选择费用处理方式:从 Gas Tank 扣除、从支付金额扣除,或将费用转嫁给付款方。

智能合约支持

为链上支付流程提供原生智能合约集成。提供完整的技术架构文档。

工作原理

三步完成你的第一笔支付。

  1. 1

    获取你的 API 密钥

    在 app.makapay.io 创建一个免费账户,并在仪表盘的“API 密钥”下生成一个 API 密钥。

  2. 2

    创建一笔支付

    向 /api/payments 发起 POST 请求,附上你的商户钱包地址、网络、代币、金额和订单 ID。在响应中接收支付链接和二维码。

  3. 3

    接收 webhook 事件

    配置一个 webhook URL 以接收 payment.completed 事件。当资金在链上被确认时,你的系统会自动更新。

开始开发

一个请求,从零到你的第一笔收款

创建支付链接并获得一个 URL,资金在链上结算的瞬间即收到 webhook。适用于任何语言或框架。

创建支付

cURL
curl -X POST https://app.makapay.io/api/payments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
    "chainId": "137",
    "token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
    "amount": "100.00",
    "orderId": "order-12345",
    "description": "Premium subscription"
  }'

响应

你会得到一个托管的支付 URL。将客户重定向到该地址,或将其渲染为二维码。

JSON
{
  "url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}

处理 webhook

将 webhook URL 指向你的服务器,支付结算的瞬间 MakaPay 会 POST 一个 payment.completed 事件。

payment.completed
{
  "event": "payment.completed",
  "paymentId": "01234567-89ab-cdef-0123-456789abcdef",
  "orderId": "order-12345",
  "merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
  "amount": "100.00",
  "token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
  "chainId": 137,
  "status": "completed",
  "transactionHash": "0x...",
  "timestamp": 1704067200000
}

验证签名

每个 webhook 都带有签名。在信任负载之前,请先验证 X-Signature 请求头。

verify-webhook.js
const crypto = require("crypto");

function verifyWebhook(rawBody, signature, signingKey) {
  const expected = crypto
    .createHash("sha256")
    .update(rawBody + signingKey)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(expected, "hex"),
    Buffer.from(signature, "hex"),
  );
}

常见问题

API 的基础 URL 是什么?

MakaPay API 的基础 URL 是 https://app.makapay.io/api。使用 x-api-key 标头并附上你仪表盘中的 API 密钥进行身份验证。

该 API 支持哪些区块链?

该 API 支持 MakaChain、Ethereum、Polygon(MATIC)和 BNB Chain。MakaChain 交易零 gas 费。其他网络会产生浮动的 gas 成本。

我可以为多个不同的钱包地址创建支付吗?

可以。每个支付请求都包含一个商户钱包地址字段。你可以为每笔支付指定不同的收款地址,这对市场和多供应商场景非常有用。

有哪些可用的 webhook 事件?

MakaPay 针对支付状态变化发送事件,包括 payment.completed、payment.failed 和 payment.expired。你可在仪表盘中配置你的 webhook URL 并选择事件。

10 分钟内接受你的第一笔加密货币支付。

创建账户,为 Gas Tank 充值,分享你的第一条支付链接。无月费。无设置费。资金直接进入你的钱包。