<150ms
P50 API延迟
99.95%
正常运行时间SLA
6
官方SDK
8
Webhook事件
快速入门
一次POST，任何支付方式。每次重试都传递Idempotency-Key — 永远不会重复收费。
curl https://api.baynoy.com/v1/payments \
-H "Authorization: Bearer sk_test_••••" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"amount": 4900,
"currency": "USD",
"methods": ["card","usdc"],
"payout": { "type": "bank", "currency": "USD" }
}'验证webhook
每个事件都用HMAC SHA-256签名，并以指数退避重试长达7天。从仪表板回放任何过去的传递。
import crypto from "node:crypto";
export async function POST(req: Request) {
const header = req.headers.get("Baynoy-Signature")!; // t=...,v1=...
const body = await req.text();
const { t, v1 } = Object.fromEntries(
header.split(",").map((p) => p.split("=")),
);
const expected = crypto
.createHmac("sha256", process.env.BAYNOY_WHSEC!)
.update(`${t}.${body}`)
.digest("hex");
if (v1 !== expected) return new Response("bad signature", { status: 401 });
const evt = JSON.parse(body); // evt.type === "payment.succeeded"
return new Response("ok");
}REST API
Baynoy 是采用 Bearer 鉴权的纯 REST API — 无需安装 SDK。同一请求可在任何 HTTP 客户端中使用。
cURL
curl https://baynoy.com/api/v1/payments \
-H "Authorization: Bearer sk_live_..."JavaScript / TypeScript
await fetch("https://baynoy.com/api/v1/payments", {
headers: { Authorization: "Bearer sk_live_..." },
});Python
requests.get(
"https://baynoy.com/api/v1/payments",
headers={"Authorization": "Bearer sk_live_..."},
)Webhook事件
payment.succeeded
一笔付款已结算到您的余额。
payment.failed
一笔付款被拒绝或过期。
payment.refunded
退款完成，全额或部分。
payout.paid
支付到达目的地账户或钱包。
payout.failed
支付被拒绝并撤回。
dispute.opened
持卡人开启了争议或退款请求。
customer.created
通过API或结账添加了新客户。
invoice.paid
定期或一次性发票已支付。
可靠性
Cloudflare后的多区域部署、自动故障转移、SRE值班的24/7呼叫。状态页在48小时内发布每个事件和事后分析。
Changelog
最新发布多链USDC + 锁定汇率FX
Solana、Base、Ethereum和Polygon上的USDC支付，自动最低费用路由。
Hosted Checkout v2
沙盒桥接、12种语言自动检测、自定义logo + 强调色。
REST API v1、webhook、SDK
初始REST API、8个webhook事件和5个官方SDK已发布。
POST需要Idempotency-Key
在重试的POST请求上防止重复收费。