Onerway
POST

创建卡片

使用此接口为持卡人创建指定卡产品的卡片,并设置初始充值金额。

请求

ApiKey
Onerway 分配的发卡 API key 请求 Header。
示例:
clientRequestId
开卡幂等请求 ID。
示例:
cardholderId
与卡片关联的持卡人 ID。
示例:
productId
与 Onerway 确认的卡产品 ID。
示例:
amount
卡片初始充值金额。
示例:
约束
规则
必须大于 0,最多支持 2 位小数。

请求示例

curl -X POST 'https://sandbox-api.onerway.com/api/v1/merchant/card/createCard' \
  -H 'ApiKey: replace_with_issuing_api_key' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "amount": 100,
  "cardholderId": 300001,
  "clientRequestId": "REQ_20260101_001",
  "productId": 1
}'

响应

respCode
业务响应码;20000 表示成功。
respMsg
响应信息。
创建后的卡片信息。

响应示例

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