在线咨询
电话 联系电话
400-9999-359
QQ QQ客服
微信 官方微信

3方接口

1 注意问题

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

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

Ø 提交字段都需做去空格操作,加密字符串需去空格后加密。

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

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

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

Ø 正式交易接口地址:V1版本:https://{SERVICE_URL}/Interface ;V2版本:https://{SERVICE_URL}/Interface/V2

Ø 测试交易接口地址:V1版本:https://{SERVICE_URL}/TestInterface ;V2版本:https://{SERVICE_URL}/TestInterface/V2

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

 

2 交易流程图

shopify独立站收款跨境收款服务商

 

3 发送数据

示例代码

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

 

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

参数名

类型

长度

是否必填

描述

signInfo

String

64

Yes

【签名数据】

全为小写,各语言加密方式不同,加密的每个字段都需做去空格处理

详见【附录】sha256加密方式

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

paymentMethod

String

2-50

Yes

【支付方式】

如:Credit Card

country

String

100

Yes

【客人的账单国家】

 

请务必使用ISO代码

如美国:US

state

String

100

No

【客人的所在州】

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客服联系进行开通绑定。

 

4 返回数据

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

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

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

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

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

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

 

4.1 推送返回数据:

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

 

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

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

参数名

类型

长度

是否必填

描述

isPush

String

 

 

【是否为推送】

返回数字:1/(空)

(空):非推送

cardNo

String

 

 

【支付卡号】

 411111***1111

authTypeStatus

String

 

 

【是否预授权】

返回数字:0/2

0: 非预授权交易

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

功能具体描述请见 预授权

 

5 支付页面内嵌模式

内嵌模式是指商家网站平台可以通过Iframe嵌入的方式将Asiabill的支付界面展示在商 家的结算网页中,以此实现无需跳转的一站式购物体验。

form表单添加target属性指向iframe name

<form action="SERVICE_URL" method="post" target="iframe_name"></form>
<iframe name="iframe_name" ></iframe>

iframe内实现父级页面跳转js代码

  parent.location.href = url