在线咨询
电话 联系电话
400-9999-359
QQ QQ客服
微信 官方微信

Brazil

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="Ebanx" />
<input  type="hidden"  name="ebanxTypeCode"  value="creditcard" />
<input  type="hidden"  name="ebanxcpf"       value="19609461883" />
<form/>

 

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

参数名

类型

长度

是否必填

描述

signInfo

String

64

Yes

【签名数据】

全为小写,各语言加密方式不同,加密的每个字段都需做去空格处理

详见【附录】sha256加密方式

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

paymentMethod

String

2-50

Yes

【支付方式】

Ebanx支付填Ebanx

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

ebanxTypeCode

String

10

Yes

【支付类型】

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

ebanxcpf

String

30

No

【CPF】

支付类型为 directboleto时必填

bankCode

String

2

No

【银行代码】

支付类型为 directboleto,且支付银行为AstroPay时必填

值为:B、SB、BB、CA、I、H、BL

 

3 返回数据

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

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

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

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

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

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

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

 

3.1 推送返回数据

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

参数名

类型

长度

是否必填

描述

EbanxBarCode

String

 

 

【Ebank订单打印码】

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

boletoUrl

String

 

 

【boleto链接】

 

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链接】