文档中心 商家相关 获取SSO跳收银台URL

获取SSO跳收银台URL

1.使用场景

供应商员工在自身页面下单,唤起关爱通收银台,需要把免登和跳转收银台放在一步完成

3.接口调用说明

请求URL

https://openapi.guanaitong.tech/seller/pay/sso/getExCashierUrl

HTTP请求方式

POST,GET

输入参数说明

(1)私有参数

参数名称 是否必须 参数类型 长度限制 描述
outer_trade_no string [1-40] 交易号,必须以商家appId开头
corp_code string [1-20] 员工工号
enterprise_code string [1,20] 企业编号(集团和运营商同步)
reason string [1,254] 原因
cost_amount decimal - 成本价
total_amount decimal - 总价,一般和成本价一致
return_url string 254 页面返回地址,只有成功才会跳转,签名规则与请求的规则一致,客户端可以通过通过密钥验签,返回参数包括[appid,outer_trade_no,attach,pay_result,timestamp,sign]
notify_url string 254 服务器通知地址,只有成功时才会通知,签名规则与请求的规则一致,客户端可以通过通过密钥验签,返回参数包括[appid,outer_trade_no,buyer_open_id,attach,total_amount,trade_no,timestamp,sign],其中trade_no是关爱通内部业务号,与外部的outer_trade_no对应。通知间隔时间段【4分钟,4分钟,10分钟,10分,1小时,2小时,6小时,15小时】,之后不再通知,请使用订单查询接口
请求示例
POST /seller/pay/sso/getExCashierUrl HTTP/1.1
Host: openapi.guanaitong.tech

corp_code=&cost_amount=&total_amount=outer_trade_no=&reason=
正确返回示例
{
    code: 0
    msg: "OK"
    data: "https://passport.guanaitong.tech/trustLogin?auth_code=b510f542d509****9198928af5fb1193&redirect_url=https://excashier.guanaitong.tech/entry?reason=%E4%B8%8D%E7%9F%A5%E9%81%93&outer_trade_no=201109711603680333000000001&owner_id=_FS002_0000002&sign=D1407E4D19357C136A92C51F78A87E986E2BE4F8&source_appid=20110971&signtype=SHA1¬ify_url=https%3A%2F%2Fopenapi.guanaitong.tech%2Fseller%2Fpay%2FnotifyUrl&type=1&encoding=UTF-8&output=JSON&point_payer_id=_FS002_0000002&total=0.01&issync=2&apiname=gat.account.pay&v=3.0&appid=20110971&cost_point=0.01&return_url=https%3A%2F%2Fopenapi.guanaitong.tech%2Fseller%2Fpay%2FreturnUrl&point_payee_id=fsseller×tamp=20201026104534&skipLoginCheck=2"
}
服务端拿到地址传给客户端,客户端可以在20秒之内302直接跳关爱通收银台,本地址仅能使用一次