集成
加密货币支付 API。一个端点即可用加密货币收款。
用单一的 REST API 创建支付链接、接收 webhook 事件,并将资金结算到任意钱包地址。适用于任何语言或框架。前 30 笔支付免费。
你将获得什么
为追求简单的商户而构建。
REST API
标准的 JSON REST API。用任何语言或框架以编程方式创建支付、查看状态并管理你的账户。
Webhooks
在支付被确认、完成或失败时接收实时事件通知。针对漏投递提供可配置的重试逻辑。
多种费用模式
为每笔支付选择费用处理方式:从 Gas Tank 扣除、从支付金额扣除,或将费用转嫁给付款方。
智能合约支持
为链上支付流程提供原生智能合约集成。提供完整的技术架构文档。
工作原理
三步完成你的第一笔支付。
- 1
获取你的 API 密钥
在 app.makapay.io 创建一个免费账户,并在仪表盘的“API 密钥”下生成一个 API 密钥。
- 2
创建一笔支付
向 /api/payments 发起 POST 请求,附上你的商户钱包地址、网络、代币、金额和订单 ID。在响应中接收支付链接和二维码。
- 3
接收 webhook 事件
配置一个 webhook URL 以接收 payment.completed 事件。当资金在链上被确认时,你的系统会自动更新。
开始开发
一个请求,从零到你的第一笔收款
创建支付链接并获得一个 URL,资金在链上结算的瞬间即收到 webhook。适用于任何语言或框架。
创建支付
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"
}'const res = await fetch("https://app.makapay.io/api/payments", {
method: "POST",
headers: {
"x-api-key": process.env.MAKAPAY_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
merchant: "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
chainId: "137", // Polygon
token: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", // USDT
amount: "100.00",
orderId: "order-12345",
description: "Premium subscription",
}),
});
const { url } = await res.json();
// Redirect your customer to `url` to complete paymentimport requests
res = requests.post(
"https://app.makapay.io/api/payments",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
"chainId": "137", # Polygon
"token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", # USDT
"amount": "100.00",
"orderId": "order-12345",
"description": "Premium subscription",
},
)
url = res.json()["url"]
# Redirect your customer to `url` to complete payment响应
你会得到一个托管的支付 URL。将客户重定向到该地址,或将其渲染为二维码。
{
"url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}处理 webhook
将 webhook URL 指向你的服务器,支付结算的瞬间 MakaPay 会 POST 一个 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 请求头。
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 并选择事件。