更新日志

​

Issuing

• 影响接口：Create Card、Update Card、Retrieve Card、List Cards
• 影响 webhook：card.create.succeeded、card.update.succeeded
• risk_controls 下新增 enable_3ds 字段，控制卡片是否注册 3DS。配合既有的 allow_3ds_transactions 完整控制 3DS 行为 —— 详见更新后的 3D Secure 指南。
• 仅 Visa BIN 支持。卡片在 PENDING 或 ACTIVE 状态时可修改。
• 仅在卡片显式设置过该字段时返回。未设置时，卡片继承 Account 级 3DS 配置。
• 向后兼容 —— 未传入 enable_3ds 的现有集成无需调整。

​

Issuing

• 生效时间：2026-05-07，北京时间 20:00 左右（UTC+8）
• 可能影响已有集成渲染效果的变更：
  • 页面最大宽度：512px → 1280px。父容器宽度超过 512px 的卡片，渲染宽度会比之前更宽。
  • Iframe 内容高度：原由内容自适应（auto） → 固定为 300px。超过 300px 的内容可能被裁剪或滚动展示。
  • Iframe 容器最小高度：原无限制 → min-height: 400px。内容较短的容器会被撑高至 400px。
  • 底部「Show / Hide data」切换按钮已移除。 敏感数据（卡号、有效期、CVV）的显示/隐藏改为通过 CVV 标签旁边的眼睛图标控制，该图标常驻可见。点击被遮蔽的字段值（****、**/**、***）也可切换显示状态。
• 如需保留之前的固定尺寸，可通过 styles 参数对 .uq-card-container 设置 width / height —— 用法详见安全 Iframe 集成指南。

• 新增选择器：.uq-card-cardholder（持卡人姓名样式）、.uq-page-background（iframe 页面背景，默认 transparent）。
• .uq-card-container 支持 width、height、min-height、max-width、min-width —— 可用于恢复之前的固定尺寸。
• .uq-card-row 支持 display、justify-content、align-items、flex-direction、gap —— 可用于标签/取值的对齐控制。

​

Issuing

• 影响接口：Create Card（请求与响应）
• cardholder_id 改为可选。当不传该字段时，提供完整的 cardholder_required_fields 字段块，系统会在同一次请求中创建持卡人并发卡。
• 向后兼容 —— 已有集成继续传 cardholder_id 时行为不变。
• 完整集成流程见一步发卡指南。

• 影响 Webhook：card.verification.otp
• 该验证 OTP 事件现同时支持 Google Pay 与 Apple Pay 钱包绑定场景。此前仅在 Google Pay 绑定时下发。
• 已有集成无需调整 —— 已订阅 card.verification.otp 的商户会自动收到 Apple Pay 绑定的 OTP 通知。

• 影响接口：Create Cardholder
• 现可成功创建使用科索沃（ISO 3166-1 alpha-2 XK、alpha-3 XKX）手机号的持卡人。
• 国家代码：+383。手机号长度（不含国家代码）：8–9 位。
• 完整国家清单见持卡人手机号校验规则。

​

Issuing

• 当发卡转账状态发生变更（例如从 pending 变为 succeeded 或 failed）时下发的新 Webhook 事件。
• 在 Webhook 配置中订阅 issuing.transfer.status_changed 即可接收该通知。

• 影响 Webhook：card.status.update.succeeded、card.status.update.failed
• 新增 available_balance —— 卡片在状态变更时刻的当前可用余额。
• 新增 currency —— 卡片币种，ISO 4217 格式。

​

Acquiring

• 影响接口：Create Payout（请求）
• 变更内容：
  • 请求体新增可选字段 payout_account_id。
  • 不传时维持现有行为 —— 资金按原配置发送至外部银行账户。
  • 传入时，出款将以 UQPAY 站内转账形式打到指定账户。
  • 长短两种 UQPAY 账户 ID 均可接受。
• 注意事项：
  • payout_account_id 应与调用方账户层级匹配：从子账户调用时传子账户 ID；从主账户调用时传主账户 ID。
  • 该变更非破坏性、向后兼容 —— 已有集成无需调整。

​

Issuing

• 影响接口：Create Cardholder（请求与响应）、Update Cardholder（请求与响应）
• 变更内容：
  • 现支持三级 KYC：
    • SIMPLIFIED —— 仅基础字段，行为与旧版本一致，cardholder_status 立即置为 SUCCESS
    • STANDARD —— 要求 nationality、identity、residential_address，触发审核流程
    • ENHANCED —— 在 STANDARD 基础上额外要求 kyc_verification，支持 THIRD_PARTY 和 SUMSUB_REDIRECT 两种方式
  • 请求新增字段：gender、nationality、identity（对象）、residential_address（对象）、kyc_verification（对象）
  • 响应新增字段：cardholder_status、idv_verification_url、idv_url_expires_at
• 注意事项：
  • 不传新字段时，行为完全向后兼容。
  • 当 cardholder_status 为 PENDING 时，不允许更新 KYC 相关字段。
  • residential_address 替代之前的 delivery_address 字段。

• 影响接口：Retrieve Cardholder（响应）、List Cardholders（请求与响应）
• 变更内容：
  • 响应新增字段：gender、nationality、residential_address、cardholder_status、review_status、idv_status、idv_verification_url、idv_url_expires_at
  • List Cardholders 接受新查询参数 cardholder_status，可按状态过滤。

• 影响接口：Create Card（请求与响应）
• 变更内容：
  • 请求新增可选对象 cardholder_required_fields —— 允许商户在发卡环节补充缺失的持卡人 KYC 字段（包含 gender、nationality、phone_number、date_of_birth、residential_address、identity、kyc_verification）。
  • 响应新增字段：cardholder_status、message
• 注意事项：
  • 当持卡人不满足产品要求且未传 cardholder_required_fields 时，返回 kyc_insufficient 错误，并附带 missing_fields。
  • 当发卡触发 KYC 审核时，卡片进入 PENDING 状态，审核通过后自动激活。

• 影响接口：List Products（响应）
• 变更内容：
  • 每个产品对象新增 required_fields 数组，标识该卡 BIN 要求的持卡人字段。
  • 数组每项包含：name、type（string 或 object）、required（布尔值）、description、fields（当 type 为 object 时的子字段）。

• 新增 Webhook 事件：
  • cardholder.kyc.status_changed —— 持卡人 KYC 状态变更
  • cardholder.updated —— 持卡人信息已更新

​

Acquiring

• 影响接口（仅响应）：Create PaymentIntent、Retrieve PaymentIntent、Update PaymentIntent、Confirm PaymentIntent、Capture PaymentIntent、Cancel PaymentIntent、List PaymentIntents、Retrieve PaymentAttempt、List PaymentAttempts
• 变更内容：
  • PaymentIntent 接口：latest_payment_attempt.payment_method 类型由 string 改为 object
  • PaymentAttempt 接口：payment_method 类型由 string 改为 object
  • PaymentIntent —— latest_payment_attempt 新增字段：auth_code、arn、rrn、advice_code
  • PaymentAttempt —— 顶层新增字段：auth_code、arn、rrn、advice_code
  • PaymentIntent —— 新增对象：latest_payment_attempt.authentication_data
    • 字段：cvv_result、avs_result
    • authentication_data.three_ds 字段：ds_transaction_id、three_ds_version、eci、cavv、three_ds_authentication_status、three_ds_cancellation_reason
  • PaymentAttempt —— 新增对象：authentication_data（结构同上）
• 注意事项：生效时间 2026-03-26

• 影响 Webhook：acquiring.payment_attempt.created、acquiring.payment_attempt.capture_requested、acquiring.payment_attempt.cancelled、acquiring.payment_attempt.failed
• 适用范围：仅卡交易（payment_method.type = "card" 或 "card_present"）
• 变更内容：
  • 通知体新增字段：auth_code、arn、rrn、advice_code
  • 新增对象：authentication_data
    • 字段：cvv_result、avs_result
    • authentication_data.three_ds 字段：ds_transaction_id、three_ds_version、eci、cavv、three_ds_authentication_status、three_ds_cancellation_reason
• 注意事项：生效时间 2026-03-26

​

Card Issuing

• 影响接口：Create Card（请求）
• 变更内容：
  • 新增可选字段 usage_type（枚举：NORMAL、ONE_TIME；默认值：NORMAL）。不传时，卡按标准可重复使用卡处理。
  • 新增可选字段 auto_cancel_trigger（枚举：ON_AUTH、ON_CAPTURE）。当 usage_type 为 ONE_TIME 时必填。定义触发自动注销的交易事件：ON_AUTH 在首次授权通过后立即注销；ON_CAPTURE 在首笔交易请款（结算）成功后注销。
  • 新增可选字段 expiry_at（带时区偏移的日期时间字符串，例如 2026-03-19T18:46:43+08:00）。若该时间点之前未被首笔交易事件触发注销，则到期自动注销并释放未使用的余额。

​

Banking

• 影响接口：Create Virtual Account、Webhook：virtual.account.*
• 变更内容：
  • 新增可选请求头 X-Request-Id（字符串，最长 64 字符）。
  • 若传入，该值将在关联的 Webhook 事件中以 request_id 字段回传。

​

Account Center

• 影响接口：Create SubAccount（请求）
• 变更内容：
  • 新增必填字段 individual_info.employment_status —— 个人就业状态。
  • 新增必填字段 individual_info.industry —— 个人所在行业。
  • 新增必填字段 individual_info.job_title —— 个人职位。
  • 新增必填字段 individual_info.company_name —— 个人所在公司名称。
• 生效时间：2026-03-19

​

Acquiring

• 影响接口：Create PaymentIntent（请求）、Confirm PaymentIntent（请求）
• billing.phone_number 字段不再必填。

• 影响接口：Create PaymentIntent（请求）、Confirm PaymentIntent（请求）
• 新增 googlepay 与 applepay 作为可选支付方式。

​

Banking

• 影响接口：Create Transfer（请求）
• 新增必填请求头参数：x-idempotency-key
• 该变更为破坏性变更，所有 API 调用方必须在 Create Transfer 请求中加入此请求头。
• 生效时间：3 月 19 日

​

Account Center

• 影响接口：Create SubAccount（请求）
• 创建子账户时，proof_documents.proof_of_address 字段不再必填。

​

Issuing

• 影响接口：List Issuing Balances Transactions（请求）
• 新增四个可选过滤参数：
  • transaction_type —— 按交易类型过滤（如授权、冲正、退款、手续费、结算）
  • transaction_status —— 按状态过滤：COMPLETED、PENDING 或 FAILED
  • currency —— 按 ISO 4217 三位币种代码过滤（如 USD、EUR、GBP）
  • transaction_id —— 按精确交易 ID 过滤
• 所有参数均为可选，可单独使用或任意组合。

​

Acquiring

• Create Bank Account
• Retrieve Bank Account
• Update Bank Account
• List Bank Accounts

• 每个币种只能配置一个结算银行账户。
• 已创建的银行账户不可删除。

​

Issuing

​

Account Center

• 影响接口：Create SubAccount（请求）
• business_details.industry 字段现必须传入行业代码列表中的合法值。
• 此前仅校验非空。
• 过渡期：2025-12-25 至 2026-01-01 期间同时接受新旧值。2026-01-01 起强制执行。

• 影响接口：Retrieve Account（响应）、List Connected Accounts（响应）
• business_code 由 string 改为 array[string]。
• 示例："business_code": "BANKING" → "business_code": ["BANKING"]
• 取值范围：BANKING、ACQUIRING、ISSUING
• 已有集成若按单字符串解析，需相应更新。

• 影响接口：Create SubAccount（请求）
• business_type 字段已废弃，将被移除。

​

Acquiring

• 影响接口：Create PaymentIntent（请求）、Confirm PaymentIntent（请求）
• browser_info.mobile 现仅在客户端为移动端时必填。3DS 场景下 PC web 客户端不再要求此字段。

​

Acquiring

• 影响 Webhook：acquiring.payment_intent.*、acquiring.payment_attempt.*
• Webhook 通知体新增字段 static_qrcode、static_qrcode_extension、static_qrcode_number_plate。
• 这些字段仅在静态二维码支付场景下返回。

​

Issuing

• 影响接口：Update Card Status（请求）
• 最大长度：50 个中文字符或 100 个字符。

• 当卡片绑定 Google Pay 需要 OTP 验证时触发。
• 在 Webhook 配置中订阅 card.verification.otp 事件即可接收该通知。

​

Banking

• 影响接口：List Balances Transactions（请求）
• transaction_type 过滤参数新增对 INVOICE 类型的支持。

​

Issuing

• 影响接口：Retrieve Cardholder（响应）、List Cardholders（响应）
• 持卡人响应对象新增 delivery_address 字段，结构如下：

"delivery_address": {
  "city": "Singapore",
  "country": "SG",
  "line1": "9 N Buona Vista Dr",
  "line2": "THE METROPOLIS",
  "state": "Singapore",
  "postal_code": "138666"
}

​

Acquiring

• 影响接口：Create PaymentIntent（请求）、Confirm PaymentIntent（请求）
• browser_info.ip_address 提升至顶层（与 payment_method 同级）。
• 当 payment_method.card.three_ds_action = enforce_3ds 时，ip_address 必填。

​

Acquiring

• 影响接口：Create PaymentIntent（请求）、Confirm PaymentIntent（请求）
• 当 billing.address.country_code 为 "US" 或 "CA" 时，payment_method.card.billing.address.state 现为条件必填。

• 影响接口：Create PaymentIntent、Confirm PaymentIntent
• 新增 7 种支付方式，扩大东南亚市场覆盖范围。

• 新增接口：POST /v2/payment_intents/{id}/capture
• 支持 auto_capture = false 的支付流程，请款窗口可配置 1–24 小时。
• 若窗口期内未手动请款，UQPAY 在窗口结束后自动请款。
• 商户可在请款窗口期内取消订单。

​

Banking

• 影响 Webhook：beneficiary.*
• Webhook 体新增 beneficiary_entity_type 字段。取值："INDIVIDUAL" 或 "COMPANY"。

​

Issuing

• 影响接口：Create Cardholder（请求）
• 以下国家手机号长度校验更新（不含国家/地区/区号）：
  • 尼日利亚（NG）：8 或 10 位
  • 孟加拉国（BD）：8 或 10 位
  • 利比亚（LY）：8 或 9 位
  • 塞内加尔（SN）：7 或 9 位
  • 马约特（YT）：8 或 9 位
  • 厄瓜多尔（EC）：7 或 9 位
• 刚果共和国区号由 2420 改为 242。

​

Account Center

• 影响接口：Create SubAccount（请求）
• 公司类实体新增 ownership_details.representatives.face_docs。
• 个人类实体新增 identity_verification.face_docs。
• 两类实体均新增 tos_acceptance.tos_agreement（可选；置为 1 表示自动签署 TPSP 服务条款）。
• 在 TPSP 主账户下创建子账户时，face_docs 必填。
• 公司类实体：至少一名具备特定职位的代表人需提供人脸验证文件。

​

Acquiring

• Retrieve Balance
• List Balances
• Create Payout
• Retrieve Payout
• List Payouts —— 出款状态实时更新可通过 Webhook 接收。

​

Banking

• 影响接口：Create Payout（请求）、Create Beneficiary（请求）
• company_name 与 account_holder 字段新增对中文括号 （） 的支持。
• 仅在 bank_country_code = CN、account_currency_code = CNH、payment_method = LOCAL、entity_type = COMPANY 场景下生效。

• 影响接口：Create Payout（请求）、Create Beneficiary（请求）
• 当 payment_method = LOCAL 且 account_currency_code 不为 CNH 或 SGD 时，移除对 bank_details.account_holder、first_name、last_name、company_name、address.street_address、address.city、address.state 的校验。

• 影响接口：Create Payout（请求）
• SWIFT 出款：新增模式 /^[a-zA-Z0-9/-?:().'+, ]+$/（支持空格及更多特殊字符）。
• LOCAL 出款且币种非 CNH/非 SGD：不做校验。

• 影响接口：Create Payout（请求）
• 当 beneficiary.bank_details.account_currency_code = "INR" 且 clearing_system = "IFSC" 时，必须上传发票文件。
• 文件需通过 documentation 字段上传。

• 影响接口：Create Payout（请求）
• purpose_code 字段移除 OTHER_SERVICES 取值。已有集成若使用该值需更新。

​

Acquiring

• 当客户认证阶段 Payment Intent 状态变为 REQUIRES_CUSTOMER_ACTION 时触发。

​

Account Center

• 影响接口：Create SubAccount（请求）
• 以下字段现接收数组而非单一对象：
  • identity_verification.identity_docs
  • ownership_details.shareholder_docs
  • ownership_details.representatives.identity_docs
  • company_info.certification_of_incorporation
  • proof_documents.proof_of_address
  • proof_documents.source_of_funds
  • proof_documents.proof_of_position_and_income

​

Banking

• Create Quote：新增 transaction_type 字段 —— conversion（默认）用于换汇；payout 用于跨币种出款。
• Create Payout：新增 payout_currency、payout_amount、quote_id 字段。
• Retrieve Payout / List Payouts：新增 quote_id 与 conversion 字段（currency_pair、client_rate）。
• Webhook payout.*：新增 conversion、quote_id、payout_amount、payout_currency 字段。

• 影响接口：Create Beneficiary（请求）、Create Payout（请求）
• 影响字段：bank_details.account_holder、first_name、last_name、company_name、address.street_address、address.city、address.state
• 新校验适用于除 bank_details.account_currency_code = CNH、payment_method = LOCAL、bank_country_code = CN 之外的所有场景。
• 仅允许英文字符、数字、特殊字符与空格。
• 新加坡 SGD 个人账户（entity_type = INDIVIDUAL、bank_country_code = SG、account_currency_code = SGD）下，account_holder 适用更严格的校验。

• 影响接口：Create Payout（请求）
• 仅允许英文字母、数字、空格、逗号（,）和句点（.）。

​

Issuing

• 新增接口：Bulk Create Virtual Cards
• 新增 Webhook：issuing.report.succeeded —— 用于下发卡号文件的解密密钥。
• Assign Card 接口扩展，支持绑定批量创建出的虚拟卡。
• 提交后返回 report_id，需在过期前通过 Download Report 接口下载卡号文件。
• 调用 Bulk Create Virtual Cards 之前，必须先订阅 issuing.report.succeeded。

• 影响报表：Card Transaction Report、Card Settlement Report
• 新增字段 Ori Transaction Id。

​

Banking

• 影响接口：Create Beneficiary（请求）、Create Payout（请求）
• email：必填 → 可选
• nickname：必填 → 可选

• 影响接口：Create Beneficiary（请求）、Create Payout（请求）
• 移除：company_name、first_name、last_name、address.country、address.street_address、address.city、address.state、address.postal_code
• 改为可选：email、nickname

• 影响接口：Create Beneficiary（请求）、Create Payout（请求）
• 适用条件：entity_type = INDIVIDUAL、bank_country_code = SG、account_currency_code = SGD。
• 新校验：仅允许英文字母（A–Z、a–z）和空格；2–140 字符；必须包含一个空格分隔名与姓。

​

Issuing

• 影响接口：List Cards（响应）、Retrieve Card（响应）
• 新增 consumed_amount 字段，表示已使用的累计卡片限额。

​

Account Center

• 影响接口：Retrieve Account（请求与响应）、List Connected Accounts（响应）
• Retrieve Account 新增可选过滤参数 business_code —— 取值：BANKING、ISSUING、ACQUIRING（默认：BANKING）。
• Retrieve Account 与 List Connected Accounts 响应新增 business_code 字段。

• 影响接口：Create SubAccount（请求）
• ownership_details.representatives[] 新增可选字段 email_address。

• 影响接口：Create SubAccount（请求）
• business_details.website_url：必填 → 可选
• business_details.company_description：必填 → 可选

​

Issuing

• 影响接口：Simulate Authorization
• 新增对 BIN 40963608 的沙箱授权模拟支持。无 schema 变更。

​

Acquiring

• acquiring.payment_attempt.created —— PA 状态变为 INITIATED 时触发
• acquiring.payment_attempt.capture_requested —— PA 状态变为 CAPTURE_REQUESTED 时触发（消费者完成支付，对应 PI 进入 SUCCESS）
• acquiring.payment_attempt.cancelled —— PA 状态变为 CANCELLED 时触发
• acquiring.payment_attempt.failed —— PA 状态变为 FAILED 时触发

• 新增接口：GET /api/v2/payment/settlements
• 支持可选参数 settlement_batch_id 或 payment_intent_id，支持分页与时间范围过滤。
• 仅返回 settlement_status = success 的记录。

​

Banking

• 影响接口：Create Payout（请求）、Create Beneficiary（请求）
• 仅接受字母 A–Z/a–z 与数字 0–9。空格、连字符及其他特殊字符将被拒绝。

​

Issuing

• 影响接口：List Cards（响应）、Retrieve Card（响应）、Update Card Status（响应）
• 影响 Webhook：card.status.update.*
• 新增 update_reason 字段，标识卡状态变更原因。

• 影响接口：Card Recharge（请求）、Card Withdraw（请求）
• SHARE 卡现可通过 Recharge（增加）和 Withdraw（减少）调整 card_available_balance。
• SINGLE 卡行为不变。

​

Issuing

• 影响接口：Create Card（请求）
• BIN 527735、555071、555243：card_limit 必填且必须 ≥ 0.01。
• 其他 BIN：card_limit 可选；不传时默认为 0；传入时必须 ≥ 0 且最多保留两位小数。

• 影响接口/报表：List Issuing Balances Transactions（响应）、Account Transaction Report
• 新增：FUNDS_TRANSFER_IN、FUNDS_TRANSFER_OUT、FEE_REFUND、FEE_DEDUCTION、MARGIN_PAYMENT、MARGIN_REFUND、OTHER

• 影响接口：Retrieve Cards Transaction（响应）、List Cards Transactions（响应）
• 新增：CHARGEBACK_DEBIT、CHARGEBACK_CREDIT

• issuing.transaction.chargeback.credit —— 卡交易记入拒付贷记时触发
• issuing.transaction.chargeback.debit —— 卡交易记入拒付借记时触发

​

Banking

• 影响接口：Retrieve Deposit（响应）、List Deposits（响应）
• 影响 Webhook：deposit.pending、deposit.compliance.rejected、deposit.completed
• 新增 deposit_reference 字段，可携带自定义引用号。

​

Issuing

• card.update.succeeded —— Update Card 触发的卡订单完成 SUCCESS 时触发
• card.update.failed —— Update Card 触发的卡订单完成 FAILED 时触发

• 影响接口：List Issuing Balances Transactions（响应）
• ending_balance —— 交易完成后的账户余额
• description —— 交易简短描述

• 影响报表：Card Settlement Report
• Transaction Type 枚举值 ATM Withdraw 重命名为 Authorization。

​

Banking

• 影响接口：Retrieve Payout（响应）、List Payouts（响应）
• 新增 purpose_code 字段。

• 影响接口：Check Beneficiary（请求）
• 新增 additional_info.proxy_id 参数，接受 PayNow 代理标识。

​

Issuing

• 影响报表：Card Settlement Report
• Transaction Type 取值 Purchase 重命名为 Authorization。

​

Account Center

• 影响接口：Create SubAccount —— POST /v1/accounts/create_accounts（请求）；Retrieve Account —— GET /v1/accounts/{id}（响应）
• 新增可选字段 other_documents，可为代表人上传地址证明或补充文件。
• 注意：请求与响应中的字段名不同（请求为 doc_str，响应为 front）。

"other_documents": [
  {
    "type": "PROOF_OF_ADDRESS",
    "doc_str": "base64 string or file ID"
  }
]

"other_documents": [
  {
    "type": "PROOF_OF_ADDRESS",
    "front": "base64 string or file ID"
  }
]

​

Account Center

• 新增接口：POST /api/v1/accounts/create_accounts
• 支持在 ACQUIRING、BANKING、ISSUING 业务线下创建子账户。
• 同时支持 COMPANY 与 INDIVIDUAL 实体类型。
• 通过该接口创建的子账户仍可通过 List Connected Accounts 与 Retrieve Account 查询。

• 新增接口：GET /api/v1/accounts/get_additional
• 根据国家与业务码返回 COMPANY 子账户创建所需的必要与可选文件类型。
• 在发起子账户创建前调用以获取该清单。

​

Acquiring

• 当 Payment Intent 因到期被自动关闭时触发。
• 手动取消的订单不触发此事件。
• 在控制台订阅该事件即可接收。

​

Issuing

• 影响接口：List Cards Transactions（响应）、Retrieve Cards Transaction（响应）
• transaction_status 新增合法取值 PENDING。

​

Banking

• 影响接口：Create Payout、Retrieve Payout、Create Beneficiary、List Beneficiaries、Retrieve Beneficiary、Update Beneficiary、Check Beneficiary
• bank_details.clearing_system 新增枚举值 PayNow。
• 新增 additional_info.proxy_id 字段，支持 UEN、手机号或 VPA。

​

Acquiring / Account

• 影响接口：所有 POST 接口（请求头）
• x-idempotency-key 现必须为合法 UUID 格式。

​

Acquiring

• PaymentAttempt 响应新增 failure_code 字段，标识支付尝试的失败原因。

​

Banking

• 影响接口：POST /api/v1/payouts（请求）
• 新增可选字段 documentation，允许在出款请求中附带支持文件。

​

Issuing

• card.create.succeeded Webhook 体新增 risk_controls 模块。返回值（如 3ds、mcc）因卡产品而异。

​

Issuing

• 影响接口：List Cards Transactions（响应）、Retrieve Cards Transaction（响应）
• 影响 Webhook：issuing.transaction.*
• 影响报表：Card Transactions Report、Card Settlement Report
• 新增 wallet_type 字段，标识所使用的数字钱包（如 ApplePay、GooglePay）。

​

Acquiring

​

Banking

• 影响接口：POST /api/v1/accounts（请求）
• representatives[] 新增可选字段 other_documentation，支持在创建账户时上传地址证明等补充文件。

​

Issuing

• 影响 Webhook：card.create.*、card.recharge.*、card.withdraw.*
• 新增 card_available_balance，标识事件发生时刻的卡可用余额。

​

Banking

• 影响接口：POST /api/v1/beneficiaries（请求）
• 新增可选字段 additional_info.organization_code（统一社会信用代码），用于公司类收款人。

• 影响接口：GET /api/v1/payouts/{id}（响应）、GET /api/v1/payouts（响应）
• 出款响应对象新增 failure_reason 字段。

​

Issuing

• 影响接口：GET /api/v1/issuing/products（响应）
• 新增 card_currency 字段 —— 字符串数组，标识每款卡产品支持的币种。例如：["SGD", "USD"]。

• 影响接口：GET /api/v1/issuing/products（响应）
• card_form —— 支持的卡形态：["VIR", "PHY"] 或 ["VIR"]。
• max_card_quota —— 当前账户下该产品可发卡的最大数量。

• 影响接口：GET /api/v1/issuing/transactions（响应）、GET /api/v1/issuing/transactions/{id}（响应）
• 影响 Webhook：issuing.transaction.*
• 当 transaction_status = DECLINED：字段内容为失败原因。
• 当 transaction_status = APPROVED：字段内容为补充备注（例如 3DS 交易的 3DS Fee）。
• 所有此前以 failure_reason 作为列名的交易报表文件，列名同步更新为 description。

• transaction_status 移除 REFUNDED 取值。
• 此前的 REFUNDED 交易现映射为 transaction_type: REFUND + transaction_status: APPROVED。

• 影响接口：GET /api/v1/issuing/cards/{id}（响应）、GET /api/v1/issuing/cards（响应）、POST /api/v1/issuing/cards/{id}/status（请求）、card.status.update.* Webhook
• INACTIVE 重命名为 FROZEN —— 卡片暂时停用，可重新激活。
• 新增 BLOCKED 状态 —— 卡片被 UQPAY 管理员锁定；解锁需提交正式邮件申请。

​

Banking

• 影响接口：POST /api/v1/payouts（响应）、GET /api/v1/payouts（请求与响应）、GET /api/v1/payouts/{id}（响应）
• payout_status 字段移除 SUBMISSION_FAILED 取值。

​

Issuing

• 影响接口：GET /api/v1/issuing/cards（请求）
• 新增可选查询参数 cardholder_id，可按持卡人过滤卡片。

• 影响接口：GET /api/v1/issuing/cards/{id}（响应）
• 新增 no_pin_payment_amount 字段，标识免 PIN 交易的允许金额。格式：<金额><币种>（例如 2000USD）。

• 影响接口：GET /api/v1/issuing/products（响应）
• 新增 no_pin_payment_amount 数组，标识每款产品配置的免 PIN 交易金额上限。

​

Acquiring

• 影响接口：Payment Intents、Payment Attempts、Payment Refunds 接口
• 调整 intent_status、attempt_status、refund_status 的枚举值与定义。最新枚举请参考 API 参考页面。

• 影响接口：Payment Intents 接口
• 支持取值：card、card_present、alipaycn、alipayhk、unionpay、wechat。其余类型暂不支持。

​

Issuing

• GET /api/v1/issuing/cards 新增可选查询参数 cardholder_id。

• GET /api/v1/issuing/cards/{id} 响应新增 no_pin_payment_amount 字段。格式：<金额><币种>（例如 2000USD）。

• GET /api/v1/issuing/products 响应新增 no_pin_payment_amount 数组，标识每个币种的免 PIN 交易最大允许金额。

​

Acquiring

​

Banking

• 影响接口：Create Beneficiary、Update Beneficiary、Retrieve Beneficiary、List Beneficiaries
• 新增 nationality —— 收款人国籍的两位字母国家代码。
• 新增 id_number —— 当 INDIVIDUAL 类型收款人为中国大陆居民、币种为 CNH、支付方式为 LOCAL 时条件必填。

​

Issuing

• 影响接口：POST /api/v1/issuing/cards（Create Card）、POST /api/v1/issuing/cards/{id}（Update Card）
• risk_controls 对象新增可选字段 allowed_mcc 与 blocked_mcc。
• 同一张卡只能配置其中一个。MCC 须以字符串数组传入（例如 ["5999", "6011"]）。

​

Issuing

• 影响接口：List Cardholders（响应）、Retrieve Cardholder（响应）
• 新增 number_of_cards 字段。

​

Issuing

• 影响接口：所有支持 x-on-behalf-of 请求头的接口
• 若传入，该值必须是对应已存在子账户的合法 UUID。非法值将被拒绝。

​

Issuing

• 影响接口：POST /api/v1/issuing/cards/activate（请求）
• 新增必填字段 pin。
• 新增可选字段 no_pin_payment_amout。
• 该变更为破坏性变更，已有集成必须更新以包含 pin 字段。

​

Issuing

• 影响接口：POST /api/v1/issuing/cards、POST /api/v1/issuing/cards/{id}
• 新增可选字段 risk_controls。向后兼容 —— 已有卡片在未显式配置时不受影响。

​

Banking

• 新增接口：GET /api/v1/exchange/rates
• 返回当前汇率。仅供参考 —— 锁汇请使用 Create Quote 接口。

​

Banking

• 新增 Webhook 事件类型 rfi.transaction.action_required，适用于充值与出款的 RFI 场景。
• 影响接口：GET /api/v1/rfis/{id}（Retrieve RFI）、POST /api/v1/rfis/answer（Answer RFI）
• 两接口均新增 rfi_type 与 transaction_type 字段。
• 原有的开户 RFI 流程（event_type = rfi.action_required）保持不变。

​

Issuing

• 影响接口：POST /api/v1/issuing/cardholders/{id}（请求）
• 新增可选字段 email。向后兼容。

​

Banking

• 新增 changelog 文档。
• 新增充值类 Webhook：deposit.pending、deposit.compliance.rejected、deposit.completed
• 新增充值类接口：
  • GET /api/v1/deposit —— 列出充值
  • GET /api/v1/deposit/{id} —— 按 ID 查询单笔充值
  • POST /api/v1/simulation/desposit —— 模拟向全球账户充值（仅沙箱）
• 描述与参数限制的文档修正。