畅支付API文档:银行卡出款与安全规范

需积分: 0 0 下载量 22 浏览量 更新于2024-08-05 收藏 327KB PDF 举报
畅支付代付API文档详细介绍了如何通过API接口进行银行卡出款操作以及与微信和支付宝支付的相关功能。以下是关键知识点概述: 1. **接口接入基础**: - 需要提供商户秘钥(mch_key)作为安全凭证,这是商户配置的重要部分。 - 在发送请求前,需将表单数据整理成查询字符串,确保不包含空值字段,并生成签名(sign),通常通过MD5加密查询字符以验证数据完整性和安全性。 2. **出款类型与请求接口**: - 目前支持的出款类型包括银行卡出款,而微信和支付宝的出款请求功能暂未完成。 - 发起银行卡出款请求的接口为:`https://t-api.retenai.com/bank_order.api`,采用POST方法。 3. **请求参数**: - 必填参数包括商户ID(mch_id)、商户订单号(mch_order)、代付金额(amt)、用户IP地址(client_ip)、回调URL(notify_url)以及加密密钥(sign)和时间戳(created_at)。 - 银行相关字段如银行ID(bank_id)、银行卡号(bank_card)、持卡人姓名(real_name)等均为必填,且部分非必填字段如银行城市(bank_city)、手机号(bank_phone)和身份证号(bank_id_card)推荐填写以提高代付成功率。 4. **请求与返回**: - 请求时需要按照指定的数据类型填写参数,如整型(int)、字符串(string)等。 - 返回结果包括状态代码(code,用于判断请求是否成功)、错误信息(msg)以及成功时可能返回的商户信息(如mch_id、mch_order等)。 5. **安全规范**: - 使用sign进行数据加密,确保通信过程中的数据安全,防止数据被篡改或伪造。 - 提供的回调通知机制对于处理交易结果至关重要,开发者应确保回调URL的正确配置。 6. **后续开发工作**: - 文档提到微信和支付宝出款请求尚未完成,这可能意味着相关接口和实现还在开发阶段,开发者需要关注文档更新以获取最新进展。 此文档提供了畅支付代付API的基础使用指南,涵盖了接口调用的基本流程、参数设置以及安全注意事项。对于想要集成这些支付功能到自己应用的开发者来说,这是一个重要的参考资源。