1、前期准备
This is how you use a card with an icon and a link. Clicking on this card
brings you to the home page.2、申请账号
Lorem ipsum dolor sit amet, consectetur adipiscing elit3、代码对接
Ut enim ad minim veniam, quis nostrud exercitation ullamco4、正式上线
Excepteur sint occaecat cupidatat non proident一、接入前条件准备#
| 类型 | 描述 |
|---|
| merchantId | 商户ID,商户唯一标识 |
| merchantKey | 商户密钥,参与MD5签名生成加密,验证数据有效性 |
二、嵌入式收银台下单接口#
订单支付页面引入 Javascript SDK 文件(支付页面渲染、3DS验证需要)
说明: 支付请求是交易请求方(如商家、支付网关)与goshopay之间的交易信息通过API接口请求进行传递的交易,是一种异步的、需要用户参与完成的交易方式。支付成功后,goshopay平台会给商家发送后台通知,商家方务必实现接收后台通知接口,以便同步订单支付状态,该嵌入式API模式仅根据需要渲染页面(页面遮罩、loading等),不会发生URL跳转(支付成功后才发生重定向)。
三、收银台下单请求#
| 参数 | 类型 | 必填 | 描述 |
|---|
| merchantId | String | 是 | 商户ID |
| signature | String | 是 | 签名验证,32位大写MD5 |
| orderBody | JsonObject | 是 | 请求体数据对象 |
| version | String | 否 | API版本,默认值: 1.0 |
| shopId | String | 否 | 店铺ID |
signature : MD5签名32位大写,使用了订单请求体(orderBody)JSON字符串拼接商户密钥得到结果字符串再执行MD5(orderBody+merchantKey)
举例:MD5(JSON.stringify(orderBody)+merchantKey)
PHP开发工具温馨提示:
PHP开发转为json字符串时请指定额外参数
JSON_UNESCAPED_SLASHES|JSON_UNESCAPED_UNICODE
举例如下:
json_encode($param["orderBody"],JSON_UNESCAPED_SLASHES|JSON_UNESCAPED_UNICODE)
:::
订单请求体JSON对象(orderBody)包含如下信息:| 参数 | 名称 | 类型 | 必填 | 描述 |
|---|
| merOrderNo | 商户订单号 | String | 是 | 商户平台订单号或者订单ID,平台支付状态回调时携带此参数 |
| merAmount | 订单金额 | String | 是 | 小数点后最多两位,如"145.50" |
| merCurrency | 订单币种 | String | 是 | ISO 4217标准的3个字母 |
| notifyUrl | 支付回调URL | String | 是 | 接收支付结果通知的URL地址 |
| notifyJumpUrl | 重定向URL | String | 是 | 支付成功后自动跳转商户重定向URL |