星宝支付API接口指南：扫码支付与订单查询

"星宝支付接口文档18.09.271" 本文档主要介绍了星宝支付的扫码支付API和订单查询API的使用方法，适用于集成星宝支付系统的开发者。文档详细列出了请求参数、返回内容以及相关签名算法，以确保安全、准确地进行支付操作。 ### 一、扫码支付API 扫码支付API包含以下步骤： 1. **构建请求参数**：开发者需要按照规定格式构造请求参数，包括`key`、`record`、`money`、`refer`、`type`和`paytype`等，其中`key`是后台显示的通讯密钥，`record`用于标识唯一信息，`money`是交易金额，`refer`是支付成功后的跳转地址，`type`指定返回类型，`paytype`指明支付方式（如微信支付）。 2. **POST/GET参数到请求地址**：将构建好的参数发送到指定的请求地址`http://gateway.xingbao123.com`。 3. **根据返回内容展示二维码**：收到服务器响应后，解析返回的JSON数据，获取`image`字段中的二维码图片URL，并展示给用户。 4. **用户支付成功后接收异步通知**：用户完成支付后，星宝支付系统会向`notify_url`字段指定的异步通知地址发送回调数据，以便开发者进行订单状态的确认和处理。 #### 请求参数与返回字段 请求参数包括： - `key`：通讯密钥。 - `record`：附加信息。 - `money`：交易金额（2位小数）。 - `refer`：支付成功后的跳转地址。 - `type`：返回类型，可选JSON数据。 - `paytype`：支付类型（如1表示支付宝，2表示微信）。 返回内容包括： - `sdk_name`：收款账号名称。 - `money`：交易金额。 - `amount`：与`money`相同。 - `record`：附加信息。 - `order_num`：本平台创建的订单号。 - `order_time`：订单创建时间戳。 - `image`：二维码图片URL。 - `refer`：支付成功后的跳转地址（对JSON返回无用）。 - `msgInfo`：提示信息，根据实际情况返回。 ### 二、订单查询API 订单查询API允许开发者查询支付状态，步骤如下： 1. **构建请求参数**：构建查询参数，可能包括`key`、`order_num`等。 2. **POST/GET参数到请求地址**：将参数发送至查询接口。 3. **根据订单查询返回状态**：解析返回的数据，判断订单状态，如是否已支付、支付失败或订单不存在等。 订单查询API的具体请求参数和返回字段未在摘要中给出，但通常包括订单号、订单状态、支付时间等相关信息。 ### 签名算法 星宝支付系统要求对请求参数进行签名，以保证数据的安全性。具体的签名算法在文档中没有详细描述，但一般涉及对参数按特定顺序排序并拼接成字符串，然后使用预设的密钥进行加密计算，生成的哈希值作为`sign`字段的值。 ### 总结 星宝支付接口文档提供了完整的扫码支付和订单查询流程，开发者需按照文档要求构造请求并处理响应，确保支付过程的顺利完成。在实际应用中，还需要注意错误处理、安全性以及与后台系统的交互，以提供顺畅的用户体验。