支付

状态、轮询和对账

在获得银行结论之前，先从后台查询状态。 callback、 SCA 返回或小部件关闭并不构成财务确认。

后端查询

: "${WR_API_KEY:?Defina WR_API_KEY en el entorno seguro de su backend}"

curl --request POST 'https://api.wealthreader.com/payments/?action=status' \
  --header 'Content-Type: application/json' \
  --header "X-API-Key: ${WR_API_KEY}" \
  --data '{
    "payment_intent_id": "11111111-1111-4111-8111-111111111111",
    "refresh": true
  }'

refresh 为可选且默认 true 。 Wealth Reader 通过意图限制外部查询;在后端也应用backoff，只要结果不明确，就不要创建新的意图。

三种不同的维度

字段	主要取值	所表示的信息
`state`	`ready`， `authorization_required`， `processing`， `reconciliation_required`，终端	持久化的流程状态。
`interaction_status`	`not_started`， `authorization_required`， `processing`， `completed`， `finished`	无论技术互动是结束还是继续。
`payment_status`	`not_initiated`， `pending`， `unknown`， `settled`， `rejected`， `cancelled`， `expired`， `failed`	标准化的资金状态。

唯一有效的正面确认是 payment_status: settled，它必须来自银行明确确认资金结算完成的状态。技术性结果 DONE、interaction_status: completed 或 payment_status: pending 都不表示资金结算完成。

结果模糊

启动后未识别的网络中断、超时或响应会将意图状态改为 reconciliation_required并暴露 payment_status: unknown。启动不会自动重复。

当前提供者不提供重建响应丢失的初始查询：其状态查询需要同一启动返回的不透明上下文。因此，这种情况需要手动对账;无法通过定期查询自动状态或搜索 callbackID来检索。

那么：

保留幂等性密钥和标识符;
不得创造其他意图或再次授权;
通过经过身份验证的请求查询 Wealth Reader 中的支付状态并保留您的安全对账参考;
请联系技术支持;当automatic_recovery``false时，请勿继续查看状态。

对于需要手动对账的意图，服务器间查询可以包括：

{
  "payment_status": "unknown",
  "reconciliation_required": true,
  "reconciliation": {
    "automatic_recovery": false,
    "reference": "wrp_recon_0123456789abcdef0123",
    "request_id": "11111111-1111-4111-8111-111111111111",
    "correlation_id": "22222222-2222-4222-8222-222222222222",
    "reason": "initiation_rejected"
  }
}

这些标识符是供技术支持使用的脱敏参考标识。它们不会交付给小部件，也不允许客户查询或重建提供者的内部状态。

reason 是 Wealth Reader代码，绝非供应商文本。 initiation_rejected 表示供应商明确拒绝了启动; initiation_response_unavailable，表示没有可识别的回复。在这两种情况下，启动通知已经发送，因此不会重复：保留参考并联系技术支持。

Callback 与重复调用

返回 SCA 达到独占支付 callback 。 Wealth Reader 验证相关性，将银行参数如实转发给提供者（记录未预见的名称，且从不拒绝已授权的返回），只消耗一次返回，并保持加密的敏感状态。重复只响应 HTTP 409;它不依赖于正文中的内部代码。

认证可能需要多次重定向。每个验证后的 REDIRECT 在同一 SCA 窗口内继续，并开启新的 callback检查点;它不会创建新的启动。结果 DECOUPLED 保持意图 processing ，方便控件查询状态。显式 RETRY 仅重复已准备好的完成，等待时间有限，尝试次数有限。 ERROR， PASSWORD， MORE_INFO， SELECT_OPTION未知结果或这些限制的耗尽以对账结束，绝不会有新的启动。

商家无需发布或处理该 callback。本版本不向商家发送 webhook：公开的付款确认接口约定是通过服务器间请求轮询状态。

关闭小部件

flow_closed 传达可见交互已结束。前端可以关闭模态，但不能仅因该事件就显示“已付款”。后端仍负责确认付款或进行对账。

下一步

完成以下列表安全与测试.

最后更新于 2026-09-10