Onerway
POST

操作卡片

使用此接口对卡片执行状态操作,例如冻结、解冻或注销。

请求

ApiKey
Onerway 分配的发卡 API key 请求 Header。
示例:
clientRequestId
本次卡片操作的幂等请求 ID。
示例:
cardId
待操作的卡片 ID。
示例:
type
卡片操作类型。
可选值
FREEZE
冻结卡片。
UNFREEZE
解冻卡片。
TERMINATE
注销卡片。

请求示例

curl -X POST 'https://sandbox-api.onerway.com/api/v1/merchant/card/operate' \
  -H 'ApiKey: replace_with_issuing_api_key' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "cardId": 100001,
  "clientRequestId": "REQ_20260101_002",
  "type": "FREEZE"
}'

响应

respCode
业务响应码;20000 表示成功。
respMsg
响应信息。
卡片操作结果。

响应示例

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "operateRecordId": 200001
  }
}
该接口暂未记录错误响应。