开发者
托管支付接口
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、支付页面内嵌模式
<form action="SERVICE_URL" method="post" target="iframe_name"></form> <iframe name="iframe_name"></iframe>
parent.location.href = url
联系电话
400-9999-359
官方微信