3方接口

1 注意问题

Ø 连接本系统测试接口,则所有的交易都不会产生费用,不能划款。

Ø 请商户按照下表中的字段名称提交字段,参数名称区分大小写。

Ø 发送本系统网关的指令均以POST方式发送,并且使用UTF8编码格式。

Ø 测试状态只能提交到测试的URL,正式状态只能提交到正式的URL,否则不能进行交易。

Ø 由测试状态转成正式状态后就必须提交到正式接口,此过程不可逆。

Ø 技术支持: 邮箱 php-01@asiabill.com, php-02@asiabill.com

 

2 发送数据

示例代码

<form  action="SERVICE_URL"  method="post" >
<input  type="hidden"  name="merNo"          value="99999" />
<input  type="hidden"  name="gatewayNo"      value="99999001" />
<input  type="hidden"  name="orderNo"        value="123456789" />
<input  type="hidden"  name="orderCurrency"  value="EUR" />
<input  type="hidden"  name="orderAmount"    value="98" />
<input  type="hidden"  name="signInfo"       value="4B8FA15BBCA0A22F3FDB" />
<input  type="hidden"  name="returnUrl"      value="http://bai.com/result.php" />
<input  type="hidden"  name="firstName"      value="Eva" />
<input  type="hidden"  name="lastName"       value="Tan" />
<input  type="hidden"  name="email"          value="test@Asiabill.com" />
<input  type="hidden"  name="phone"          value="075525846758" />
<input  type="hidden"  name="paymentMethod" value="Credit Card" />
<input  type="hidden"  name="country"        value="US" />
<input  type="hidden"  name="state"        value="Tennessee" />
<input  type="hidden"  name="city"           value="Collierville" />
<input  type="hidden"  name="address"        value="110 North Tree Drive" />
<input  type="hidden"  name="zip"             value="38017" />
<form />

 

基础发送数据请参考【基础支付接口】 基础发送数据

参数名

类型

长度

是否必填

描述

returnUrl

String

500

Yes

【交易返回地址】

Asiabill处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径,用于推送和抛送返回。

callbackUrl

String

500

No

【后台通知地址】

当传了此值则预授权结果及清算结果等通知使用该URL通知

signInfo

String

64

Yes

【签名数据】

全为小写,各语言加密方式不同,

详见【附录】sha256加密方式

明文加密结构:merNo + gatewayNo + orderNo + orderCurrency+ orderAmount + returnUrl + signkey

country

String

100

Yes

【客人的账单国家】

请务必使用ISO代码

如美国:US

state

String

100

Yes

【客人的所在州】

city

String

100

Yes

【客人的账单城市】

address

String

500

Yes

【客人的账单地址】

zip

String

100

Yes

【客人的邮编】

interfaceInfo

String

50

No

【网店程序】

例如:zencart,magento,opencart

,prestashop,asp,java,.net等。

interfaceVersion

String

50

No

【插件版本】

例如:V2.0 , V2.1 等。

如果是自己开发的网店则用最后修改日期命名,如:2013-08-01 。

isMobile

Int

1

No

【客户端类型】

0:PC端

1:移动端

如需使用移动端支付页面,需联系Asiabill客服联系进行开通绑定。

 

3 返回数据

每笔交易都进行两次数据返回,返回顺序为先推送返回后抛送返回。

① 推送返回:是服务器到服务器之间的数据返回。

② 抛送返回:通过浏览器重定向返回的数据返回。

可能会因为网络等因素出现抛送返回数据接收不到的情况,所以增加了推送返回来保证商户可以接收到返回数据。

通过isPush值来区分推送与抛送返回数据。

说明:推送地址和抛送地址是根据传递参数 returnUrl 的值进行传输的。

 

3.1 推送返回数据:

返回数据请参考【支付结果通知】

 

3.2 抛送返回数据(浏览器POST返回)

基础返回数据请参考【基础支付接口】 基础返回数据

参数名

类型

长度

是否必填

描述

isPush

String

【是否为推送】

返回数字:1/(空)

(空):非推送

cardNo

String

【支付卡号】

 411111***1111

authTypeStatus

String

【是否预授权】

返回数字:0/2

0: 非预授权交易

2: 预授权交易(待处理)

功能具体描述请见 预授权