交易与到账状态查询

“到账了吗？”先查状态，再回答。

把你的只读交易 API 接进对话，让顾客直接询问转账进度。根据系统返回的状态、原因和预计到账时间回答。

示例数据 · 均为虚构

支付与金融科技

顾客

A transferência DEMO-TX-028 já chegou?

只读工具

get_transfer({ transfer_id: "DEMO-TX-028" }) → status: "em processamento", reason: "aguardando confirmação", expected_by: "próximo dia útil"

AI 回复

A transferência está em processamento, aguardando confirmação. O sistema informa previsão para o próximo dia útil; ainda não consta como concluída.

顾客身份取自已认证的会话并由服务端注入。只查状态，不修改交易。

用会话身份查询到账状态

工具名称: get_transfer
用途描述: 查询已认证顾客的交易状态、原因和预计到账时间。
接口地址: GET https://api.example.com/transfers/{transfer_id}
鉴权方式: Authorization: Bearer {{TRANSFER_API_SECRET}}
入参映射: transfer_id ← input.transfer_id customer_id ← server.session.customer_id
出参映射: status ← $.transfer.status reason ← $.transfer.reason expected_by ← $.transfer.expected_by

你的只读交易 API 的配置示例，不代表已提供支付平台原生连接器。

对话只提供 transfer_id。顾客身份由服务端从已认证的会话注入，接口必须校验交易归属。

配置 get_transfer 查询交易与到账状态，从你的 API 返回 status、reason 和 expected_by。数据来源没有预计时间时，明确说明尚无预计时间，不自行推测。

顾客身份由服务端从会话中注入，不接受聊天中自行声明的身份。接口返回数据前，必须确认所查交易属于当前顾客。

根据接口返回的原因，用顾客的语言解释状态。预计到账时间只是来源系统的估计，不能当作款项已到账的确认。

状态需要进一步核查时，将对话交给人工。工具只读交易状态，不发起、取消或撤回转账。

AI 可以读取哪些信息？

可以读取你配置的只读 API 开放的交易状态、原因和预计到账时间。把聊天组件嵌入网站，不会自动获得支付系统的访问权限。

顾客能在对话里提交别人的身份吗？

聊天内容不能作为身份来源。服务端从已认证的会话注入身份，你的 API 必须校验顾客是否有权查看所查交易。

AI 能转账或修改交易吗？

不能。这些工具仅查询交易与到账状态。需要操作的请求，应由你的团队按现有流程处理。

接口没有预计到账时间怎么办？

回答应明确说明来源未提供预计时间，可把对话转给人工继续核查，不能编造到账期限。

接入知识库与只读 API，让顾客用自己的语言查询订单、到账、账单和套餐。