1 注意问题

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

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

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

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

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

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

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

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

Ø 技术支持： 邮箱 php-01@asiabill.com， php-02@asiabill.com

 

2 交易流程图

 

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" />
	<input name="goods_detail" type="hidden" value='[{"productName":"Ipad min","quantity":1,"price":2399.00}, {"productName":"Ipad","quantity":2,"price":2799.00}]' />
</form>

 

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

参数名	类型	长度	是否必填	描述
signInfo	String	64	Yes	【签名数据】 全为小写，各语言加密方式不同,加密的每个字段都需做去空格处理 详见【附录】sha256加密方式。 明文加密结构：merNo + gatewayNo + orderNo + orderCurrency+ orderAmount + returnUrl + signkey
paymentMethod	String	1-100	Yes	【支付方式】 如：Credit Card
country	String	2-100	Yes	【客人的账单国家】   请务必使用ISO代码 如美国：US
state	String	100	No	【客人的所在州】 当国家是美国或加拿大时必输。 使用ISO-3166-2:US或ISO -3166-2:CA 中该国家地区编码标准中的两位字母编码
city	String	2-100	Yes	【客人的账单城市】
address	String	2-500	Yes	【客人的账单地址】
zip	String	100	No	【客人的邮编】
interfaceInfo	String	100	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客服联系进行开通绑定。
goods_detail	String	--	No	【商品信息】 包含商品明细，商品明细不得超过10个 商品明细： 商品名称 - productName 商品数量 - quantity 商品价格 - price 注： 商品名称中出现"&", "<", ">", "\"", "'","|"特殊字符会被转义 商品名称不得超过130个字符 商品数量和商品价格不得超过10个字符 提交时，json值需要用单引号包裹，否则信息会被切断 设置案例： value='[{"productName":"Ipad min","quantity":1,"price":2399.00}, {"productName":"Ipad","quantity":2,"price":2799.00}]'

 

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