Ebanx

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="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="Ebanx" />
<input  type="hidden"  name="ebanxName"      value="asiabill" />
<input  type="hidden"  name="ebanxEmail"     value="support@asiabill.com" />
<input  type="hidden"  name="ebanxTypeCode"  value="creditcard" />
<input  type="hidden"  name="ebanxcpf"       value="19609461883" />
<form/>

 

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

参数名

类型

长度

是否必填

描述

returnUrl

String

500

Yes

【交易返回地址】

Asiabill处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径,用于推送和抛送返回。

signInfo

String

64

Yes

【签名数据】

全为小写,各语言加密方式不同,

详见【附录】sha256加密方式

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

paymentMethod

String

2-50

Yes

【支付方式】

Ebanx支付填Ebanx

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

ebanxName

String

50

Yes

【注册名称】

ebanxEmail

String

100

Yes

【注册邮箱】

ebanxTypeCode

String

10

Yes

【支付类型】

可输入值:boleto、creditcard、_tef、directboleto

ebanxcpf

String

30

Yes

【CPF】

 

3 返回数据

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

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

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

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

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

如需开启推送功能请联系技术支持。

注意事项:① 商户需要能处理重复推送。

                 ② 启用CDN可能会照成服务器无法接收到推送数据。

                 ③ 使用Nginx服务器可能会因为某些设置导致无法接收到推送数据。

 

3.1 推送返回数据

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

参数名

类型

长度

是否必填

描述

EbankBarCode

String

【Ebank订单打印码】

用于方便客人打印订单页面.

 

3.2 抛送返回数据

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

参数名

类型

长度

是否必填

描述

isPush

String

【是否为推送】

返回数字:1/(空)

(空):非推送

cardNo

String

【支付卡号】

411111***1111

orderInfo

String

【交易结果信息】

Code+具体信息。

authTypeStatus

String

【是否预授权】

返回数字:0/2

0: 非预授权交易

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

功能具体描述请见 预授权

EbankBarCode

String

【Ebank订单打印码】

用于方便客人打印订单页面.

接收这个值之后,可以在页面生成

https://api.ebanx.com/ws/boleto/printHTML?hash=XXX,

XXX就是这个EbankBarCode的值,这样持卡人可根据链接直接打开到打印订单的页面.