Glacix Docs Blog https://docs.glacix.io/changelog Glacix Docs Blog Thu, 03 Sep 2026 00:00:00 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed zh-Hans <![CDATA[持卡人证件与产品预校验增强]]> https://docs.glacix.io/changelog/cardholder-kyc https://docs.glacix.io/changelog/cardholder-kyc Thu, 03 Sep 2026 00:00:00 GMT 持卡人支持 SSN 与更多证件类型；KYC 第三方证明与证件材料改为文件 ID；新增持卡人 × 卡产品预校验；城市与文件接口统一至公共前缀。

证件与 KYC 字段​

  • 持卡人请求/响应支持 ssn（美国国籍场景，9 位数字）。
  • 证件信息支持 issue_date、expiry_date（yyyy-MM-dd）。
  • 证件类型扩展支付：ID_CARD、PASSPORT、HK_HKID、DLN。

产品预校验​

  • 新增 POST /api/open/v2/issuing/cardholders/validate：按持卡人（或草稿字段）与 card_product_id 预校验必填项、国籍、区号等限制；不传产品 ID 时校验账户下全部 ENABLED 产品。
]]> 持卡人 API <![CDATA[卡产品配置字段扩展]]> https://docs.glacix.io/changelog/card-product-fields https://docs.glacix.io/changelog/card-product-fields Wed, 02 Sep 2026 00:00:00 GMT 卡产品列表补充开卡/充值门槛、持卡人限额、支持地区与国籍等配置字段，便于开卡前校验。

GET /api/open/v1/issuing/products 产品项新增/完善字段：

  • country：卡产品所属国家（ISO-3166 alpha-2）
  • min_open_card_amount、min_recharge_amount：最小开卡/充值金额
  • max_cards_per_cardholder：持卡人最大开卡数（空表示不限制）
  • support_billing_region：账单地址允许国家/地区
  • support_nationality、sanctioned_nationality：国籍白名单与受限黑名单
  • support_area_code：手机区号白名单
  • balance_retention_quota：余额保留配额
  • kyc_level：KYC 等级
  • cardholder_required_fields：持卡人必填字段说明（含嵌套结构）

空数组或空值一般表示不限制，具体以产品配置为准。

]]> 支付卡 API <![CDATA[卡产品与敏感信息展示控制]]> https://docs.glacix.io/changelog/card-product https://docs.glacix.io/changelog/card-product Mon, 27 Jul 2026 00:00:00 GMT 卡产品列表补充名称与描述；敏感信息接口支持 show_data。

  • GET /api/open/v1/issuing/products 产品项新增 name、description。
  • GET /api/open/v1/issuing/cards/{id}/sensitive 新增查询参数 show_data（默认 false）：为 true 时可直接展示卡信息，默认仍返回查看用 URL。
]]> 支付卡 API <![CDATA[公共文件上传与下载]]> https://docs.glacix.io/changelog/files https://docs.glacix.io/changelog/files Thu, 02 Jul 2026 00:00:00 GMT 新增公共文件上传与下载接口；证件与相关材料改为先上传再传文件 ID。

  • 新增 POST /api/open/v1/common/files/upload：上传文件，返回 file_id 等元数据。
    • 限制：最大 10MB；支持 jpg、jpeg、png、pdf。
  • 新增 GET /api/open/v1/common/files/{id}：按文件 ID 下载预览。
]]> 公共 API <![CDATA[持卡人与 KYC 字段调整]]> https://docs.glacix.io/changelog/cardholder-v2 https://docs.glacix.io/changelog/cardholder-v2 Thu, 18 Jun 2026 00:00:00 GMT 上线持卡人 v2 创建/更新/详情；证件新增签发国；更新接口移除姓名字段；支持获取 KYC 链接。持卡人更新请求移除 first_name、last_name，姓名以创建时信息为准，更新接口不再接受这两项。

新接口（v2）​

  • POST /api/open/v2/issuing/cardholders：创建持卡人 v2
  • PUT /api/open/v2/issuing/cardholders：更新持卡人 v2
  • GET /api/open/v2/issuing/cardholders/{id}：持卡人详情 v2

