FuturePay Developer

Appearance

变更记录 ​

2026-08-18 21:37 CST +0800 ​

  • 按沙箱 OpenAPI 5.6.1 同步当前 25 个接口的字段、枚举、约束和状态说明。
  • KYC 响应新增 subStatus 和 cardAccountId，并明确 annualIncome 的五个允许区间。
  • 卡余额响应补充 fpCardAccountId 及分账户、分资产余额结构；保留单资产兼容字段说明。
  • 修正用户、KYC、卡、交易、充值和激活状态值域，以及健康检查的字符串响应。

2026-08-05 12:20 CST +0800 ​

  • 查询卡交易记录响应使用 countryCode 返回消费国家或地区代码，并新增可空字段 merchantName 和 merchantCategoryCode。
  • 新增独立的商户 Webhook 接入文档，补充后台配置、签名、事件 Payload、eventNo 幂等、失败重试和历史事件兼容说明。

2026-08-04 19:44 CST +0800 ​

  • 商户 webhook Payload 升级为 schemaVersion: 2；eventType 仅表示 CARD_OPENING、CARD_RECHARGE、CARD_WITHDRAWAL、CARD_CONSUMPTION、CARD_MONTHLY 业务场景，具体结果由 status 表达。
  • 历史 PENDING/DEAD 事件重放保持原始请求体不变，接收方仍需兼容旧版状态型 eventType 和卡提现旧格式。

2026-08-03 19:13 CST +0800 ​

  • 商户 webhook Payload 新增稳定的 eventNo，明确采用至少一次投递语义；重试和人工重放保持相同的事件号与请求体。
  • 商户 webhook 请求新增 X-FP-Timestamp、X-FP-Api-Key、X-FP-Signature、X-FP-Body-Hash 平台签名 Header。

2026-08-03 18:30 CST +0800 ​

  • 创建卡激活申请接口响应新增 cardStatus，返回卡商激活结果中的实际卡状态。

2026-08-03 14:27 CST +0800 ​

  • 查询卡详情和查询用户卡列表接口明确卡状态取值为 pending-activation、active、locked、lost、inactive，并统一使用面向商户的状态说明。

2026-08-01 18:28 CST +0800 ​

  • 查询用户卡列表接口支持使用 email 或 memberId 二选一查询；使用 memberId 时仍返回该用户关联的全部卡列表。
  • 查询卡交易记录接口的每条交易响应新增 memberId，返回平台成员 ID。
  • 注册用户接口响应移除不再返回的 accountId 和 cardAccountId。

2026-08-01 14:27 CST +0800 ​

  • 卡详情、用户卡列表、用户开卡状态和绑卡接口的共享卡响应新增 memberId、dailyLimit、singleTransactionLimit、availableLimit、cardLimit 和 cardEmail；详情附加字段无数据时对应字段为空。
  • 卡状态说明修正为接口实际返回值，不再限定为固定状态枚举。

2026-08-01 11:42 CST +0800 ​

  • 卡详情、用户卡列表、用户开卡状态和绑卡接口的卡响应新增可空字段 cardTypeId。

2026-07-31 14:54 CST +0800 ​

  • 查询卡敏感信息接口响应移除无效的 algorithm、iv、authTag 和 ciphertext 字段，仅保留卡 ID、卡号、CVV 和有效期信息。

2026-07-31 14:47 CST +0800 ​

  • 查询用户开卡状态、查询卡详情和查询用户卡列表接口补充卡状态说明。

2026-07-30 18:38 CST +0800 ​

  • 卡敏感信息、余额、交易记录、锁定、解锁、重新激活、挂失和 PIN 修改接口统一使用 cardId，不再兼容旧请求参数 cardNo。
  • 创建卡激活申请接口的 cardId 必填和长度校验提示统一使用字段名 cardId。
  • 绑卡接口继续使用完整 cardNo 作为卡片校验凭据。

2026-07-29 15:36 CST +0800 ​

本次变更修正文档调用路径和公共说明：

  • 补全公共响应分页结构中的 pageSize 和 total。
  • 明确沙箱 Base URL、完整请求路径和签名 PATH 的关系，避免重复拼接 /openapi。
  • 明确健康检查接口仍需 OpenAPI 请求签名。
  • 清理单接口页残留的旧分组标题。

2026-07-28 11:45 CST +0800 ​

本次变更同步注册用户接口文档与当前代码：

  • POST /openapi/v1/users/createUser 请求参数补充必填字段 externalId。
  • POST /openapi/v1/users/createUser 响应字段将 externalUserId 修正为当前返回的 memberId。
  • GET /openapi/v1/users/list 请求参数和列表响应补充 externalId。

2026-07-27 17:37 CST +0800 ​

本次变更同步 OpenAPI 文档与当前接口：

  • 新增“分页查询当前租户用户”文档，路径为 GET /openapi/v1/users/list。
  • 在 OpenAPI 总览和侧边栏补充用户分页查询入口。
  • 移除“查询可办卡类型”响应中当前接口不再返回的筛选项、绑卡入口和排序/标签字段。
  • 补全“查询卡交易记录”响应中的 Provider 交易信息、商户地区和手续费订单字段。

2026-07-24 16:04 CST +0800 ​

本次变更补充 OpenAPI 文档中的状态字段说明：

  • 明确开卡订单、卡充值、卡提现等平台订单状态取值。
  • 明确卡状态、KYC 状态、卡激活状态和交易状态的取值说明。
  • 统一使用面向调用方的对外状态说明。

2026-07-24 14:27 CST +0800 ​

本次变更补充 OpenAPI 接入凭证生成和配置说明：

  • 新增 apiKey 与 merchantPrivateKey 的 OpenSSL 生成命令。
  • 明确商户需自行妥善管理 merchantPrivateKey。
  • 明确商户在 FuturePay 商户管理后台中的“Api 凭证”页面上新增 apiKey 后，系统会返回 futurePayPublicKey / FPAPIKey。

2026-07-23 17:54 CST +0800 ​

本次变更修正 OpenAPI 文档与接口代码不一致的内容：

  • 绑卡接口路径从 /openapi/v1/users/bindCard 修正为 /openapi/v1/cards/bindCard。
  • 绑卡接口移动到“卡接口”分组。
  • 绑卡请求参数补齐 expiryMonth、expiryYear、cvv。
  • 绑卡 cardNo 说明修正为最大 32 位，仅支持数字、空格和横线。
  • 创建卡激活申请请求字段从 cardNo 修正为 cardId。