基础支付接口
1 注意问题
Ø 该基础支付接口版本为V2
Ø 该章节提供为支付接口公共发送和返回数据。
Ø 请商户按照下表中的字段名称提交字段，参数名称区分大小写。
Ø 提交字段都需做去空格操作，加密字符串需去空格后加密。
Ø 发送本系统网关的指令均以POST方式发送，并且使用UTF8编码格式。
Ø 请联系专属客服获取接口联调信息及技术支持。
Ø post请求需指定Content-Type: application/x-www-form-urlencoded。
2 基础发送数据
|
参数名 |
类型 |
长度 |
是否必填 |
描述 |
|
merNo |
String |
5 |
Yes |
【商户号】 |
|
gatewayNo |
String |
8 |
Yes |
【网关接入号】 |
|
orderNo |
String |
50 |
Yes |
【商户订单号】 在该订单号是成功/待处理/待确认的状 态下,不允许再次抛送此订单号。 |
|
orderCurrency |
String |
3 |
Yes |
【交易币种】 |
|
orderAmount |
String |
10 |
Yes |
【交易金额】 支持整数、小数（小数点后最多两位）。 |
|
firstName |
String |
1-100 |
Yes |
【客人的名】 长度必须在1-100之间。否则不能交易。 |
|
lastName |
String |
1-50 |
Yes |
【客人的姓】 长度必须在1-50之间。否则不能交易。 |
|
|
String |
2-200 |
Yes |
【客人的邮件】 长度必须在2-200之间。否则不能交易。 |
|
phone |
String |
2-50 |
Yes |
【客人的联系电话】 长度必须在2-50之间。否则不能交易。 |
|
paymentMethod |
String |
1-100 |
Yes |
【支付方式】 支付方式代码请参考具体支付接口 |
|
shipFirstName |
String |
50 |
No |
【收件人的名】 |
|
shipLastName |
String |
50 |
No |
【收件人的姓】 |
|
shipPhone |
String |
50 |
No |
【收件人的联系电话】 |
|
shipCountry |
String |
50 |
No |
【收件人的国家】 |
|
shipState |
String |
50 |
No |
【收件人的州】 |
|
shipCity |
String |
50 |
No |
【收件人的城市】 |
|
shipAddress |
String |
100 |
No |
【收件人的地址】 |
|
shipZip |
String |
50 |
No |
【收件人的邮编】 |
|
returnUrl |
String |
1000 |
Yes |
【交易返回地址】 Asiabill处理完请求后，自动跳转到请求参数中的returnUrl地址。 |
|
callbackUrl |
String |
1000 |
No |
【后台通知地址】 当传了此值则异步通知使用该URL通知 |
|
remark |
String |
500 |
No |
【备注】 可作为扩展信息，提交什么就返回什么。 |
3 基础返回数据
|
参数名 |
类型 |
长度 |
是否必填 |
描述 |
|
merNo |
String |
5 |
Yes |
【商户号】 |
|
gatewayNo |
String |
8 |
Yes |
【网关接入号】 |
|
tradeNo |
String |
|
|
【交易流水订单号】 |
|
orderNo |
String |
|
|
【商户订单号】 |
|
orderCurrency |
String |
|
|
【交易币种】 |
|
orderAmount |
String |
|
|
【交易金额】 |
|
orderStatus |
String |
|
|
【交易状态】 返回数字：-1/0/1 -1: 待处理0: 失败 1: 成功 |
|
orderInfo |
String |
|
|
【交易结果信息】 |
|
signInfo |
String |
|
|
【签名数据】 返回数据为大写.各语言加密方式不同, 详见【附录】sha256加密方式。 明文加密结构：merNo + gatewayNo + tradeNo + orderNo + orderCurrency + orderAmount + orderStatus + orderInfo + signkey |
|
riskInfo |
String |
|
|
【风控信息】 返回顺序格式（都是MaxMind返回）： |未过风控 |已过风控 |累加总分数 |设置总分数 |MAXMIND返回分数 |发卡行 |发卡行国家 |国家间隔距离 |持卡人IP |持卡人IP所在国家 | |
|
remark |
String |
|
|
【备注】 发送数据的时候，传输的什么，就返回什么。 |