KYC 与证件​

  • POST /api/open/v1/issuing/cardholders/{id}/kycLink：获取 KYC 链接。
  • 证件信息新增必填 issue_country（ISO-3166 alpha-2）。
]]> 持卡人 API <![CDATA[卡交易类型与商户字段增强]]> https://docs.glacix.io/changelog/card-transaction https://docs.glacix.io/changelog/card-transaction Tue, 19 May 2026 00:00:00 GMT 卡片交易列表扩展更多交易类型，并返回商户信息与账单金额/币种。

交易类型​

  • 结算类细分为 SETTLEMENT_DEBIT、SETTLEMENT_CREDIT（原笼统 SETTLEMENT 已调整）。
  • 拒付类细分为 CHARGEBACK_DEBIT、CHARGEBACK_CREDIT。
  • 新增 OTHER、ATM_DEPOSIT、FUND_COLLECTION 等类型（以当前 API 参考为准）。

交易明细字段​

  • 新增 merchant_name、merchant_mcc。
  • 新增 billing_amount、billing_currency。
]]> 支付卡 API <![CDATA[账户发卡余额查询上线]]> https://docs.glacix.io/changelog/account https://docs.glacix.io/changelog/account Mon, 11 May 2026 00:00:00 GMT 新增账户发卡余额查询接口，便于开卡与充值前核对可用资金。

  • 新增 GET /api/open/v1/account/issuing/balance：查询当前账户发卡余额。
  • 需携带 Authorization 与 X-Request-Id。
]]> 账户 API <![CDATA[开卡、卡产品新接口]]> https://docs.glacix.io/changelog/card-v2 https://docs.glacix.io/changelog/card-v2 Fri, 24 Apr 2026 00:00:00 GMT 上线支付卡 v2 开卡与卡产品列表接口；分配需指定产品；多接口支持 out_id；充值/转出等响应增加 biz_id；卡片详情补充状态变更来源与原因。

新接口​

  • 新增 POST /api/open/v2/issuing/cards：按 card_product_id 创建卡片。
  • 新增 GET /api/open/v1/issuing/products：查询可用卡产品列表。
  • 分配卡片 POST /cards/assign 请求新增必填 card_product_id。

外部追踪与业务 ID​

  • 开卡、分配、状态变更、充值、转出、激活等请求支持可选 out_id（外部标识，便于幂等与对账）。
  • 充值、转出、交易等响应增加 biz_id，便于关联业务流水。
  • 状态更新接口返回结构化状态变更结果（含记录信息）。

详情与字段修正​

  • 卡片详情新增 status_change_source、status_change_reason。
  • 卡模式字段统一为 model_type（SHARE / SINGLE）。
]]> 支付卡 API <![CDATA[支付卡管理 API 上线]]> https://docs.glacix.io/changelog/card https://docs.glacix.io/changelog/card Fri, 30 Jan 2026 00:00:00 GMT Open API 上线支付卡基础能力：创建、分配、激活、重置 PIN，以及查询、充值、转出与交易列表。

新增接口（前缀 /api/open/v1/issuing）：

  • POST /cards：创建卡片
  • POST /cards/assign：分配卡片
  • POST /cards/activate：激活卡片
  • POST /cards/pin/reset：重置 PIN
  • POST /cards/status：更新卡片状态
  • GET /cards、GET /cards/{id}：列表与详情
  • GET /cards/{id}/sensitive：查询敏感信息
  • POST /cards/recharge、POST /cards/withdraw：充值与转出
  • GET /cardTransactions：查询卡片交易列表
]]> 支付卡 API <![CDATA[持卡人管理 API 上线]]> https://docs.glacix.io/changelog/cardholder https://docs.glacix.io/changelog/cardholder Wed, 28 Jan 2026 00:00:00 GMT Open API 上线持卡人 v1 能力，支持创建、更新、列表与详情查询。

新增接口（前缀 /api/open/v1/issuing）：

  • POST /cardholders：创建持卡人
  • PUT /cardholders：更新持卡人
  • GET /cardholders：查询持卡人列表
  • GET /cardholders/{id}：查询持卡人详情

请求/响应包含身份信息、联系方式与地址等基础字段，用于后续开卡与发卡流程。

]]> 持卡人 API