产品介绍

简介

JSAPI支付是指商户通过调用甬易支付提供的JSAPI接口，在支付场景中唤起甬易支付收银台完成收款。

应用场景

• 商户已有网站或者其他应用时，可以调用甬易支付完成下单购买。具体操作流程如下：

  步骤一 ：用户登入商家应用，选择商品，完成选购流程。

  步骤二 ：唤起甬易支付控件，用户输入支付密码。

  步骤三 ：密码验证通过，支付完成。

分账说明

1. 发起交易时，可传入分账接收方的信息以及分账金额，分账成功后资金实时入账接收方账户，如分账失败则该笔交易同样失败；

2. 每笔交易最多可向5个接收方发起分账；

   注：如发起交易时未传分账接收方信息，则该笔交易默认不分账，交易金额正常结算。

接入前准备

在正式接入甬易支付JSAPI服务前，你需要进行以下准备步骤：

接入角色

• 直连商户或直连服务商
  1. 申请应用AppID；
  2. 开发信息配置；
  3. 能力签约。

入驻模式

自行入驻甬易支付开放平台，认证成为直连商户或直连服务商。

申请应用APPID

1. 入驻开放平台成功后，通过【产品服务】—【应用管理】内创建应用。
2. 创建成功后，应用审核通过即可生成应用APPID。

开发信息配置

路径：应用详情—开发信息配置； 配置类型：密钥、授权回调地址、回调地址、IP白名单、域名白名单

密钥管理

必填。 用于防止数据篡改，保障应用与甬易支付交互的安全性；

授权回调地址

必填。 向甬易后台获取用户授权码后，由甬易后台重定向回该授权回调地址。配置授权回调地址后，能避免用户授权信息被窃取的风险。

注：支持配置多个授权回调地址，例如：https://open.yoyipay.com

回调地址

选填。 回调地址可用于接收异步通知，例：支付通知、消息推送等等；

注：支持配置多个回调地址。如未配置不作校验。例如：https://open.yoyipay.com

出口IP白名单

选填。 用于提高应用访问甬易服务的安全性，避免因应用私钥泄漏等原因导致业务受损，保障用户资金安全；

注：支持配置多个出口IP，如未配置则默认不做拦截。

域名白名单配置

必填。 配置域名白名单后，开发者可在该域名下调用甬易支付的接口；

注：支持配置多个域名，如未配置则不可访问甬易支付接口。填写的域名须通过ICP备案的验证。

签约流程

直连商户或直连服务商可通过开放平台 【产品中心】—【应用管理】点击【能力申请】，进入后可手动签约相关能力，部分能力需上传特殊资质，能力签约审核成功后即可调用该接口。

相关能力与API接口

所属能力	类型	接口	描述
JSAPI支付	API接口	JSAPI下单	调用该接口进行预下单，生成支付订单
JSAPI支付	API接口	交易查询	主动查询订单状态
JSAPI支付	API接口	关闭订单	调用该接口关闭未交易终止的订单
JSAPI支付	API接口	退款申请	调用该接口对交易成功的订单进行退款操作
JSAPI支付	API接口	单笔退款查询	主动查询退款订单的状态与信息等
JSAPI支付	异步回调通知	交易结果通知	异步通知交易结果