如何在 Shopify 支付应用中正确返回 HTTP 响应以完成支付会话创建-php教程-PHP中文网

如何在 Shopify 支付应用中正确返回 HTTP 响应以完成支付会话创建

Shopify 要求支付应用在处理支付会话时，必须通过 GraphQL 接口调用 paymentSessionResolve 并返回包含有效 redirectUrl 的 2xx 响应，否则将显示“Your payment can’t be processed for technical reasons”错误。

shopify 要求支付应用在处理支付会话时，必须通过 graphql 接口调用 paymentsessionresolve 并返回包含有效 redirecturl 的 2xx 响应，否则将显示“your payment can’t be processed for technical reasons”错误。

在 Shopify 支付应用开发中，支付会话（Payment Session）的创建成功与否，完全取决于你是否在指定时间内向 Shopify 返回符合规范的 HTTP 响应。关键点在于：这不是一个传统意义上的 RESTful 回调 endpoint 响应，而是你作为支付服务方，在接收到 Shopify 发起的支付会话请求（通常通过你的后端接收 webhook 或 GraphQL 查询）后，主动调用 Shopify Admin API 的 paymentSessionResolve mutation，并确保该请求成功返回 200 OK 及包含 nextAction.redirectUrl 的响应体。

✅ 正确响应流程概览

Shopify 向你的应用发起支付会话创建请求（含 id、shop_domain 等上下文）；
你的后端验证请求合法性（如签名、scope、权限）；
你主动向 Shopify GraphQL Admin API 发起一次 mutation 请求（非等待回调）；
使用 paymentSessionResolve 将支付会话状态设为待授权，并提供跳转地址；
Shopify 接收该响应后，自动重定向买家至你指定的 redirectUrl 完成支付。

? 示例：调用 `paymentSessionResolve` 的完整请求

请确保使用有效的 Admin API 访问令牌（access token） 和正确的 API 版本（如 2024-07）：

POST https://{shop_domain}/admin/api/{api_version}/graphql.json
Authorization: Bearer {access_token}
Content-Type: application/json

mutation PaymentSessionResolve($id: ID!, $authorizationExpiresAt: DateTime) {
  paymentSessionResolve(id: $id, authorizationExpiresAt: $authorizationExpiresAt) {
    paymentSession {
      id
      status {
        code  # 应为 "AUTHORIZED" 或 "PENDING_AUTHORIZATION"
      }
      nextAction {
        action  # 必须为 "REDIRECT"
        context {
          ... on PaymentSessionActionsRedirect {
            redirectUrl  # ⚠️ 必须是 HTTPS、同域或已注册的合法回调域名
          }
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}

变量示例（JSON）：

{
  "id": "gid://shopify/PaymentSession/1234567890",
  "authorizationExpiresAt": "2025-04-10T12:00:00Z"
}

⚠️ 关键注意事项

redirectUrl 必须使用 HTTPS，且域名需已在 Shopify Partner Dashboard → App → App setup → Allowed redirection URLs 中预先配置；
authorizationExpiresAt 必须是未来时间（建议设置为 15–30 分钟后），超时将导致会话失效；
若返回 userErrors（如 redirectUrl is invalid），Shopify 将拒绝会话并触发前端错误提示；
你不需要在自己的服务器上暴露一个独立的 HTTP endpoint 来“被 Shopify 调用返回”——相反，是你主动调用 Shopify API 完成确认；
响应必须在 Shopify 发起请求后的 5 秒内完成（推荐异步触发 + 同步返回轻量确认），超时即视为失败。

✅ 验证与调试建议

使用 GraphiQL Explorer 手动测试 mutation；
检查响应中的 paymentSession.status.code 是否为 PENDING_AUTHORIZATION；
确保 nextAction.action === "REDIRECT" 且 redirectUrl 字段存在且可访问；
在 Shopify 商店前台复现支付流程，打开浏览器开发者工具 → Network 标签页，观察 /payments_apps/api/.../graphql.json 请求是否返回 200 及有效 payload。