1. 指引说明

1.1 简介

该操作指引，用于指导代理商/商户如何在自有H5上进行支付。

1.2 使用说明

抖音H5支付与微信H5支付类似，下单成功后返回的是一个支付链接。直接打开这个链接即可跳转抖音支付

支付完成指定回调能力（可选）
H5支付支持商户侧指定支付完成后跳回的APP及跳回后跳转的h5页面。
具体改动如下：

商户侧需要通过统一下单接口拿到的h5_url链接，进行拼接

拼接上支付成功后指定跳转 APP 的 schema 地址，参数名"return_schema"，需要 encodeURIComponent（仅IOS生效）

拼接上支付成功后指定跳转的 h5 页面 url 地址，参数名“return_url”，需要 encodeURIComponent

举例如下：

1. https://cashier.douyinpay.com/bytepay-cashdesk/bytepay-invoke?invoke_scene=inner&prepay_id=dy9pvo8xyxpyop7u7t735u5s41527t5t8uytv101rs5t477vy989q7q5&origin_host=https%253A%252F%252Fwww.douyin.com&return_schema=lark%3A%2F%2F&return_url=https%3A%2F%2Fwww.douyin.com
2. 需要拼接:&return_schema=lark%3A%2F%2F&return_url=https%3A%2F%2Fwww.douyin.com

生效范围：

return_schema，支持跳转指定APP

Android系统不需要拼接（拼接了也没用），支持自动回跳

iOS系统需要拼接，拼接后跳转指定app

return_url，在商户APP里打开的抖音支付H5中间页跳转至业务的指定页面

双端生效

常见技术问题：
Q：调起H5支付报“订单超时，请重新下单”
A：H5下单返回的h5_url的有效期为5分钟，若超过有效期，需要原单重新请求下单接口以获取新的生成h5_url。

Q：调起H5支付报“缺少token参数”
A：一般为抖音APP版本太低导致，升级到最新版本即可。

Q：调起H5支付，客户端所需的schema协议前缀是什么
A：目前抖音支付支持抖音端，抖音极速端和抖音火山端拉起支付，详细见下：

iOS：
抖音端：dypay1128://cjpay/dypay
抖音极速端：dypay2329://cjpay/dypay
抖音火山端：dypay8663://cjpay/dypay

Android：
抖音端：ttcjpay://dypay/cashier
抖音极速端：ttcjpay://dypay/awemelite
抖音火山端：dypay8663://dypay/cashier

Q：H5支付如何支持支付成功后返回至指定页面？
A：H5支付支持商户侧指定支付完成后跳回的APP及跳回后跳转的h5页面
1、商户侧需要拿到H5下单接口返回的h5_url链接，进行拼接
2、拼接上支付成功后指定跳转 APP 的 schema 地址，参数名"return_schema"，需要 encodeURIComponent（仅IOS生效）
3、拼接上支付成功后指定跳转的 H5 页面 url 地址，参数名“return_url”，需要 encodeURIComponent
【举例如下】

Q：调起H5支付时出现 “鉴权失败，请重试”报错，该如何排查？
A：出现该错误时说明发起支付页面非配置的H5支付域名，获取已配置的域名后，请检查以下是否与该域名完全一致：
1、检查支付发起页面的域名

确认您当前集成并调起H5支付的网页，其地址栏中的域名（不含http:// 或 https://）是否与商户平台中配置的H5支付域名完全一致。

2、如果是APP内调起H5支付
APP里调起H5支付，需要在webview中手动设置referer，如(Map extraHeaders = new HashMap();extraHeaders.put("Referer", "商户申请H5时提交的授权域名"); //例如 https://www.****.com ) 。需要注意当前调起H5支付的域名（抖音侧从referer中获取）与申请H5支付时提交的授权域名是否一致
如果检查发现不一致，请将相关域名修改为与配置完全一致的域名后重试，或联系商务添加或修改授权域名

3.1.9【抖音】H5交易指引

1. 指引说明#

1.1 简介#

1.2 使用说明#

1. 指引说明

1.1 简介

1.2 使用说明