baynoy

API & SDK

为构建者打造的API

具有OpenAPI 3.1、幂等性键、游标分页和JavaScript、Python、PHP、Ruby、Go和C# SDK的REST API。

获取API密钥 阅读文档
使用Baynoy API的开发者

<150ms

P50 API延迟

99.95%

正常运行时间SLA

6

官方SDK

  • OpenAPI 3.1规范
  • 幂等性键
  • 游标分页
  • Bearer认证
  • HMAC webhook
  • 沙盒 + 测试卡
  • 6个官方SDK
  • 每秒1,000请求速率限制
  • 99.95%正常运行时间SLA

创建收款

一个端点，三十种方法

只需 POST 一个资源，Baynoy 会处理其余一切 — 银行卡、Apple Pay、Google Pay。设定目标货币，我们便会在结算时将款项路由到您的银行或钱包。

  • Idempotency-Key防止重试时双重收费
  • 大批量报告的游标分页
  • 通过checkout_url内联3DS挑战
  • 沙盒密钥永不接触真钱

请求

POST /v1/payments
Authorization: Bearer sk_live_••••
Idempotency-Key: 7a1f2e

{
  "amount": 125000,
  "currency": "EUR",
  "payout":  { "type": "bank", "currency": "TRY" },
  "methods": ["card","usdc","sepa"],
  "metadata": { "patient_id": "p_8821" }
}

响应

{
  "id": "pmt_a7c91...",
  "status": "requires_action",
  "checkout_url": "https://pay.baynoy.com/c/a7c91"
}

快速开始

# No SDK to install — it's a plain REST API.
# Create a payment link from any HTTP client:
curl https://baynoy.com/api/v1/payment-links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Invoice 0042","amount":2000,"currency":"USD"}'

REST API

用任何语言调用

采用 Bearer 鉴权的纯 REST API — 无需安装 SDK。可用 curl、fetch、requests 或任何 HTTP 客户端调用。面向生产：版本化响应、幂等重试、签名 Webhook 和游标分页。

  • 通过 Baynoy-Version 头实现稳定的版本化响应
  • 每个 POST 都带 Idempotency-Key — 重试绝不重复扣款
  • HMAC-SHA256 签名 Webhook（t=…,v1=…）
  • 每个列表端点都支持游标分页
阅读文档

Webhooks

您可以信赖的事件

每个webhook都用HMAC SHA-256签名，以指数退避重试最长7天，可在您的仪表板中浏览完整的request / response历史。一键回放任何过去的事件。

  • HMAC SHA-256签名的负载
  • 覆盖整个支付生命周期的8种事件类型
  • 最长7天的指数退避
  • 从仪表板一键回放
管理端点

签名事件

POST /your-endpoint
Baynoy-Signature: t=1716210000,v1=8b3...
Content-Type: application/json

{
  "id": "evt_2zX...",
  "type": "payment.succeeded",
  "data": { "object": { "id": "pmt_a7c91..." } }
}

获取密钥，发送收款

沙盒密钥立即发放。Tier 1验证后解锁生产。

获取API密钥 阅读文档