接口名称

接口描述

payOrder

SDK 提供支付的对象接口

方法原型

- (void)payOrder:(NSString *)externalInfo
fromScheme:(NSString *)schemeStr
callback:(CompletionBlock)completionBlock;

方法功能

提供给商户订单支付功能

方法参数

String externalInfo 支付参数详见 1.3.2
调用支付的 app 注册在 info.plist 中的 scheme(暂时无用)
Key=”value”形式，以&连接

返回值

支付回调 completionBlock,resData 支付返回参数详见 1.4

参数名

类型

长度

是否必填

描述

merNo

String

5

Yes

【商户号】

gatewayNo

String

8

Yes

【网关接入号】

orderNo

String

50

Yes

【商户订单号】

在该订单号是成功/待处理/待确认的状

态下,不允许再次抛送此订单号。

orderCurrency

String

3

Yes

【交易币种】

详见【附录】交易币种(ISO 4217)

orderAmount

String

10

Yes

【交易金额】

应为小数点后2位小数。

returnUrl

String

500

Yes

【交易返回地址】

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

signInfo

String

64

Yes

【签名数据】

全为小写,sha256加密方式。

加密方式可参考SDK 加密机制。

paymentMethod

String

20

Yes

【支付方式】

银联卡：UnionPay

国外信用卡：Credit Card

海外本地支付：Yandex、Ebanx...

firstName

String

2-100

Yes

【客人的名】

长度必须在2-100之间。否则不能交易。

lastName

String

2-50

Yes

【客人的姓】

长度必须在2-50之间。否则不能交易。

email

String

2-200

Yes

【客人的邮件】

长度必须在2-200之间。否则不能交易。

phone

String

2-50

Yes

【客人的联系电话】

长度必须在2-50之间。否则不能交易。

country

String

100

Yes

state

String

100

No

【客人的所在州】

city

String

100

Yes

【客人的账单城市】

address

String

500

Yes

【客人的账单地址】

zip

String

100

Yes

【客人的邮编】

isMobile

Int

1

Yes

【客户端类型】

0：PC端

1：移动端

如需使用移动端支付页面，需联系Asiabill客服联系进行开通绑定。

productName

String

50

No

【商品名称】

customerID

String

200

No

【客户 ID】

deviceInfo

String

50

No

【终端设备信息】

payType

String

2

Yes

【支付类型】

0：网关 wap 支付

1：Asiabill账户wap支付

2：Asiabill账户app支付

参数名

类型

长度

是否可空

描述

code

String

No

【业务错误码】

详见【附录】 业务错误码表

message

String

No

【描述】

详见【附录】 业务错误码表

optional

detailCode

String

Yes

【返回代码】

详见【附录】 返回代码表

detailMessage

String

Yes

【详细信息】

Asiabill服务器对支付订单信息的详细描述

参数名

类型

长度

是否必填

描述

merNo

String

5

Yes

【商户号】

gatewayNo

String

8

Yes

【网关接入号】

tradeNo

String

【交易流水订单号】

orderNo

String

【商户订单号】

orderCurrency

String

【交易币种】

orderAmount

String

【交易金额】

cardNo

String

【支付卡号】

411111***1111

orderStatus

String

【交易状态】

返回数字：-1/0/1

-1: 待处理0: 失败

1: 成功

orderInfo

String

【交易结果信息】

Code+具体信息。

orderInfo

String

【交易结果信息】
Code+具体信息。

authTypeStatus

String

【是否预授权】
返回数字：0/2
0: 非预授权交易
2: 预授权交易(待处理)

signInfo

String

【签名数据】

返回数据为大写.各语言加密方式不同,

加密方式可参考SDK 加密机制。

明文加密结构：merNo + gatewayNo + tradeNo + orderNo + orderCurrency + orderAmount + orderStatus + orderInfo + signkey

riskInfo

String

【风控信息】

返回顺序格式（都是MaxMind返回）：

|未过风控 |已过风控 |累加总分数 |设置总分数 |MAXMIND返回分数 |发卡行 |发卡行国家 |国家间隔距离 |持卡人IP |持卡人IP所在国家 |

remark

String

【备注】

发送数据的时候，传输的什么，就返回什么。

EbankBarCode

String

【Ebank 订单打印码】

Ebank 本地支付方式才用到,此参数。

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

接收这个值之后，可以在页面生成https://www.ebanx.com/pay/ws/boleto/printHTML?hash=XXX ,XXX就是这个EbankBarCode 的值,这样持卡人可根据链接直接打开到打印订单的页面。