Onerway
POST

Update cardholder

View as Markdown
Use this endpoint to update an existing cardholder's profile information.

Request

ApiKeystringrequired
Issuing API key request header assigned by Onerway.
Example:replace_with_issuing_api_key
merchantNointegerrequired
Merchant number assigned by Onerway.
Example:88888
cardholderIdintegerrequired
Cardholder ID to update.
Example:300001
firstNamestringrequired
Cardholder first name.
lastNamestringrequired
Cardholder last name.
emailstringrequired
Cardholder email address.
mobilestringoptional
Cardholder mobile number.
Example:13800138000
mobileAreaCodestringoptional
Mobile area code.
Example:+86
birthDaystringoptional
Date of birth.
Example:1990-01-01
nationalitystringoptional
Nationality as an ISO 3166-1 alpha-2 code.
Example:CN
addressCountryCodestringoptional
Address country or region code.
addressStateCodestringoptional
State or province code.
addressCityCodestringoptional
City code.
addressDetailLine1stringoptional
Address line 1.
addressDetailLine2stringoptional
Address line 2.
addressPostalCodestringoptional
Postal code.
remarkstringoptional
Remark.
Example:example remark

Request example

curl -X POST 'https://sandbox-api.onerway.com/api/v1/merchant/cardholder/updateCardholder' \
  -H 'ApiKey: replace_with_issuing_api_key' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "addressCityCode": "GZ",
  "addressCountryCode": "CN",
  "addressDetailLine1": "Example address line 1",
  "addressPostalCode": "510000",
  "addressStateCode": "GD",
  "cardholderId": 300001,
  "email": "example_cardholder@example.com",
  "firstName": "Alex",
  "lastName": "Chen",
  "merchantNo": 88888
}'

Response

respCodestring
Business response code. 20000 means success.
respMsgstring
Response message.
Updated cardholder information.

Response example

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "cardholderId": 300001,
    "firstName": "Alex",
    "lastName": "Chen",
    "email": "example_cardholder@example.com",
    "mobile": null,
    "mobileAreaCode": null,
    "birthDay": null,
    "nationality": "CN",
    "addressRegionCode": "CN",
    "addressStateCode": "GD",
    "addressCityCode": "GZ",
    "addressDetailLine1": "Example address line 1",
    "addressDetailLine2": null,
    "addressPostalCode": "510000",
    "remark": null
  }
}
No error responses are documented for this endpoint.

Create cardholder

Create a cardholder under the merchant account.

Query cardholders

Query cardholders under the merchant account with pagination and optional filters.