You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
yanzong/vendor/alipaysdk/easysdk/APIDoc.md

823 lines
30 KiB

6 months ago
# 基础能力 Base
## 用户授权 OAuth
### 获取授权访问令牌
* API声明
getToken(code: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| code | string | | 授权码用户对应用授权后得到 |
* 出参说明
可前往[alipay.system.oauth.token](https://docs.open.alipay.com/api_9/alipay.system.oauth.token)查看更加详细的参数说明。
### 刷新授权访问令牌
* API声明
refreshToken(refreshToken: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| refreshToken | string | | 刷新令牌上次换取访问令牌时得到见出参的refresh_token字段 |
* 出参说明
可前往[alipay.system.oauth.token](https://docs.open.alipay.com/api_9/alipay.system.oauth.token)查看更加详细的参数说明。
---
## 小程序二维码 Qrcode
### 创建小程序二维码
* API声明
create(urlParam: string, queryParam: string, describe: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| urlParam | string | | 小程序中能访问到的页面路径例如page/component/component-pages/view/view |
| queryParam | string | | 小程序的启动参数打开小程序的query 在小程序 onLaunch的方法中获取 |
| describe | string | | 二维码描述 |
* 出参说明
可前往[alipay.open.app.qrcode.create](https://docs.open.alipay.com/api_5/alipay.open.app.qrcode.create)查看更加详细的参数说明。
---
## 图片 Image
### 上传图片
* API声明
upload(imageName: string, imageFilePath: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| imageName | string | | 图片名称 |
| imageFilePath | string | | 待上传的本地图片文件路径 |
* 出参说明
可前往[alipay.offline.material.image.upload](https://docs.open.alipay.com/api_3/alipay.offline.material.image.upload)查看更加详细的参数说明。
---
## 视频 Video
### 上传视频
* API声明
upload(videoName: string, videoFilePath: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| videoName | string | | 视频名称 |
| videoFilePath | string | | 待上传的本地视频文件路径 |
* 出参说明
可前往[alipay.offline.material.image.upload](https://docs.open.alipay.com/api_3/alipay.offline.material.image.upload)查看更加详细的参数说明。
---
# 营销能力 Marketing
## 生活号 OpenLife
### 创建图文消息内容
* API声明
createImageTextContent(title: string, cover: string, content: string, contentComment: string, ctype: string, benefit: string, extTags: string, loginIds: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| title | string | | 标题 |
| cover | string | | 封面图URL, 尺寸为996*450最大不超过3M支持.jpg.png格式请先调用上传图片接口获得图片URL |
| content | string | | 消息正文支持富文本 |
| contentComment | string | | 是否允许评论T允许F不允许默认不允许 |
| ctype | string | | 图文类型填activity表示活动图文不填默认普通图文 |
| benefit | string | | 活动利益点图文类型ctype为activity类型时才需要传最多10个字符 |
| extTags | string | | 关键词列表英文逗号分隔最多不超过5个 |
| loginIds | string | | 可预览支付宝账号列表需要预览时才填写 英文逗号分隔最多不超过10个 |
* 出参说明
可前往[alipay.open.public.message.content.create](https://docs.open.alipay.com/api_6/alipay.open.public.message.content.create)查看更加详细的参数说明。
### 更新图文消息内容
* API声明
modifyImageTextContent(contentId: string, title: string, cover: string, content: string, couldComment: string, ctype: string, benefit: string, extTags: string, loginIds: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| contentId | string | | 内容ID通过创建图文内容消息接口返回 |
| title | string | | 标题 |
| cover | string | | 封面图URL, 尺寸为996*450最大不超过3M支持.jpg.png格式请先调用上传图片接口获得图片URL |
| content | string | | 消息正文支持富文本 |
| contentComment | string | | 是否允许评论T允许F不允许默认不允许 |
| ctype | string | | 图文类型填activity表示活动图文不填默认普通图文 |
| benefit | string | | 活动利益点图文类型ctype为activity类型时才需要传最多10个字符 |
| extTags | string | | 关键词列表英文逗号分隔最多不超过5个 |
| loginIds | string | | 可预览支付宝账号列表需要预览时才填写 英文逗号分隔最多不超过10个 |
* 出参说明
可前往[alipay.open.public.message.content.modify](https://docs.open.alipay.com/api_6/alipay.open.public.message.content.modify)查看更加详细的参数说明。
### 群发本文消息
* API声明
sendText(text: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| text | string | | 文本消息内容 |
* 出参说明
可前往[alipay.open.public.message.total.send](https://docs.open.alipay.com/api_6/alipay.open.public.message.total.send)查看更加详细的参数说明。
### 群发图文消息
* API声明
sendImageText(articles: [ Article ])
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| articles | Article数组 | | 图文消息内容 |
Article对象说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| title | string | | 图文消息标题 |
| desc | string | | 图文消息描述 |
| imageUrl | string | 特殊可选 | 图片链接对于多条图文消息的第一条消息该字段不能为空请先调用上传图片接口获得图片URL |
| url | string | | 点击图文消息跳转的链接 |
| actionName | string | | 链接文字 |
* 出参说明
可前往[alipay.open.public.message.total.send](https://docs.open.alipay.com/api_6/alipay.open.public.message.total.send)查看更加详细的参数说明。
### 单发模板消息
* API声明
sendSingleMessage(toUserId: string, template: Template)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| toUserId | string | | 消息接收用户的UserId |
| template | Template | | 消息接收用户的UserId |
Template对象说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| templateId | string | | 消息模板ID |
| context | Context | | 消息模板上下文即模板中定义的参数及参数值 |
Context对象说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| headColor | string | | 顶部色条的色值比如#85be53 |
| url | string | | 点击消息后承接页的地址 |
| actionName | string | | 底部链接描述文字查看详情最多能传8个汉字或16个英文字符 |
| keyword1 | Keyword | | 模板中占位符的值及文字颜色 |
| keyword2 | Keyword | | 模板中占位符的值及文字颜色 |
| first | Keyword | | 模板中占位符的值及文字颜色 |
| remark | Keyword | | 模板中占位符的值及文字颜色 |
Keyword对象说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| color | string | | 当前文字颜色比如#85be53 |
| value | string | | 模板中占位符的值 |
* 出参说明
可前往[alipay.open.public.message.single.send](https://docs.open.alipay.com/api_6/alipay.open.public.message.single.send)查看更加详细的参数说明。
### 生活号消息撤回
* API声明
recallMessage(messageId: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| messageId | string | | 消息ID |
* 出参说明
可前往[alipay.open.public.life.msg.recall](https://docs.open.alipay.com/api_6/alipay.open.public.life.msg.recall)查看更加详细的参数说明。
### 模板消息行业设置
* API声明
setIndustry(primaryIndustryCode: string, primaryIndustryName: string, secondaryIndustryCode: string, secondaryIndustryName: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| primaryIndustryCode | string | | 服务窗消息模板所属主行业一级编码查看[行业信息](https://alipay.open.taobao.com/doc2/detail?treeId=197&docType=1&articleId=105043) |
| primaryIndustryName | string | | 服务窗消息模板所属主行业一级名称 |
| secondaryIndustryCode | string | | 服务窗消息模板所属主行业二级编码 |
| secondaryIndustryName | string | | 服务窗消息模板所属主行业二级名称 |
* 出参说明
可前往[alipay.open.public.template.message.industry.modify](https://docs.open.alipay.com/api_6/alipay.open.public.template.message.industry.modify)查看更加详细的参数说明。
### 生活号查询行业设置
* API声明
getIndustry()
* 入参说明
* 出参说明
可前往[alipay.open.public.setting.category.query](https://docs.open.alipay.com/api_6/alipay.open.public.setting.category.query)查看更加详细的参数说明。
---
## 支付宝卡包 Pass
### 卡券模板创建
* API声明
createTemplate(uniqueId: string, tplContent: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| uniqueId | string | | 商户用于控制模版的唯一性可以使用时间戳保证唯一性 |
| tplContent | string | | 模板内容信息遵循JSON规范详情参见tpl_content[参数说明](https://doc.open.alipay.com/doc2/detail.htm?treeId=193&articleId=105249&docType=1#tpl_content) |
* 出参说明
可前往[alipay.pass.template.add](https://docs.open.alipay.com/api_24/alipay.pass.template.add)查看更加详细的参数说明。
### 卡券模板更新
* API声明
updateTemplate(uniqueId: string, tplContent: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| uniqueId | string | | 商户用于控制模版的唯一性可以使用时间戳保证唯一性 |
| tplContent | string | | 模板内容信息遵循JSON规范详情参见tpl_content[参数说明](https://doc.open.alipay.com/doc2/detail.htm?treeId=193&articleId=105249&docType=1#tpl_content) |
* 出参说明
可前往[alipay.pass.template.update](https://docs.open.alipay.com/api_24/alipay.pass.template.update)查看更加详细的参数说明。
### 卡券实例发放
* API声明
addInstance(tplId: string, tplParams: string, recognitionType: string, recognitionInfo: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| tplId | string | | 支付宝pass模版ID即调用模板创建接口时返回的tpl_id |
| tplParams | string | | 模版动态参数信息对应模板中$变量名$的动态参数见模板创建接口返回值中的tpl_params字段示例 |
| recognitionType | string | | Alipass添加对象识别类型填写1表示订单信息 |
| recognitionInfo | string | | 支付宝用户识别信息参见[UID发券组件对接文档](https://docs.open.alipay.com/199/sy3hs4 ) |
* 出参说明
可前往[alipay.pass.instance.add](https://docs.open.alipay.com/api_24/alipay.pass.instance.add)查看更加详细的参数说明。
### 卡券实例更新
* API声明
updateInstance(serialNumber: string, channelId: string, tplParams: string, status: string, verifyCode: string, verifyType: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| serialNumber | string | | 商户指定卡券唯一值卡券JSON模板中fileInfo->serialNumber字段对应的值 |
| channelId | string | | 代理商代替商户发放卡券后再代替商户更新卡券时此值为商户的PID/AppID |
| tplParams | string | | Alipass添加对象识别类型填写1表示订单信息 |
| status | string | | 券状态支持更新为USEDCLOSED两种状态 |
| verifyCode | string | | 核销码串值当状态变更为USED时建议传该值正常为模板中核销区域Operation对应的message值 |
| verifyType | string | | 核销方式该值正常为模板中核销区域Operation对应的format值verifyCode和verifyType需同时传入 |
* 出参说明
可前往[alipay.pass.instance.update](https://docs.open.alipay.com/api_24/alipay.pass.instance.update)查看更加详细的参数说明。
---
## 小程序模板消息 TemplateMessage
### 发送模板消息
* API声明
send(toUserId: string, formId: string, userTemplateId: string, page: string, data: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| toUserId | string | | 发送消息的支付宝账号 |
| formId | string | | 用户发生的交易行为的交易号或者用户在小程序产生表单提交的表单号用于信息发送的校验 |
| userTemplateId | string | | 用户申请的模板id号固定的模板id会发送固定的消息 |
| page | string | | 小程序的跳转页面用于消息中心用户点击之后详细跳转的小程序页面例如page/component/index |
| data | string | | 开发者需要发送模板消息中的自定义部分来替换模板的占位符例如{"keyword1": {"value" : "12:00"},"keyword2": {"value" : "20180808"},"keyword3": {"value" : "支付宝"}} |
* 出参说明
可前往[alipay.open.app.mini.templatemessage.send](https://docs.open.alipay.com/api_5/alipay.open.app.mini.templatemessage.send)查看更加详细的参数说明。
---
# 会员能力 Member
## 支付宝身份认证 Identification
### 身份认证初始化
* API声明
init(outerOrderNo: string, bizCode: string, identityParam: IdentityParam, merchantConfig: MerchantConfig)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| outerOrderNo | string | | 商户请求的唯一标识商户要保证其唯一性值为32位长度的字母数字组合建议前面几位字符是商户自定义的简称中间可以使用一段时间后段可以使用一个随机或递增序列 |
| bizCode | string | | 认证场景码入参支持的认证场景码和商户签约的认证场景相关可选值有如下FACE多因子人脸认证CERT_PHOTO多因子证照认证CERT_PHOTO_FACE多因子证照和人脸认证SMART_FACE多因子快捷认证 |
| identityParam | IdentityParam | | 需要验证的身份信息参数 |
| merchantConfig | MerchantConfig | | 商户个性化配置 |
IdentityParam对象说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| identityType | string | | 身份信息参数类型必须传入CERT_INFO |
| certType | string | | 证件类型当前支持身份证必须传入IDENTITY_CARD |
| certName | string | | 真实姓名 |
| certNo | string | | 证件号码 |
MerchantConfig对象说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| returnUrl | string | | 需要回跳的目标URL地址一般指定为商户业务页面 |
* 出参说明
可前往[alipay.user.certify.open.initialize](https://docs.open.alipay.com/api_2/alipay.user.certify.open.initialize)查看更加详细的参数说明。
### 生成认证链接
* API声明
certify(certifyId: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| certifyId | string | | 本次申请操作的唯一标识由身份认证初始化接口调用后生成后续的操作都需要用到 |
* 出参说明
可前往[alipay.user.certify.open.certify](https://docs.open.alipay.com/api_2/alipay.user.certify.open.certify)查看更加详细的参数说明。
### 身份认证记录查询
* API声明
query(certifyId: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| certifyId | string | | 身份认证操作的唯一标识由身份认证初始化接口调用后生成 |
* 出参说明
可前往[alipay.user.certify.open.query](https://docs.open.alipay.com/api_2/alipay.user.certify.open.query)查看更加详细的参数说明。
---
# 支付能力 Payment
## 通用接口 Common
### 创建交易
* API声明
create(subject: string, outTradeNo: string, totalAmount: string, buyerId: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| subject | string | | 订单标题 |
| outTradeNo | string | | 商户订单号64个字符以内可包含字母数字下划线需保证在商户端不重复 |
| totalAmount | string | | 订单总金额单位为元精确到小数点后两位取值范围[0.01,100000000] |
| buyerId | string | | 买家的支付宝唯一用户号2088开头的16位纯数字 |
* 出参说明
可前往[alipay.trade.create](https://docs.open.alipay.com/api_1/alipay.trade.create)查看更加详细的参数说明。
### 查询交易
* API声明
query(outTradeNo: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| outTradeNo | string | | 交易创建时传入的商户订单号 |
* 出参说明
可前往[alipay.trade.query](https://docs.open.alipay.com/api_1/alipay.trade.query)查看更加详细的参数说明。
### 交易退款
* API声明
refund(outTradeNo: string, refundAmount: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| outTradeNo | string | | 交易创建时传入的商户订单号 |
| refundAmount | string | | 需要退款的金额该金额不能大于订单金额单位为元支持两位小数 |
* 出参说明
可前往[alipay.trade.refund](https://docs.open.alipay.com/api_1/alipay.trade.refund)查看更加详细的参数说明。
### 关闭交易
* API声明
close(outTradeNo: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| outTradeNo | string | | 交易创建时传入的商户订单号 |
* 出参说明
可前往[alipay.trade.close](https://docs.open.alipay.com/api_1/alipay.trade.close)查看更加详细的参数说明。
### 撤销交易
* API声明
cancel(outTradeNo: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| outTradeNo | string | | 交易创建时传入的商户订单号 |
* 出参说明
可前往[alipay.trade.cancel](https://docs.open.alipay.com/api_1/alipay.trade.cancel)查看更加详细的参数说明。
### 交易退款查询
* API声明
queryRefund(outTradeNo: string, outRequestNo: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| outTradeNo | string | | 交易创建时传入的商户订单号 |
| outRequestNo | string | | 请求退款接口时传入的退款请求号如果在退款请求时未传入则该值为创建交易时的外部交易号 |
* 出参说明
可前往[alipay.trade.fastpay.refund.query](https://opendocs.alipay.com/apis/api_1/alipay.trade.fastpay.refund.query)查看更加详细的参数说明。
### 查询对账单下载地址
* API声明
downloadBill(billType: string, billDate: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| billType | string | | 账单类型商户通过接口或商户经开放平台授权后其所属服务商通过接口可以获取以下账单类型tradesigncustomertrade指商户基于支付宝交易收单的业务账单signcustomer是指基于商户支付宝余额收入及支出等资金变动的帐务账单 |
| billDate | string | | 账单时间日账单格式为yyyy-MM-dd最早可下载2016年1月1日开始的日账单月账单格式为yyyy-MM最早可下载2016年1月开始的月账单 |
* 出参说明
可前往[alipay.data.dataservice.bill.downloadurl.query](https://opendocs.alipay.com/apis/api_15/alipay.data.dataservice.bill.downloadurl.query)查看更加详细的参数说明。
### 异步通知验签
* API声明
verifyNotify(parameters: map[string]string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| parameters | map[string]string | | 异步通知中收到的待验签的所有参数 |
---
## 花呗分期 Huabei
### 创建花呗分期交易
* API声明
create(subject: string, outTradeNo: string, totalAmount: string, buyerId: string, extendParams: HuabeiConfig)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| subject | string | | 订单标题 |
| outTradeNo | string | | 商户订单号64个字符以内可包含字母数字下划线需保证在商户端不重复 |
| totalAmount | string | | 订单总金额单位为元精确到小数点后两位取值范围[0.01,100000000] |
| buyerId | string | | 买家的支付宝用户ID如果为空会从传入的码值信息中获取买家ID |
| extendParams | HuabeiConfig | | 花呗交易扩展参数 |
HuabeiConfig对象说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| hbFqNum | string | | 花呗分期数仅支持传入3612 |
| hbFqSellerPercent | string | | 代表卖家承担收费比例商家承担手续费传入100用户承担手续费传入0仅支持传入1000两种 |
* 出参说明
可前往[alipay.trade.create](https://docs.open.alipay.com/api_1/alipay.trade.create)查看更加详细的参数说明。
---
<a name="faceToFace"/>
## 当面付 FaceToFace
### 当面付交易付款
* API声明
pay(subject: string, outTradeNo: string, totalAmount: string, authCode: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| subject | string | | 订单标题 |
| outTradeNo | string | | 交易创建时传入的商户订单号 |
| totalAmount | string | | 订单总金额单位为元精确到小数点后两位取值范围[0.01,100000000] |
| authCode | string | | 支付授权码即买家的付款码数字 |
* 出参说明
可前往[alipay.trade.pay](https://docs.open.alipay.com/api_1/alipay.trade.pay)查看更加详细的参数说明。
* 返佣说明
ISV对接当面付产品需涉及返佣时请先阅读[政策详情](https://opendocs.alipay.com/p/00fc2g)与[合作攻略](https://opendocs.alipay.com/open/300/taphxd)。
**对接时必须在支付接口的extend_params参数中设置sys_service_provider_id返佣参数 参数值为签约返佣协议的PID**示例代码如下Java为例
```java
Map<String, String> extendParams = new HashMap<>();
extendParams.put("sys_service_provider_id", "<--请填写ISV签约协议的PID,比如:2088511833207846-->");
AlipayTradePayResponse response = Factory.Payment.FaceToFace()
.agent("<--请填写商户应用授权后获取到的app_auth_token,比如:ca34ea491e7146cc87d25fca24c4cD11-->")
.optional("extend_params", extendParams)
.pay("iPhone6 16G", "64628156-f784-4572-9540-485b7c91b850", "0.01", "289821051157962364");
```
---
### 交易预创建生成正扫二维码
* API声明
precreate(subject: string, outTradeNo: string, totalAmount: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| subject | string | | 订单标题 |
| outTradeNo | string | | 交易创建时传入的商户订单号 |
| totalAmount | string | | 订单总金额单位为元精确到小数点后两位取值范围[0.01,100000000] |
* 出参说明
可前往[alipay.trade.precreate](https://docs.open.alipay.com/api_1/alipay.trade.precreate)查看更加详细的参数说明。
* 返佣说明
ISV对接当面付产品需涉及返佣时请先阅读[政策详情](https://opendocs.alipay.com/p/00fc2g)与[合作攻略](https://opendocs.alipay.com/open/300/taphxd)。
**对接时必须在支付接口的extend_params参数中设置sys_service_provider_id返佣参数 参数值为签约返佣协议的PID**示例代码如下Java为例
```java
Map<String, String> extendParams = new HashMap<>();
extendParams.put("sys_service_provider_id", "<--请填写ISV签约协议的PID,比如:2088511833207846-->");
AlipayTradePrecreateResponse response = Payment.FaceToFace()
.agent("<--请填写商户应用授权后获取到的app_auth_token,比如:ca34ea491e7146cc87d25fca24c4cD11-->")
.optional("extend_params", extendParams)
.preCreate("iPhone6 16G", "64628156-f784-4572-9540-485b7c91b850", "0.01");
```
---
## 电脑网站 Page
### 电脑网站支付
* API声明
pay(subject: string, outTradeNo: string, totalAmount: string, returnUrl: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| subject | string | | 订单标题 |
| outTradeNo | string | | 交易创建时传入的商户订单号 |
| totalAmount | string | | 订单总金额单位为元精确到小数点后两位取值范围[0.01,100000000] |
| returnUrl | string | | 支付成功后同步跳转的页面是一个http/https开头的字符串 |
* 出参说明
可前往[alipay.trade.page.pay](https://docs.open.alipay.com/api_1/alipay.trade.page.pay)查看更加详细的参数说明。
---
## 手机网站 Wap
### 手机网站支付
* API声明
pay(subject: string, outTradeNo: string, totalAmount: string, quitUrl: string, returnUrl: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| subject | string | | 订单标题 |
| outTradeNo | string | | 交易创建时传入的商户订单号 |
| totalAmount | string | | 订单总金额单位为元精确到小数点后两位取值范围[0.01,100000000] |
| quitUrl | string | | 用户付款中途退出返回商户网站的地址 |
| returnUrl | string | | 支付成功后同步跳转的页面是一个http/https开头的字符串 |
* 出参说明
可前往[alipay.trade.wap.pay](https://docs.open.alipay.com/api_1/alipay.trade.wap.pay)查看更加详细的参数说明。
---
## App支付 App
### 手机APP支付
* API声明
pay(subject: string, outTradeNo: string, totalAmount: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| subject | string | | 订单标题 |
| outTradeNo | string | | 交易创建时传入的商户订单号 |
| totalAmount | string | | 订单总金额单位为元精确到小数点后两位取值范围[0.01,100000000] |
* 出参说明
可前往[alipay.trade.app.pay](https://docs.open.alipay.com/api_1/alipay.trade.app.pay)查看更加详细的参数说明。
---
# 安全能力 Security
## 文本风险识别 TextRisk
### 检测内容风险
* API声明
detect(content: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| content | string | | 待检测的文本内容 |
* 出参说明
可前往[alipay.security.risk.content.detect](https://docs.open.alipay.com/api_49/alipay.security.risk.content.detect)查看更加详细的参数说明。
---
# 辅助工具 Util
## 加解密 AES
### AES解密常用于会员手机号解密
* API声明
decrypt(cipherText: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| cipherText | string | | 密文 |
* 出参说明
| 类型 | 说明 |
|------|----|
| string | 明文|
### AES加密
* API声明
encrypt(plainText: string)
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| plainText | string | | 明文 |
* 出参说明
| 类型 | 说明 |
|------|----|
| string | 密文|
<a name="generic"/>
## 通用接口 Generic
### 执行OpenAPI调用
* API声明
execute(method: string, textParams: map[string]string, bizParams: map[string]any): AlipayOpenApiGenericResponse
* 接口说明
对于Alipay Easy SDK尚未支持的Open API开发者可以通过调用此方法通过自行拼装请求参数完成大部分OpenAPI的调用且调用时可按需设置所有可选参数本接口同样会自动为您完成请求的加签和响应的验签工作
本接口不支持文件型字段的上传
* 入参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| method | string | | OpenAPI的名称例如alipay.trade.pay |
| textParams | map[string]string | | **没有**包装在`biz_content`下的请求参数集合例如`app_auth_token`等参数 |
| bizParams | map[string]any | | 被包装在`biz_content`下的请求参数集合 |
* 出参说明
| 字段名 | 类型 | 必填 | 说明 |
|------|--------|----|----|
| httpBody | string | | 网关返回的HTTP响应是一个JSON格式的字符串开发者可按需从中解析出响应参数响应示例{"alipay_trade_create_response":{"code":"10000","msg":"Success","out_trade_no":"4ac9eac...","trade_no":"202003..."},"sign":"AUumfYgGSe7...02MA=="} |
| code | string | | [网关返回码](https://docs.open.alipay.com/common/105806) |
| msg | string | | [网关返回码描述](https://docs.open.alipay.com/common/105806) |
| subCode | string | | 业务返回码参见具体的API接口文档 |
| subMsg | string | | 业务返回码描述参见具体的API接口文档 |
---