创建支付扩展应用
在通过支付合作伙伴审核后,您需要在 Genstore 开发者中心创建新的应用,并将以下信息通过邮件发送至 paymentdeveloper@genstore.ai :
- Partner 名称
- 应用名称
- ClientId
Genstore 将在 2 个工作日内完成授权,您的应用即可获得支付扩展开发权限。
创建公开(Public) 应用
- 登录 Genstore 开发者中心控制台,点击 应用 -> 创建应用。
- 填写 应用名称。该名称将显示在:
- Genstore 商家后台 → 设置 → 支付 → 更多支付方式 → 第三方支付服务提供商 / 其他支付方式 列表下。
- 应用创建成功后,点击进入应用配置页,在左侧导航中找到 应用配置 并填写信息:
- 是否嵌入后台 必须选择 否,否则可能造成页面嵌套异常,应用无法使用。
- 点击 保存并发布 完成配置。
申请应用扩展权限
此时您的支付扩展尚无权限,请将 Partner 名称、应用名称、ClientId 发送至 paymentdeveloper@genstore.ai 。Genstore 将在 2 个工作日内完成授权,完成后即可在应用中创建支付扩展。
开发与配置支付扩展
创建支付扩展
- 登录 Genstore 开发者中心控制台,点击应用名称进入应用配置页。
- 在 概览 页签,点击 应用扩展 部分的 配置扩展信息。
- 点击 创建应用扩展,切换至 支付扩展 页签。
- 点击 立即创建 进入扩展配置页面。
配置支付扩展
支付扩展的配置页面分为以下部分:
- 支付扩展测试信息:
- 提供审查所需信息(如账号、密码、测试商户号、秘钥等)。
- 不得提供需要双因素认证的测试账号,否则无法完成授权验证。
- 基本信息:选择支付扩展的模式(直连卡 / 站外支付)
- 支付能力配置:定义支付能力(收款、退款、捕获等)、支付方式展示方式,以及 API 端点信息。
选择支付扩展模型
在支付扩展配置页面,点击 基本信息 部分的 编辑 按钮,根据业务需求选择支付模型:
- 直连卡支付:买家在结账页面直接输入卡信息完成支付
- 站外支付:买家跳转至第三方页面完成支付(可聚合多种支付方式)。
- 如果支持多种方式,Genstore 会在结账页显示您的应用横幅,买家点击 立即支付 后跳转至聚合收银台。
TIP
支付扩展模型一旦确认将不可更改,请谨慎操作
配置直连卡支付扩展
支付能力
直连卡支付要求
- 必须实现:捕获、退款、Token 化能力
- 可选实现:取消授权(如支持,必须在 7 天内完成处理,并实现提醒和超期处理逻辑)
- Token 化:
- 必须实现 Tokenization,并在配置中填写公钥。
- Genstore 与支付应用之间采用加解密通信,您需实现指定算法(详见 加解密算法 )。
支付方式
您可以选择国际主流信用卡、区域卡向您的商户提供支付能力,其中卡支付除了 American Express 之外,均填写卡号、过期时间和 3 位 CVV。
端点配置
在 端点 标签页中为各能力注册 API 地址,以便 Genstore 与您的扩展通信。
配置站外支付扩展
支付能力配置
站外支付要求
- 必须实现:捕获、退款能力。
- 可选实现:
- 取消授权
- 分期付款
支付方式
- 可配置多种方式:银行转账、便利店支付、加密货币等。
- 如需增加额外支付方式或品牌 Logo,请联系 paymentdeveloper@genstore.ai 。
端点配置
在 端点 标签页中为各能力注册 API 地址,以便 Genstore 与您的扩展通信。
保存草稿与测试
- 完成扩展配置后,点击右上角 保存草稿,返回扩展列表页。
- 启用 开发商店预览 功能,使用开发者账号测试支付扩展能力,确保满足商户需求与 Genstore 审查要求。
创建扩展版本
当支付扩展通过开发商店验证后,可创建扩展版本提交审核:
- 前往应用详情 → 应用扩展。点击支付扩展的 HandleID(唯一标识)。
- 确认支付扩展测试信息填写正确。
- 点击 创建版本,填写版本名称与描述。
- 点击 提交并生效,扩展自动进入审核流程。
- 审核结果将通过邮件通知,请及时查收,您也可在 应用详情 → 版本管理 查看审核状态。
配置应用与提交审核
配置应用权限范围
- 配置应用权限范围(参考 应用权限配置指南)。
- 支付扩展应用仅支持以下权限范围:
write_paymentread_appswrite_apps- 超出范围的权限请求将不会生效。
提交应用审核
当支付扩展审核通过后,您可提交应用审核,应用通过后将会出现在商家后台的支付方式列表中。具体步骤,参考 应用发布指南