2-新增支付卡

联调中

POST

/api/v1/partner/payment-cards

新增支付卡。可通过 checkout_profile_id 关联方案，省略时为通用卡。

同一组织内卡号唯一，不同组织可分别添加同一卡号。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "card_number": "4242424242424242",
    "exp_month": "08",
    "exp_year": "2039",
    "cvc": "123",
    "max_uses": 5,
    "priority": 100,
    "status": "enabled",
    "remark": "API 导入"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/partner/payment-cards' \
--header 'Authorization: Bearer {{api_key}}' \
--header 'Content-Type: application/json' \
--data '{
    "card_number": "4242424242424242",
    "exp_month": "08",
    "exp_year": "2039",
    "cvc": "123",
    "max_uses": 5,
    "priority": 100,
    "status": "enabled",
    "remark": "API 导入"
}'

返回响应

🟢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

1-查询支付卡列表

3-查询支付卡详情