首信易支付订单查询接口

### 首信易支付订单查询接口知识点解析 #### 一、概述 首信易支付提供的订单查询接口，主要用于帮助商户实时查询在首信易支付平台上处理中的订单状态。通过该接口，商户能够准确地获取到订单的具体信息，以便更好地进行后续的操作与管理。 #### 二、接口功能介绍 **功能**: 商户可以通过调用该接口来查询在首信易支付平台上的订单状态。这有助于商户及时了解订单支付情况，从而进行相应的后续操作。 **适用场景**: - **支付确认**: 商户可以在用户完成支付后，立即调用此接口确认支付结果。 - **支付状态更新**: 定期查询订单状态，确保数据库中的订单信息是最新的。 - **支付异常处理**: 对于支付过程中出现的异常情况，可通过查询接口快速定位问题并采取措施。 #### 三、接口通讯协议 **协议类型**: HTTP **请求方式**: POST **请求URL**: `http://api.yizhifubj.com/merchant/order/order_ack_oid_list.jsp` - **注意事项**: 商户在使用该接口前需要先注册自己的服务器IP地址，以供首信易支付进行IP地址验证。 #### 四、接口数据格式 **请求参数**: 1. **商户编号（v_mid）** - **作用**: 标识请求方的唯一身份。 - **要求**: 不可为空，且必须按照申请时所提供的编号填写。 2. **订单编号(v_oid)** - **格式**: 由订单生成日期(yyyymmdd)、商户编号以及商户自定义的流水号组成。 - **示例**: 20230915-123456-00001 3. **数字指纹(v_mac)** - **作用**: 用于防止请求数据被篡改。 - **生成方式**: 使用HMAC-MD5算法，参数为商户编号（v_mid）+ 订单编号（v_oid），密钥由双方约定。 **响应格式**: - **格式**: XML - **示例**: ```xml <?xml version="1.0" encoding="gb2312"?> <ordermessage> <messagehead> <status>0</status> <statusdesc>Success</statusdesc> <mid>888</mid> <oid>20071017-888-135738</oid> </messagehead> <messagebody> <order> <orderindex>1</orderindex> <oid>20071017-888-135738</oid> <pmode>招商银行SZ</pmode> <pstatus>1</pstatus> <pstring>支付成功</pstring> <amount>0.01</amount> <moneytype>0</moneytype> <isvirement>0</isvirement> <sign>签名字符串</sign> </order> </messagebody> </ordermessage> ``` **响应参数**: 1. **响应状态（v_status）** - **说明**: 表示处理结果的状态，0表示正常，非0表示异常。 2. **响应状态描述(v_desc)** - **说明**: 对应v_status的文本描述。 3. **商户编号（v_mid）** - **说明**: 同请求参数。 4. **订单编号(v_oid)** - **说明**: 同请求参数。 5. **支付方式(v_pmode)** - **说明**: 支付渠道的中文名称。 6. **支付状态(v_pstatus)** - **说明**: 订单支付结果的状态码。 - **0**: 未提交 - **1**: 支付完成 - **2**: 未支付（支付结果不确定） - **3**: 支付被拒绝 - **4**: 商户退款中 - **5**: 退款已成功 - **6**: 退款被拒绝 - **7**: 持卡人拒付 - **8**: 异常退款 7. **支付结果说明（v_pstring）** - **说明**: 描述支付结果的原因或状态。 8. **订单金额(v_amount)** - **说明**: 实际支付的金额，单位为元。 9. **订单币种(v_moneytype)** - **说明**: 支持的币种类型，0表示人民币，1表示美元。 10. **订单是否已转账(v_isvirement)** - **说明**: 标识订单款项是否已经转账给商户。 11. **数字签名(v_sign)** - **说明**: 用于验证返回数据完整性和真实性的签名值。 #### 五、注意事项 - 在使用该接口之前，请确保已经完成商户信息的注册，并通过官方渠道获取到正确的API密钥等配置信息。 - 由于涉及到资金交易，建议商户定期检查自己的系统安全性，确保数据传输的安全性。 - 对于响应中的支付状态（v_pstatus），建议商户根据实际情况设置合理的重试机制和超时时间，以应对可能出现的网络延迟等问题。 通过以上介绍，我们可以了解到首信易支付订单查询接口的功能、使用方法以及需要注意的关键点。对于商户来说，合理利用这一工具可以帮助其更高效地管理订单，提高服务质量。