ATeamCN支付接口v1.0简洁版 完整使用说明:

2020年2月2日

21:34

ATeamCN支付接口v1.0简洁版 使用说明:

文档版本:v1.0

文档更新时间:2020年1月1日 16:00:00

 

支付能力:

微信收款

支付宝收款

支付宝提现

 

费率:

微信收款费率0.15%。

支付宝收款费率0.15%。

 

资费扣除方式:

付款时自动扣除

 

结转速度:

实时结转，到账延迟在300秒内。(请避免多次发起结转，以加快结转队列速度，用更少的时间完成结转)

 

特性介绍:

轻量级，无冗杂；

灵巧易用，简洁精悍；

超低费率，免认证；

 

接入步骤:

  1. 申请支付接口的调用id与支付秘钥。(可以通过向客服微信ATEAMCN申请 或 自助注册创建

 http://cloudpad.api.ateamcn.com/http/combination/easyPay_cloudpad-etrade/userHome/login.php )

  1. 绑定用于收款的支付宝账号 和 用于确认身份与客服沟通的联系方式。
  2. 根据ATeamCN支付接口使用说明中给出的测试demo,完成对支付接口的调用测试,在自己编写的程序中发起多种价格的支付并完成收款。(点击这里登入并查看测试demo

 http://cloudpad.api.ateamcn.com/http/combination/easyPay_cloudpad-etrade/userHome/index.php )

  1. 将支付接口接入系统，完成系统对支付接口的正式调用，确认需求使用的功能正常，如果需求协助或有任何问题请直接截图并附问题描述，发送给客服请求帮助。

 

 

(相比于标准版，简洁版调用容易，可以省略大部分复杂的后期处理，更容易接入，除API调用技术文档与标准版不同，其余内容均完全相同)

 

API调用技术文档:

 

-收款功能(手机扫码支付收款)-调用url: http://cloudpad.api.ateamcn.com/operation/combineSet/easyPay_etrade-selfpay/easyPay_createTradeOfItem/easyPay_createTradeOfItem.php

-调用方式:POST

-请求参数(必选)-支付接口调用者身份id:

参数名称:

accountId

参数形式:

字符串

 

(示例:

20044_12345 )

参数值与意义:

 

[调用者身份识别id序列]:这个序列标识调用者的身份

额外补充描述:

 

这个识别符序列由支付系统生成并分配，请妥善保管，有了调用者身份识别id序列，您将能够使用支付接口。

 

您可以通过 在线自助申请 或 向人工客服申请 ，获得自己的调用者身份识别id序列。 (客服微信号:ATEAMCN)

-请求参数(必选)-调用者秘钥:

参数名称:

accountKey

参数形式:

字符串

 

(示例:

1ab2ea3949ba59abbe56bc57f20f88cd )

参数值与意义:

 

[32位秘钥]:用于支付接口调用验证的调用秘钥

额外补充描述:

 

请妥善保管支付秘钥，不要随意泄露收款秘钥，以免您的支付接口被他人使用。

-请求参数(必选)-本次支付方式(默认为支付宝支付):

参数名称:

tradeWayType

 

参数形式:

字符串

 

(示例:

wechatPay_2.0 )

参数值与意义:

 

[支付方式]_[金额档位]:本次支付的支付参数

额外补充描述:

 

这个参数包含支付途径和金额档位，示例参数的意义为使用微信支付，支付的金额档位为2.0元档位。

 

2.0元档位不表示准确的2.0元，其真实发生金额为例如2.00、2.01……到2.09元。

 

支付方式表列：

微信扫码支付-wechatPay

支付宝扫码支付-alipay

 

 

例如：

如果您想要发起99元档位的微信扫码收款，参数输入 wechatPay_99.0 即可；

 

如果您想要发起155元档位的微信扫码收款，参数输入 wechatPay_155.0 即可；

 

如果您想要发起50元档位的支付宝扫码收款，参数输入  alipay_50.0 即可；

-请求参数(可选)-本次支付超时时限(默认为90秒)

参数名称:

occupationPeriodTimeLength

参数形式:

字符串

 

(示例:

90)

参数值与意义:

 

[时间长度的整数数值] : 本次支付请求的超时时长(以秒为单位)

 

(最大超时时限应当不小于20秒，不大于300秒)

额外补充描述:

 

这是支付过程占用时间的超时时限，描述了支付过程的最大允许时长，如果在指定时限内完成了付款，服务器将会在同一时刻发起由您指定的回调请求，否则支付无效。

 

(温馨提示:您可以在前端将支付码图案的显示时间与付款倒计时提示设置得比支付超时时限更短，用来防止付款者反应迟钝操作过慢的支付失效，一般情况下 60秒的支付倒计时显示时间 与 90秒的超时时限较为适宜)

-请求参数(可选)-支付成功回调url:

 

参数名称:

callbackUrl

参数形式:

字符串

 

(示例:

http://api.yourUrl.com/yourCallBackFile.php )

参数值与意义:

 

[回调地址]:付款成功后，服务器将向这个url发起回调

额外补充描述:

 

在支付成功后，回调将会发生，ATeamCN支付服务器会将调用者指定的[回调参数]通过post请求的方式发送至调用者指定的url。

(注意：您的回调url务必为与公网连通并且可以访问到的url，请在线上系统进行实验测试，保证可以收到来自回调服务器的post请求。如果实在没有线上服务器测试，您可以使用nat内网穿透工具实现一个可以在公网访问到的url用于临时测试，或者去开通一个云服务器、域名

 

 

诸如"file:///E:/php/WWW/subjectTest.localhost/index.php"这种指向本地的url,是不可以的。像"http://www.yourDomain.com/yourCallBackFile.php"这种可以通过公网访问得到的url才是正确的url)

-请求参数(可选)-支付成功回调Post参数的自定义数据:

 

参数名称:

callbackPostData

参数形式:

字符串

 

(示例:

yourPostParaA=1234&yourPostParaB=%6d%3c%7b%8ab5c1&yourPostParaC=zzzzxxYYC

参数值与意义:

 

[回调参数]:付款成功后，服务器将向回调url发出这些Post参数

额外补充描述:

 

在支付成功后，回调将会发生，ATeamCN支付服务器会将调用者指定的[回调参数]通过post请求的方式发送至调用者指定的url，并发出自定义Post参数。

 

 

-响应数据(必选)-收款响应(字符串格式):

响应数据(必选)-支付二维码的图像源url:

响应数据名称:

(无)

响应数据形式:

字符串

(例如: http://api.paymentSystem.com/test/image_alipay_99.01.png )

响应数据值与意义:

 

[地址] : 这是本次交易支付二维码图像的url

额外补充描述:

 

如果订单创建成功，字符串内容为手机扫码付款二维码图像数据源的url；

如果订单创建失败，地址url的内容为"正在生成付款码……"提示图像的base64字符串数据；

 

在请求正常的情况下，这个url可直接用于向页面中img标签的src属性进行填充

 

(提示: 请求和响应的所有数据均为utf8格式,请求和响应的消息头为:  application/x-www-form-urlencoded; charset=utf-8;  )

如果您有任何问题或需求均可咨询开发工程师客服协助处理。 --客服微信:ATEAMCN (开发工程师)

 

已使用 Microsoft OneNote 2016 创建。