Skip to content

创建支付扩展应用

在通过支付合作伙伴审核后,您需要在 Genstore 开发者中心创建新的应用,并将以下信息通过邮件发送至 paymentdeveloper@genstore.ai

  • Partner 名称
  • 应用名称
  • ClientId

Genstore 将在 2 个工作日内完成授权,您的应用即可获得支付扩展开发权限。

创建公开(Public) 应用

  1. 登录 Genstore 开发者中心控制台,点击 应用 -> 创建应用
  2. 填写 应用名称。该名称将显示在:
    • Genstore 商家后台设置支付更多支付方式第三方支付服务提供商 / 其他支付方式 列表下。
  3. 应用创建成功后,点击进入应用配置页,在左侧导航中找到 应用配置 并填写信息:
    • 是否嵌入后台 必须选择 ,否则可能造成页面嵌套异常,应用无法使用。
  4. 点击 保存并发布 完成配置。

申请应用扩展权限

此时您的支付扩展尚无权限,请将 Partner 名称应用名称ClientId 发送至 paymentdeveloper@genstore.ai 。Genstore 将在 2 个工作日内完成授权,完成后即可在应用中创建支付扩展。

开发与配置支付扩展

创建支付扩展

  1. 登录 Genstore 开发者中心控制台,点击应用名称进入应用配置页。
  2. 概览 页签,点击 应用扩展 部分的 配置扩展信息
  3. 点击 创建应用扩展,切换至 支付扩展 页签。
  4. 点击 立即创建 进入扩展配置页面。

配置支付扩展

支付扩展的配置页面分为以下部分:

  • 支付扩展测试信息
    • 提供审查所需信息(如账号、密码、测试商户号、秘钥等)。
    • 不得提供需要双因素认证的测试账号,否则无法完成授权验证。
  • 基本信息:选择支付扩展的模式(直连卡 / 站外支付)
  • 支付能力配置:定义支付能力(收款、退款、捕获等)、支付方式展示方式,以及 API 端点信息。

选择支付扩展模型

在支付扩展配置页面,点击 基本信息 部分的 编辑 按钮,根据业务需求选择支付模型:

  • 直连卡支付:买家在结账页面直接输入卡信息完成支付
  • 站外支付:买家跳转至第三方页面完成支付(可聚合多种支付方式)。
    • 如果支持多种方式,Genstore 会在结账页显示您的应用横幅,买家点击 立即支付 后跳转至聚合收银台。

TIP

支付扩展模型一旦确认将不可更改,请谨慎操作

配置直连卡支付扩展

支付能力

直连卡支付要求

  • 必须实现:捕获、退款、Token 化能力
  • 可选实现:取消授权(如支持,必须在 7 天内完成处理,并实现提醒和超期处理逻辑)
  • Token 化
    • 必须实现 Tokenization,并在配置中填写公钥。
    • Genstore 与支付应用之间采用加解密通信,您需实现指定算法(详见 加解密算法 )。

支付方式

您可以选择国际主流信用卡、区域卡向您的商户提供支付能力,其中卡支付除了 American Express 之外,均填写卡号、过期时间和 3 位 CVV。

端点配置

端点 标签页中为各能力注册 API 地址,以便 Genstore 与您的扩展通信。

配置站外支付扩展

支付能力配置

站外支付要求

  • 必须实现:捕获、退款能力。
  • 可选实现:
    • 取消授权
    • 分期付款

支付方式

  • 可配置多种方式:银行转账、便利店支付、加密货币等。
  • 如需增加额外支付方式或品牌 Logo,请联系 paymentdeveloper@genstore.ai

端点配置

端点 标签页中为各能力注册 API 地址,以便 Genstore 与您的扩展通信。

保存草稿与测试

  • 完成扩展配置后,点击右上角 保存草稿,返回扩展列表页。
  • 启用 开发商店预览 功能,使用开发者账号测试支付扩展能力,确保满足商户需求与 Genstore 审查要求。

创建扩展版本

当支付扩展通过开发商店验证后,可创建扩展版本提交审核:

  1. 前往应用详情 → 应用扩展。点击支付扩展的 HandleID(唯一标识)。
  2. 确认支付扩展测试信息填写正确。
  3. 点击 创建版本,填写版本名称与描述。
  4. 点击 提交并生效,扩展自动进入审核流程。
  5. 审核结果将通过邮件通知,请及时查收,您也可在 应用详情 → 版本管理 查看审核状态。

配置应用与提交审核

配置应用权限范围

  1. 配置应用权限范围(参考 应用权限配置指南)。
  2. 支付扩展应用仅支持以下权限范围:
    • write_payment
    • read_apps
    • write_apps
    • 超出范围的权限请求将不会生效。

提交应用审核

当支付扩展审核通过后,您可提交应用审核,应用通过后将会出现在商家后台的支付方式列表中。具体步骤,参考 应用发布指南