# 创建支付订单
curl https://api.nexpay.com/v1/payments \
-u "sk_test_xxx:" \
-d merchant_order_no=ORDER-001 \
-d amount=4900 \
-d currency=USD \
-d payment_methods[]=card \
-d return_url=https://your-site.com/return \
-d notify_url=https://your-site.com/webhook
# 响应示例
{
"id": "pay_01HXXXXX",
"status": "pending",
"payment_url": "https://checkout.nexpay.com/s/xxx",
"amount": 4900,
"currency": "USD"
}开发者可通过统一 API 完成支付订单创建、交易状态查询、异步回调接收与退款处理。 平台提供标准字段结构与清晰的接入文档，适配主流开发流程。
/v1/payments/v1/payments/{id}/v1/payments/{id}/status/v1/refunds/v1/billing/invoices/v1/events支持支付成功、支付失败、退款更新、订阅变更等事件通知， 帮助业务系统及时同步订单状态与后续处理动作。
payment.succeeded支付成功通知payment.failed支付失败通知refund.updated退款状态变更subscription.updated订阅状态变更{
"id": "evt_01HXXXXX",
"type": "payment.succeeded",
"created_at": 1713456789,
"data": {
"id": "pay_01HXXXXX",
"merchant_order_no": "ORDER-001",
"amount": 4900,
"currency": "USD",
"status": "succeeded",
"paid_at": 1713456780
},
// 头部包含 X-NexPay-Signature，用于校验签名
}API 与 Webhook 服务运行中。如需查询实时状态与历史事件，欢迎联系我们的技术支持团队。