支付 AceDataCloud 平台订单
内容提要
本文介绍AceDataCloud平台订单支付API。通过POST请求为待支付订单获取支付链接或二维码，支持支付宝、微信、Stripe、PayPal及加密货币等支付方式。接口需账户令牌鉴权，支付成功后自动到账，链接有时效性，重复支付会返回错误。
延伸解读
支付方式差异与适用场景
接口针对不同支付方式返回不同内容：支付宝和微信返回二维码或跳转链接，适合国内用户；Stripe和PayPal返回Checkout Session或Approve URL，适合国际卡支付；X402/Crypto则返回链上转账指令，适合加密货币支付。开发者可根据目标用户群体选择合适的支付方式，但需注意不同方式的过期时间不同，如支付宝/微信为15分钟，Stripe/PayPal为24小时。
链上支付的即时性
X402/Crypto支付与第三方支付不同，接口返回时state已为Paid，即链上确认即生效，无需等待异步回调。这要求开发者理解链上支付的特性：一旦交易上链，支付即完成，且不可逆。因此，在集成时需确保签名和地址正确，避免因错误操作导致资金损失。
重复支付保护机制
接口内置重复支付保护：订单状态为Paid后再次调用会返回400 invalid_state，防止重复扣款。这要求开发者在客户端做好状态管理，避免用户重复提交支付请求。同时，支付链接有时效性，过期后重新调用接口可生成新链接，但需注意订单状态必须为Pending。
Q&A
如何为 AceDataCloud 平台的待支付订单发起支付？
调用 POST https://platform.acedata.cloud/api/v1/orders/{order_id}/pay/ 接口，在请求头中携带账户令牌（Authorization: Bearer platform-v1-...），对于支付宝、微信、Stripe、PayPal 等支付方式，请求体通常为空 {}。接口会返回支付链接或二维码，用户完成支付后自动到账。
AceDataCloud 平台订单支付支持哪些支付方式？
支持支付宝（AliPay）、微信（WeChat）、Stripe、PayPal，以及加密货币（X402 / Crypto，基于 EIP-3009 或 Solana 链上转账）。
使用加密货币支付 AceDataCloud 订单时需要提供哪些参数？
需要提供钱包对授权信息的签名（signature，EIP-712 或 Solana 签名）和付款方钱包地址（from_address），可选参数包括链 ID（chain_id，默认平台主链）和代币合约地址（token_address，默认 USDC）。
AceDataCloud 订单支付链接的有效期是多久？过期后怎么办？
支付宝和微信的支付链接一般 15 分钟过期，Stripe 和 PayPal 的链接有效期为 86400 秒（24小时）。过期后再次调用支付接口会自动生成新的支付链接。
AceDataCloud 订单支付成功后如何确认到账？
支付成功后，服务端会异步监听支付回调，通常几秒内订单状态变为 Paid 并增加账户余额。客户端可以轮询订单详情或刷新订单状态来感知支付结果。对于链上支付（X402/Crypto），接口返回时 state 已经是 Paid。
如果订单已经支付，再次调用 AceDataCloud 支付接口会怎样？
如果订单状态已经是 Paid，再次调用支付接口会返回 400 invalid_state 错误，不会重复扣款。
AceDataCloud 支付接口返回哪些常见错误？
常见错误包括：400 invalid_state（订单状态不是 Pending）、400 invalid_signature（签名验证失败）、400 invalid（其他参数错误）、401 not_authenticated（缺少账户令牌）、403 permission_denied（订单不属于你）、404 not_found（订单不存在）。
