开发者
本地支付
1、注意问题
- 连接本系统测试接口，则所有的交易都不会产生费用，不能划款。
- 请商户按照下表中的字段名称提交字段，参数名称区分大小写。
- 提交字段都需做去空格操作，加密字符串需去空格后加密。
- 发送本系统网关的指令均以POST方式发送，并且使用UTF8编码格式。
- 测试状态只能提交到测试的URL，正式状态只能提交到正式的URL，否则不能进行交易。
- 由测试状态转成正式状态后就必须提交到正式接口，此过程不可逆。
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="country" value="BR" />
<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="Boleto" />
<form/>
|
参数名 |
类型 |
长度 |
是否必填 |
描述 |
|
signInfo |
String |
64 |
Yes |
【签名数据】 全为小写，各语言加密方式不同,加密的每个字段都需做去空格处理 详见【附录】sha256加密方式。 明文加密结构：merNo + gatewayNo + orderNo + orderCurrency+ orderAmount + returnUrl + signkey |
|
paymentMethod |
String |
2-50 |
Yes |
填入下方列表中的支付方式代码，例如 使用Boleto Bancàrio支付方式就填入Boleto |
|
country |
String |
2 |
Yes |
【客人的账单国家】
请务必使用ISO代码，限定为两位 如巴西：BR |
|
state |
String |
100 |
No |
【客人的所在州】 支付类型为 creditcard、directboleto时必填 |
|
city |
String |
100 |
No |
【客人的账单城市】 支付类型为 creditcard、directboleto时必填 |
|
address |
String |
500 |
No |
【客人的账单地址】 支付类型为 creditcard、directboleto时必填 |
|
zip |
String |
100 |
No |
【客人的邮编】 支付类型为 creditcard、directboleto时必填 |
|
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值来区分推送与抛送返回数据。
如需开启推送功能请联系技术支持。
注意事项：商户需要能处理重复推送。
3.1、推送返回数据
3.2、 抛送返回数据
|
参数名 |
类型 |
长度 |
是否必填 |
描述 |
|
isPush |
String |
|
|
【是否为推送】 返回数字：1/(空) (空)：非推送 |
|
cardNo |
String |
|
|
【支付卡号】 411111***1111 |
|
orderInfo |
String |
|
|
【交易结果信息】 Code+具体信息。 |
|
authTypeStatus |
String |
|
|
【是否预授权】 返回数字：0/2 0: 非预授权交易 2: 预授权交易(待处理) 功能具体描述请见 预授权 |
|
EbanxBarCode |
String |
|
|
【Ebank订单打印码】 用于方便客人打印订单页面. 接收这个值之后，可以在页面生成 https://api.ebanx.com/ws/boleto/printHTML?hash=XXX, XXX就是这个EbankBarCode的值,这样持卡人可根据链接直接打开到打印订单的页面. |
|
boletoUrl |
String |
|
|
【boleto链接】 |
联系电话
400-9999-359
官方微信