Onerway
POST

创建持卡人

查看 Markdown
使用此接口在开卡前创建持卡人。

请求

ApiKeystring必填
Onerway 分配的发卡 API key 请求 Header。
示例：replace_with_issuing_api_key
merchantNointeger必填
Onerway 分配的商户号。
示例：88888
clientRequestIdstring必填
幂等请求 ID。
示例：REQ_CH_20260101_001
firstNamestring必填
持卡人名。
lastNamestring必填
持卡人姓。
emailstring必填
持卡人邮箱。
约束
规则
必须是合法邮箱地址。
mobilestring可选
持卡人手机号。
示例：13800138000
mobileAreaCodestring可选
手机国际区号。
示例：+86
birthDaystring可选
出生日期。
示例：1990-01-01
nationalitystring可选
国籍，使用 ISO 3166-1 alpha-2 两位代码。
示例：CN
addressRegionCodestring可选
地址国家或地区代码。
addressStateCodestring可选
州 / 省代码。
addressCityCodestring可选
城市代码。
addressDetailLine1string可选
地址行 1。
addressDetailLine2string可选
地址行 2。
addressPostalCodestring可选
邮编。
remarkstring可选
备注。
示例：example remark

请求示例

curl -X POST 'https://sandbox-api.onerway.com/api/v1/merchant/cardholder/createCardholder' \
  -H 'ApiKey: replace_with_issuing_api_key' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "addressCityCode": "SZ",
  "addressDetailLine1": "Example address line 1",
  "addressPostalCode": "518000",
  "addressRegionCode": "CN",
  "addressStateCode": "GD",
  "birthDay": "1990-01-01",
  "clientRequestId": "REQ_CH_20260101_001",
  "email": "example_cardholder@example.com",
  "firstName": "Alex",
  "lastName": "Chen",
  "merchantNo": 88888,
  "mobile": "13800138000",
  "mobileAreaCode": "+86",
  "nationality": "CN"
}'

响应

respCodestring
业务响应码；20000 表示成功。
respMsgstring
响应信息。
持卡人信息。

响应示例

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "cardholderId": 300001,
    "firstName": "Alex",
    "lastName": "Chen",
    "email": "example_cardholder@example.com",
    "mobile": "13800138000",
    "mobileAreaCode": "+86",
    "birthDay": "1990-01-01",
    "nationality": "CN",
    "addressRegionCode": "CN",
    "addressStateCode": "GD",
    "addressCityCode": "SZ",
    "addressDetailLine1": "Example address line 1",
    "addressDetailLine2": null,
    "addressPostalCode": "518000",
    "remark": null
  }
}
该接口暂未记录错误响应。

查询卡片敏感信息

从安全的服务端环境查询卡号、CVV 和有效期等敏感信息。

更新持卡人

更新已有持卡人的资料信息。