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

基础支付接口

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

【交易币种】

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

orderAmount

String

10

Yes

【交易金额】

应为小数点后2位小数。

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之间。否则不能交易。

paymentMethod

String

2-50

Yes

【支付方式】

支付方式代码请参考具体支付接口

shipFirstName

String

100

No

【收件人的名】

shipLastName

String

50

No

【收件人的姓】

shipPhone

String

50

No

【收件人的联系电话】

shipCountry

String

100

No

【收件人的国家】

shipState

String

100

No

【收件人的州】

shipCity

String

100

No

【收件人的城市】

shipAddress

String

500

No

【收件人的地址】

shipZip

String

100

No

【收件人的邮编】

returnUrl

String

500

Yes

【交易返回地址】

Asiabill处理完请求后,自动跳转到请求参数中的returnUrl地址。

callbackUrl

String

500

No

【后台通知地址】

当传了此值则异步通知使用该URL通知

remark

String

1000

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

 

 

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

signInfo

String

 

 

【签名数据】

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

详见【附录】sha256加密方式

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

riskInfo

String

 

 

【风控信息】

返回顺序格式(都是MaxMind返回):

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

remark

String

 

 

【备注】

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

 

基础支付接口(V1)