1. 支付卡管理
EasySub-API
  • API指南
  • 登录态与订阅调用示例
  • 订阅任务
    • 1-查询启用方案
    • 2-提交订阅任务
    • 3-查询订阅任务
  • 支付卡管理
    • 1-查询支付卡列表
      GET
    • 2-新增支付卡
      POST
    • 3-查询支付卡详情
      GET
    • 4-修改支付卡
      PUT
    • 5-删除支付卡
      DELETE
    • 6-批量导入支付卡
      POST
    • 7-批量修改支付卡
      POST
    • 8-启用或停用支付卡
      POST
    • 9-批量删除支付卡
      POST
    • 10-查询支付卡使用记录
      GET
    • 11-查询支付卡导入模板
      GET
  1. 支付卡管理

4-修改支付卡

联调中
PUT
/api/v1/partner/payment-cards/{id}
保存支付卡的完整配置;省略配置会使用默认值或清空关联。卡号和 CVC 省略或留空时保留原值。
修改部分字段请使用批量修改接口。同一组织内卡号唯一。

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例
{
    "exp_month": "08",
    "exp_year": "2039",
    "max_uses": 5,
    "priority": 100,
    "status": "enabled",
    "remark": "更新备注",
    "checkout_profile_id": null,
    "billing_address_id": null
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT '/api/v1/partner/payment-cards/1' \
--header 'Authorization: Bearer {{api_key}}' \
--header 'Content-Type: application/json' \
--data '{
    "exp_month": "08",
    "exp_year": "2039",
    "max_uses": 5,
    "priority": 100,
    "status": "enabled",
    "remark": "更新备注",
    "checkout_profile_id": null,
    "billing_address_id": null
}'

返回响应

🟢200成功
application/json
HTTP 200 业务响应,结果由 status_code 判断。
Bodyapplication/json

示例
{
    "status_code": 0,
    "msg": "success",
    "data": {
        "id": 1,
        "owner_org_id": 1,
        "card_scene": "subscription",
        "card_number": "**** **** **** 4242",
        "cvc": "***",
        "card_number_bin": "424242",
        "card_number_last4": "4242",
        "exp_month": "08",
        "exp_year": "2039",
        "remark": "string",
        "status": "enabled",
        "max_uses": 0,
        "success_uses": 0,
        "reserved_uses": 0,
        "failure_count": 0,
        "remaining": 0,
        "priority": 0,
        "checkout_profile_id": 1,
        "billing_address_id": 1,
        "checkout_profile_name": "string",
        "billing_address_name": "string",
        "api_recharge_profile_id": 1,
        "api_recharge_profile_name": "string",
        "last_reserved_at": "2019-08-24T14:15:22.123Z",
        "last_used_at": "2019-08-24T14:15:22.123Z",
        "disabled_at": "2019-08-24T14:15:22.123Z",
        "disabled_reason": "string",
        "health_policy_action": "string",
        "health_policy_rule_id": "string",
        "health_policy_rule_name": "string",
        "health_policy_applied_at": "2019-08-24T14:15:22.123Z",
        "health_suspended_until": "2019-08-24T14:15:22.123Z",
        "created_by_id": 1,
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "bound_cdk_count": 0,
        "success_consumption": [
            {
                "currency": "string",
                "amount_minor": 0,
                "success_uses": 0
            }
        ]
    }
}
修改于 2026-10-10 15:18:15
上一页
3-查询支付卡详情
下一页
5-删除支付卡
Built with