直连接口

Base_Urlhttps://staging.checkoutgo.top

POST /gateway/DIInterface

Headers

Name
Value

Content-Type

application/json

请求参数:

参数名
类型
长度
必填
描述

merNo

String

5

Yes

【商户号】

gatewayNo

String

8

Yes

【网关接入号】

orderNo

String

50

Yes

【商户订单号】

orderAmount

String

10

Yes

【交易总金额】包括订单的其他所有金额之和. 只能为数字,并且只限小数点后2位小数.

orderCurrency

String

3

Yes

【交易币种】

signInfo

String

64

Yes

【签名数据】明文加密结构:merNo + gatewayNo +orderNo+orderCurrency +orderAmount +firstName+lastName+cardNo+ cardExpireYear + cardExpireMonth+cardSecurityCode +email+ signKey;返回数据为大写,各语言加密方式不同. 具体详见:sha256加密方式

notifyUrl

String

500

Yes

【异步返回地址】用来返回交易结果信息到商户网店 参数返回和returnUrl一致

returnUrl

String

500

Yes

【结果返回地址】 用于3DS认证完成后返回商户结果页面,get请求,返回参数类型为form-data,注意参数说明有加解密行为,请参见付款网关页底部

cardNo

String

200

Yes

卡号. 说明:支付时信用卡的卡号

cardExpireMonth

String

20

Yes

信用卡有效月份 示例:05

cardExpireYear

String

20

Yes

信用卡有效年份 示例:2020

cardSecurityCode

String

100

Yes

信用卡背面签名条一串数字的后 3 位

cardHolderName

String

100

No

【持卡人姓名】

issuingBank

String

255

No

发卡银行

firstName

String

100

Yes

【持卡人的名】

lastName

String

50

Yes

【持卡人的姓】

email

String

200

Yes

【持卡人的邮件】

ip

String

50

Yes

【持卡人的IP】

phone

String

50

Yes

【持卡人的联系电话】

country

String

100

Yes

【持卡人的账单国家】简称. 如美国:US。

state

String

100

Yes

【持卡人的所在州】全称。

city

String

100

Yes

【持卡人的账单城市】全称。

address

String

500

Yes

【持卡人的账单地址】。

zip

String

100

Yes

【持卡人的邮编】。

shipFee

String

100

No

【运费】只能为数字,并且只限小数点后2位小数.

discount

String

100

No

【折扣】折扣默认为负值只能为数字,并且只限小数点后2位小数

goodsInfo

String

5000

Yes

【货物详细信息】 包括货物名称,ID,单价,数量,单个货物信息之间以“#,#”分开,多个货物之间以“#;#”进行分割: Good1-Name #,# Good1-ID#,# Good1-Price #,# Good1-Qty#;# Good2-Name #,# Good2-ID#,# Good2-Price #,# Good2- Qty

shipFirstName

String

100

Yes

【收货人姓】

shipLastName

String

100

Yes

【收货人名】

shipEmail

String

100

Yes

【收货人邮箱】

shipPhone

String

100

Yes

【收货人电话】

shipCountry

String

100

Yes

【收货人国家】简称. 如美国:US

shipState

String

100

Yes

【收货人省份】全称 没有就传N/A

shipCity

String

100

Yes

【收货人城市】全称.

shipAddress

String

500

Yes

【收货人详细地址】

shipZip

String

100

Yes

【收货人邮编】

os

String

50

Yes

【持卡人操作系统】

brower

String

500

Yes

【浏览器】

browerLang

String

50

Yes

【浏览器语言】

acceptHeader

String

500

Yes

【浏览器 accept】

colorDepth

String

10

Yes

【浏览器颜色深度】 以每像素位数为单位,接受值 1, 4, 8, 15, 16, 24, 30, 32 , 48

timezone

String

50

Yes

【时区】 时区偏移 (单位为小时)

resolution

String

50

Yes

【屏幕分辨率】 width x height

javascriptEnabled

Boolean

Yes

【javascript是否可用】

webSite

String

200

Yes

【来源网址】

remark

String

1000

No

【备注】可作为扩展信息.

请求示例,仅作参考:

Response:

参数名
类型
描述

merNo

String

【商户号】

gatewayNo

String

【网关接入号】

tradeNo

String

【交易流水订单号】

orderNo

String

【商户订单号】

orderCurrency

String

【交易币种】

orderAmount

String

【交易金额】

orderStatus

String

【交易状态】返回数字:-2/-1/0/1,-2: 待确认,-1: 待处理,0: 失败,1: 成功

orderInfo

String

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

billAddress

String

【账单地址】支付成功返回交易的账单地址。支付失败则返回空值。

signInfo

String

【数据签名(大写)】signInfo=sha256(merNo + gatewayNo+tradeNo + orderNo + orderCurrency + orderAmount + orderStatus +orderInfo+signkey)

orderErrorCode

String

支付失败返回码

returnType

String

1: 浏览器实时返回2:服务器实时返回3:服务器异步返回

remark

String

【备注】发送数据的时候,传输的什么,就返回什么

redirectUrl

String

【3D重定向URL】如果不为空 则需要重定向完成3DS流程

redirectMethod

String

【3D重定向方法】

响应示例:

Last updated