version: v1.0

Built with Teadocs

快速开发指引

# 快速开发指引

# 一、接口文档分类和支持的交易类型:

合付宝支付平台API接入共分为如下5大类接口,贵司实际开通的交易类型请参见贵司的“商户入网合同”或咨询贵司的业务经理。

接口分类支持的交易类型简要说明
网银&H5支付网银B2B支持调用网银支付页面(HTML),由企业客户从对公账户主动付款
网银B2C支持调用网银支付页面(HTML),由持卡人从银行卡账户主动付款
快捷H5支持手机端网页(HTML 5)收款场景
支付宝生活号支付支持支付宝生活号支付场景
微信公众号支付支持微信公众号支付场景
微信H5支持手机端微信APP中打开网页(HTML5)请求微信支付的场景
快捷支付后台绑卡快捷首次通过短信验证码校验完成绑卡。绑卡后再次短信校验完成支付。后续支付无需再次输入卡号。无合付宝页面,绑卡和支付需要两次短信验证。
扫码支付银联正扫支持持卡人使用银联云闪付APP扫描商户提供的银联二维码进行付款的场景。
银联反扫支持商户扫描持卡人的银联云闪付APP生成的二维码进行收款的场景。
支付宝扫码支持支付宝二维码的正扫、反扫的支付场景。
微信扫码支持微信支付二维码的正扫、反扫的支付场景。
QQ钱包扫码支持QQ钱包二维码的正扫、反扫的支付场景。
京东钱包扫码支持京东钱包二维码的正扫、反扫的支付场景。
代付代付对私支持发起向客户的银行卡账户单笔和批量付款。
代付对公支持发起向客户的对公账户单笔和批量付款。

各类接口的业务说明、业务流程、API接口文档、DEMO和常见错误码等详细开发支持,可查阅合付宝技术开放平台。

# 二、开发环境和测试环境联调

为了帮助您快速开发和调用接口,我们在各产品DEMO中都提供了资源包(包含JAVA、PHP、Python和.NET),封装了签名&验签、HTTP接口请求等基础功能,您可下载对应语言版本的DEMO并加入到您的开发代码中。

点击下载DEMO及接口文档

特别注意:

  1. DEMO程序的开发环境为:JAVA(jdk1.7+),PHP(5.3),Python(3.5),.NET(4.0),如您使用了其他版本的开发环境,可能需要稍加调整代码。
  2. DEMO中封装的签名&验签过程,使用的公私钥仅在测试环境中有效的,请求地址也是仅在测试环境有效。 点击查看密钥使用指南(签名&验签过程)
  3. 测试商户号可用:S20170907011890

建议使用以下版本的开发环境:JAVA(jdk1.7+),PHP(5.3),Python(3.5),.NET(4.0),以便于直接引用DEMO中的源代码,快速开发联调。

# 三、配置生产环境和正式上线

贵司的入网合同正式审核完成后,系统会自动发送一封标题为“合付宝-商户名称-商户号”的开户信至贵司入网合同指定的邮箱中。开户信包含了商户号、商户基本信息、开通的产品交易、下载商户加密证书所需的证书序列号和授权码等保密信息。

  1. 生产环境参数准备
    1) 正式商户号:请从贵司业务经理处获取邮件中的商户号。
    2) 下载商户加密证书(商户公钥和商户私钥):请从贵司业务经理处获取邮件中用于生成证书的商户号,请务必及时登陆合付宝商户后台官网https://pay.hefupal.com/将证书下载至您的操作电脑中,然后导出商户公钥(文件后缀为.cer)和商户私钥(文件后缀为.pfx)并妥善保管。请您务必牢记商户私钥导出过程中设置的密码。 点击查看加密证书下载指南 , 点击查看密钥常见问题
    3) IP地址:生产服务器的外网固定IP地址,可报备5个。您发起交易的服务器IP地址必须在报备地 址的范围内。
  2. 向合付宝报备生产环境参数
    为了您的支付安全,必须向合付宝报备与正式商户号匹配的生产环境参数1) IP地址 ,生效后才能发起正式交易。(请从贵司业务经理处获取用户注册所需要的商户基本信息--与商户入网合同登记信息一致)
  3. 修改程序代码的配置文件参数,完成生产环境设置
    DEMO程序代码在生产环境联调应做以下修改(修改位置在DEMO压缩包中的使用说明文件中有明确指引):
    1) 测试商户号:务必替换为正式商户号;
    2) 证书、密钥必须替换为正式的;
    3) 测试环境的请求地址:务必替换为生产环境的请求地址,生产环境的地址具体详看接口文档;
    4) 证书下载后,需查看正式是否 启用
  4. 投产上线
    生产环境参数报备生效且修改代码完成后,请按照场景需求在生产环境下完成一笔测试交易,以确保成功联调上线。

# 四、常见问题列表和在线人工支持

您在开发和联调中如遇到任何问题,可按以下方式获得支持:

  1. 查阅合付宝技术开放平台的相关技术文档;
  2. 常见问题列表:打开网页,录入关键字查询;
  3. 在线人工技术支持:工作日9:00~18:00提供支持服务;
  4. 服务投诉热线:400-0488-006