AI支付平台代付接口文档V1.6

代付接口文档 V1.61 本文档规定了AI代付的技术规范，以便商户快速接入AI代付系统。该文档规范包括交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。 1. 目的 本标准规定了AI代付的技术规范，以便商户快速接入AI代付系统。该标准旨在提供一个统一的技术规范，确保商户能够快速接入AI代付系统，并且能够正确地处理交易请求。 2. 术语与缩略语 本文档中使用了以下术语与缩略语： * AI：人工智能 * API：Application Programming Interface，应用程序编程接口 * UTF-8：Unicode Transformation Format-8， Unicode 转换格式-8 3. 适用范围 本文档适用于所有接入AI代付的商户。该标准规定了商户在使用AI代付系统时需要遵守的技术规范。 4. 接口清单 本文档定义了五个接口： * 商户钱包余额查询接口 * 商户钱包代付接口 * 代付结果通知接口 * 代付状态查询接口 * 银行代码对照表 4.1 商户钱包余额查询接口 该接口允许商户查询其在AI支付平台上开立的虚拟资金账户的余额。 4.1.1 功能描述 该接口提供了商户钱包余额查询功能，商户可以通过该接口查询其在AI支付平台上开立的虚拟资金账户的余额。 4.1.2 请求地址 https://pay.all-inpay.com/withdraw/queryBalance 4.1.3 参数定义 请求参数中的参数编码仅限于UTF-8。请求参数定义如下： * merchant_no：商户编号 * sign：签名结果 4.1.4 返回数据 返回数据为json格式。返回数据示例如下： * 成功 { "result_code":"000000", "result_msg":"商户钱包余额查询成功", "merchant_no":"xxx", "balance":"xxx", "sign":"xxx" } * 失败 { "result_code":"PAR005", "result_msg":"商户签名验证失败" } 4.2 商户钱包代付接口 该接口允许商户从其虚拟资金账户中代付款项。 4.2.1 功能描述 该接口提供了商户钱包代付功能，商户可以通过该接口从其虚拟资金账户中代付款项。 4.2.2 请求地址 https://pay.all-inpay.com/withdraw/transfer 4.2.3 参数定义 请求参数中的参数编码仅限于UTF-8。请求参数定义如下： * merchant_no：商户编号 * amount：代付金额 * sign：签名结果 4.2.4 返回数据 返回数据为json格式。返回数据示例如下： * 成功 { "result_code":"000000", "result_msg":"商户钱包代付成功", "merchant_no":"xxx", "amount":"xxx", "sign":"xxx" } * 失败 { "result_code":"PAR006", "result_msg":"代付失败" } 4.3 代付结果通知接口 该接口允许AI支付平台将代付结果通知给商户。 4.3.1 功能描述 该接口提供了代付结果通知功能，AI支付平台将代付结果通知给商户。 4.3.2 参数定义 通知参数定义如下： * result_code：代付结果代码 * result_msg：代付结果信息 * merchant_no：商户编号 * amount：代付金额 * sign：签名结果 4.3.3 验证通知的合法性 商户需要验证通知的合法性，以确保通知来自AI支付平台。 4.4 代付状态查询接口 该接口允许商户查询代付状态。 4.4.1 功能描述 该接口提供了代付状态查询功能，商户可以通过该接口查询代付状态。 4.4.2 请求地址 https://pay.all-inpay.com/withdraw/queryStatus 4.4.3 参数定义 请求参数中的参数编码仅限于UTF-8。请求参数定义如下： * merchant_no：商户编号 * order_no：订单编号 * sign：签名结果 4.4.4 返回数据 返回数据为json格式。返回数据示例如下： * 成功 { "result_code":"000000", "result_msg":"代付状态查询成功", "merchant_no":"xxx", "order_no":"xxx", "status":"xxx", "sign":"xxx" } * 失败 { "result_code":"PAR007", "result_msg":"代付状态查询失败" } 5. 银行代码对照表 本文档还提供了银行代码对照表，商户可以根据该表将银行代码转换为银行名称。 本文档规定了AI代付的技术规范，包括交易正常处理流程、异常情况的处理流程、消息域说明、消息格式以及交易报文格式说明。商户可以根据本文档快速接入AI代付系统，并且能够正确地处理交易请求。