1.1.8 • Published 8 months ago

ep-open-tool-h5 v1.1.8

Weekly downloads
-
License
MIT
Repository
gitlab
Last release
8 months ago

ep-open-tool-h5

蚂蚁因公付对外-移动端 H5 SDK

蚂蚁通用场景钱包对外-移动端 H5 SDK

蚂蚁网商场景钱包对外-移动端 H5 SDK

二方支卡通-移动端 H5 SDK


Badges

TNPM version TNPM downloads node >=14.0.0


Usage

依赖安装

npm i ep-open-tool-h5 --save

蚂蚁因公付对外-移动端 H5 SDK

因公付-员工侧支付宝端内签约

仅获取签约地址

import { EntPay } from 'ep-open-tool-h5';

const signUrl = EntPay.Staff.getSignUrl({
  bizSceneCode: '接入时约定的bizSceneCode',
  accountId: '企业的id',
});

方法参数说明

signParam 内容字段说明类型默认值是否必填
bizSceneCode接入时约定的 bizSceneCodestring
accountId企业的 idstring
returnUrl签约完成之后的回跳地址string
specificId跳转支付宝时,需要指定支付宝账户时传入string

自动跳转到支付端内签约页面

// 跳转员工端签约页面
EntPay.Staff.goToSign({
  bizSceneCode: '接入时约定的bizSceneCode',
  accountId: '企业的id',
});

完整使用:EntPay.Staff.goToSign( signParams, options)

signParam 内容字段说明类型默认值是否必填
bizSceneCode接入时约定的 bizSceneCodestring
accountId企业的 idstring
returnUrl签约完成之后的回跳地址string
specificId跳转支付宝时,需要指定支付宝账户时传入string
options 内容字段说明类型默认值是否必填
outAlipay是否在支付端 app 端外,默认 truebooleantrue
openNewPage是否打开一个新页面,默认 truebooleantrue

跳转到支付宝端内扫一扫

// 跳转到支付宝端内扫一扫
EntPay.Staff.goToScanPage({
  accountId: '企业的id',
});

// 如果只是要获取支付宝扫一扫的链接,可以直接调用getScanPageUrl方法获取
const scanPageUrl = EntPay.Staff.getScanPageUrl({
  accountId: '企业的id',
});

完整使用:EntPay.Staff.goToScanPage( accountInfo, options)

accountInfo 内容字段说明类型默认值是否必填
accountId企业的 idstring
specificId跳转支付宝时,需要指定支付宝账户时传入string
options 内容字段说明类型默认值是否必填
outAlipay是否在支付端 app 端外,默认 truebooleantrue
openNewPage是否打开一个新页面,默认 truebooleantrue

跳转到支付宝端内付款码

// 跳转到支付宝端内扫一扫
EntPay.Staff.goToPayCodePage({
  accountId: '企业的id',
});

// 如果只是要获取支付宝付款码的链接,可以直接调用getPayCodePageUrl方法获取
const scanPageUrl = EntPay.Staff.getPayCodePageUrl({
  accountId: '企业的id',
});

完整使用:EntPay.Staff.goToPayCodePage( accountInfo, options)

accountInfo 内容字段说明类型默认值是否必填
accountId企业的 idstring
payCodeSceneCode跳转收银台场景码,需要分配才能获取string
specificId跳转支付宝时,需要指定支付宝账户时传入string
options 内容字段说明类型默认值是否必填
outAlipay是否在支付端 app 端外,默认 truebooleantrue
openNewPage是否打开一个新页面,默认 truebooleantrue


蚂蚁通用场景钱包对外-移动端 H5 SDK

场景钱包-支付宝端内签约

自动跳转到支付端内签约页面(推荐)

import { SceneWallet } from 'ep-open-tool-h5';

// 跳转场景钱包端签约页面
SceneWallet.goToSign({
  bizScene: '接入时约定的bizScene',
  bindToken: '绑定凭证',
});

完整使用:SceneWallet.goToSign( signParams, options)

signParam 内容字段说明类型默认值是否必填
bizScene接入时约定的 bizScenestring
bindToken绑定凭证string
returnUrl回跳链接string
skipResult跳过结果页N | Y
specificId跳转支付宝时,需要指定支付宝账户时传入string
options 内容字段说明类型默认值是否必填
outAlipay是否在支付端 app 端外,默认 truebooleantrue
openNewPage是否打开一个新页面,默认 truebooleantrue

仅获取签约地址

import { SceneWallet } from 'ep-open-tool-h5';

const signUrl = SceneWallet.getSignUrl({
  bizScene: '接入时约定的bizScene',
  bindToken: '绑定凭证',
});

方法参数说明

signParam 内容字段说明类型默认值是否必填
bizScene接入时约定的 bizScenestring
bindToken绑定凭证string
returnUrl回跳链接string
specificId跳转支付宝时,需要指定支付宝账户时传入string


蚂蚁网商场景钱包对外-移动端 H5 SDK

网商场景钱包-支付宝端内签约

自动跳转到支付端内签约页面(推荐)

import { MYBankSceneWallet } from 'ep-open-tool-h5';

