全球领先的跨境支付 API 平台。简单、稳定、高性能。支持 10 余种对接方式，覆盖 80+ 国家，100+ 本地支付方式。10 分钟完成对接，立即开启您的全球收款之旅。
Telegram @tkpayy 免费申请商户号，开通 API 权限与沙箱环境。
登录商户后台 → 开发者中心，获取 APP ID、APP Secret，配置回调 IP 白名单。
调用 Sandbox 接口测试所有场景，技术工程师 7×24 在线协助。
切换到 Production 环境，开启真实通道，收款即刻开始。
Tkpay 全部接口均采用 HTTPS POST JSON 方式，签名算法 HMAC-SHA256，支持 UTF-8 / GBK，超时时间建议 30 秒。
| 参数名 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|
| app_id | string | 必填 | 202608010001 | 商户 APP ID，后台获取 |
| merchant_order_no | string | 必填 | ORDER20260815A001 | 商户订单号，32 字符内唯一 |
| amount | string | 必填 | 100.00 | 订单金额，两位小数 |
| currency | string | 必填 | THB | ISO 4217 三字符币种，如 THB / IDR / USD / BRL |
| pay_method | string | 可选 | PROMPTPAY | 支付方式代码，不传则由收银台展示全部可选项 |
| subject | string | 必填 | Premium会员订阅 | 商品标题，128 字符内 |
| notify_url | string | 必填 | https://your.domain/callback | 异步回调地址，支付完成后 POST JSON |
| return_url | string | 可选 | https://your.domain/success | 同步跳转地址，HPP 模式下支付完成后跳转 |
| user_ip | string | 可选 | 203.0.113.50 | 下单用户的真实 IP，用于风控校验 |
| timestamp | string | 必填 | 1723704000 | 当前 Unix 时间戳（秒） |
| sign | string | 必填 | 7F83B165... | HMAC-SHA256 签名结果 |
# 创建支付订单 - Sandbox 环境
curl -X POST "https://api-sandbox.tkpay.sbs/api/open/pay/create" \
-H "Content-Type: application/json" \
-H "X-Tkpay-App-Id: 202608010001" \
-d '{
"app_id": "202608010001",
"merchant_order_no": "ORDER20260815A001",
"amount": "100.00",
"currency": "THB",
"pay_method": "PROMPTPAY",
"subject": "Premium会员订阅",
"notify_url": "https://your.domain/callback",
"return_url": "https://your.domain/success",
"user_ip": "203.0.113.50",
"timestamp": "1723704000",
"sign": "7F83B165A9C..."
}'{
"code": 200,
"message": "SUCCESS",
"data": {
"order_no": "TK20260815XXXXXXXXXXXX",
"merchant_order_no": "ORDER20260815A001",
"amount": "100.00",
"currency": "THB",
"pay_url": "https://pay.tkpay.sbs/p/TK20260815XXXXXXXXXXXX",
"pay_method": "PROMPTPAY",
"qrcode": "00020101021129370016A000000677010111...",
"qrcode_image": "https://cdn.tkpay.sbs/qr/TK20260815.png",
"status": "PENDING",
"created_at": "2026-08-15 12:00:00"
},
"timestamp": 1723704000,
"sign": "9D8E1F42A0..."
}我们为主流技术栈提供了官方 SDK，封装了签名、加密、错误处理、重试与幂等逻辑，让您专注于业务开发。
SDK 获取方式：商户后台「开发者中心 → SDK 下载」，或 Telegram 联系 @tkpayy 直接获取最新版本。
X-Tkpay-Signature。SUCCESS 字符串，Tkpay 会在 1min / 5min / 15min / 30min / 1h / 2h / 6h / 12h / 24h 最多 9 次 重发。order_no 作为唯一键处理，避免重复回调导致重复发货。| 状态码 | 含义 | 排查建议 |
|---|---|---|
| 200 | SUCCESS 成功 | — |
| 400 | PARAM_ERROR 参数错误 | 检查必填参数、格式、字符长度 |
| 401 | UNAUTHORIZED 签名错误 | 检查 HMAC-SHA256 签名顺序、密钥、timestamp 是否过期 |
| 403 | FORBIDDEN 权限不足 | 检查商户是否开通对应支付方式 / 检查 IP 白名单 |
| 404 | ORDER_NOT_FOUND 订单不存在 | 检查 merchant_order_no 是否为当前商户号下 |
| 409 | ORDER_DUPLICATED 订单号重复 | 换一个新的 merchant_order_no |
| 429 | RATE_LIMITED 请求频率超限 | 默认 500 QPS，大客户可联系商务提升 |
| 500 | SYSTEM_ERROR 系统错误 | 联系技术支持 Telegram @tkpayy |
https://api-sandbox.tkpay.sbshttps://merchant-sandbox.tkpay.sbs