Ø 连接本系统测试接口,则所有的交易都不会产生费用,不能划款。
Ø 请商户按照下表中的字段名称提交字段,参数名称区分大小写。
Ø 提交字段都需做去空格操作,加密字符串需去空格后加密。
Ø 发送本系统网关的指令均以POST方式发送,并且使用UTF8编码格式。
Ø 测试状态只能提交到测试的URL,正式状态只能提交到正式的URL,否则不能进行交易。
Ø 由测试状态转成正式状态后就必须提交到正式接口,此过程不可逆。
<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="country" type="hidden" value="BR" /> <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_Brazil" /> </form>
基础发送数据请参考【基础支付接口】 基础发送数据
参数名 |
类型 |
长度 |
是否必填 |
描述 |
signInfo |
String |
64 |
Yes |
【签名数据】 全为小写,各语言加密方式不同,加密的每个字段都需做去空格处理 详见【附录】sha256加密方式。 明文加密结构:merNo + gatewayNo + orderNo + orderCurrency+ orderAmount + returnUrl + signkey |
paymentMethod |
String |
2-50 |
Yes |
【支付方式】 Credit_Card_Brazil、Boleto |
country |
String |
2 |
Yes |
【客人的账单国家】
请务必使用ISO代码,限定为两位 如巴西:BR |
state |
String |
100 |
No |
【客人的所在州】 |
city |
String |
100 |
No |
【客人的账单城市】 |
address |
String |
500 |
No |
【客人的账单地址】 |
zip |
String |
100 |
No |
【客人的邮编】 |
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客服联系进行开通绑定。 |
每笔交易都进行两次数据返回,返回顺序为先推送返回后抛送返回。
推送返回:是服务器到服务器之间的数据返回。
抛送返回:通过浏览器重定向返回的数据返回。
可能会因为网络等因素出现抛送返回数据接收不到的情况,所以增加了推送返回来保证商户可以接收到返回数据。
通过isPush值来区分推送与抛送返回数据。
如需开启推送功能请联系技术支持。
注意事项:商户需要能处理重复推送。
基础返回数据请参考【支付结果通知】
参数名 |
类型 |
长度 |
是否必填 |
描述 |
boletoUrl |
String |
|
|
【boleto链接】 |
基础返回数据请参考【基础支付接口】 基础返回数据
参数名 |
类型 |
长度 |
是否必填 |
描述 |
isPush |
String |
|
|
【是否为推送】 返回数字:1/(空) (空):非推送 |
cardNo |
String |
|
|
【支付卡号】 411111***1111 |
orderInfo |
String |
|
|
【交易结果信息】 Code+具体信息。 |
authTypeStatus |
String |
|
|
【是否预授权】 返回数字:0/2 0: 非预授权交易 2: 预授权交易(待处理) 功能具体描述请见 预授权 |
boletoUrl |
String |
|
|
【boleto链接】 |