// 跳转网商场景钱包端签约页面
MYBankSceneWallet.goToSign({
  bizScene: '接入时约定的bizScene',
  bindToken: '绑定凭证',
});

完整使用:MYBankSceneWallet.goToSign( signParams, options)

signParam 内容字段说明类型默认值是否必填
bizScene接入时约定的 bizScenestring
bindToken绑定凭证string
returnUrl回跳链接string
skipResult跳过结果页Y | N
specificId跳转支付宝时,需要指定支付宝账户时传入string
options 内容字段说明类型默认值是否必填
outAlipay是否在支付端 app 端外,默认 truebooleantrue
openNewPage是否打开一个新页面,默认 truebooleantrue

仅获取签约地址

import { MYBankSceneWallet } from 'ep-open-tool-h5';

const signUrl = MYBankSceneWallet.getSignUrl({
  bizScene: '接入时约定的bizScene',
  bindToken: '绑定凭证',
});

方法参数说明

signParam 内容字段说明类型默认值是否必填
bizScene接入时约定的 bizScenestring
bindToken绑定凭证string
returnUrl回跳链接string
skipResult跳过结果页Y | N
specificId跳转支付宝时,需要指定支付宝账户时传入string


二方支卡通-移动端 H5 SDK

支卡通V1-支付宝端内签约(后续接入请采用支卡通V2版本)

自动跳转到支付端内签约页面(推荐)

import { Zcard } from 'ep-open-tool-h5';

// 跳转支卡通签约页面
ZCard.goToSign({
  bizScene: '接入时约定的bizScene',
  bindToken: '绑定时的token值',
});

完整使用:ZCard.goToSign( signParams, options)

signParam 内容字段说明类型默认值是否必填
bizScene接入时约定的 bizScenestring
bindToken绑定凭证string
returnUrl回跳链接string
showResultPage是否展示结果页Y | N
specificId跳转支付宝时,需要指定支付宝账户时传入string
options 内容字段说明类型默认值是否必填
outAlipay是否在支付端 app 端外,默认 truebooleantrue
openNewPage是否打开一个新页面,默认 truebooleantrue

仅获取签约地址

import { Zcard } from 'ep-open-tool-h5';

const signUrl = Zcard.getSignUrl({
  bizScene: '接入时约定的bizScene',
  bindToken: '绑定凭证',
});

方法参数说明

signParam 内容字段说明类型默认值是否必填
bizScene接入时约定的 bizScenestring
bindToken绑定凭证string
returnUrl回跳链接string
showResultPage是否展示结果页页Y | N
specificId跳转支付宝时,需要指定支付宝账户时传入string

支卡通V2-支付宝端内签约

自动跳转到支付端内签约页面(推荐)

import { Zcard } from 'ep-open-tool-h5';

// 跳转支卡通V2签约页面
ZCard.goToSignV2({
  bizProductCode:'接入时约定的bizProductCode',
  bizSceneCode: '接入时约定的bizSceneCode',
  subBizSceneCode: '接入时约定的subBizSceneCode'
  applyToken: '绑定时的applyToken值',
});

完整使用:ZCard.goToSign( signParams, options)

signParam 内容字段说明类型默认值是否必填
bizProductCode接入时约定的 bizProductCodestring
bizSceneCode接入时约定的 bizSceneCodestring
subBizSceneCode接入时约定的 subBizSceneCodestring
applyToken绑定凭证string
returnUrl回跳链接string
showResultPage是否展示结果页Y | N
specificId跳转支付宝时,需要指定支付宝账户时传入string
options 内容字段说明类型默认值是否必填
outAlipay是否在支付端 app 端外,默认 truebooleantrue
openNewPage是否打开一个新页面,默认 truebooleantrue

仅获取签约地址

import { Zcard } from 'ep-open-tool-h5';

const signUrl = Zcard.getSignUrlV2({
  bizProductCode:'接入时约定的bizProductCode'
  bizSceneCode: '接入时约定的bizSceneCode',
  applyToken: '绑定凭证',
});


常见问题 FAQ

1.returnUrl 支持那些类型?

当前支持的跳转链接需要满足下面的格式之一: 1.需要是 https://开头域名链接地址; 2.需要是 alipays://开头的支付宝小程序链接

需要保证传入的 returnUrl 链接能够有效访问,可以通过草料二维码转换成二维码,支付宝扫码验证是否能打开;

2.returnUrl 无法正常跳转

⚠️⚠️⚠️ 注意事项 1.整体 returnUrl 不需要额外的 encode,SDK 内部已经处理过了;

2.如果是跳转地址的链接需要 url 中有页面参数,则需要自己 encode 拼接好;比如跳转小程序的 pages/index/index 页面想带参数,则需要:\'alipays://platformapi/startapp?appId=2021003126648243&page=\'+ encodeURIComponent('pages/index/index?参数 key=参数 value')

1.1.8

8 months ago

1.1.7

9 months ago

1.1.6

1 year ago

1.1.5

1 year ago

1.1.4

1 year ago

1.1.3

1 year ago

1.1.2

1 year ago

1.1.1-beta.1

1 year ago

1.1.0

1 year ago

1.0.5

1 year ago

1.0.3

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago