实现

安全性

艾克索拉采用以下安全措施:

注:
API密钥由艾克索拉生成,每个提供商均获得唯一密钥。

来自艾克索拉的请求包含以下请求头:

描述必需
Request-Id唯一请求ID。
Content-Digest请求正文的校验和值。有请求正文时必需
Signature-Input用于生成签名的参数。
Signature请求签名。
Prefer附加数据,例如environment=“sandbox”否。
注:
您发送给艾克索拉的webhook必须包含相同的头。

传入请求验证

接收艾克索拉请求时:

  1. Signature-Input请求头中的keyid值提取对应密钥。
  2. 验证created/expires时间窗口有效性。
  3. 获取请求正文内容。
  4. 根据Signature-Input重建签名字符串,并使用HMAC-SHA256验证签名。
示例
请参考GitHub上的详细示例。
示例
Copy
Full screen
Small screen
1sig1=("@method" "@target-uri" "content-digest" "request-id");alg="hmac-sha256";created=1700000000;expires=1700000600;keyid="acc_123"
  1. 通过Request-Id在日志中查找请求记录。

必需功能

成功集成至少需实现以下API方法:

方法路径描述
POST/v1/payments创建支付。返回action对象。
PATCH/v1/payments/{transaction_id}当返回action.type=confirm时确认支付。
GET/v1/payments/{transaction_id}获取当前支付状态。
您还需配置向艾克索拉发送以下支付事件的Webhook通知:
  • payment.succeeded — 支付成功
  • payment.failed — 支付失败
  • payment.refunded — 退款
注:
详细的API方法和Webhook说明请参阅规范文档。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2025年11月13日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。