Create Stamp

This API allows you to issue a new stamp to a customer.

The Card IDX is a required field and can be found on the “Stamp Card” page in the dashboard.

This API is available only for Personal plans or higher.

POST

/api/stamp/v1/create 

{
    "cardIdx": 123,  // You can check the IDX value on the card management page of the dashboard.
    "domain": "https://vvd.bz",
    "strtYmd": "2025-01-01",
    "endYmd": "2025-12-31",
    "activeYn": "Y",
    "memo": "New Member Registration, IP: 211.111.222.33",
    "userId": "att78z",
    "userNm": "Brown Smith",
    "userPhnno": "+1 123-4567-8900",
    "userEml": "test@gmail.com",
    "userEtc1": "Gold rating",
    "userEtc2": ""
}

Request Parameters

cardIdxintegerrequired
Card IDX.
The Card IDX can be found on the “Stamp Card” page in the dashboard.
domainstring
Default:https://vvd.bz
Stamp domain.
If left empty, it will be saved using the default domain.
Available for Premium plans or higher — you can specify a custom domain registered in the Link Domain Management section.
strtYmddaterequired
Stamp validity start date. Example: 2025-01-01
endYmddaterequired
Stamp validity end date. Example: 2025-12-31
The expiration date can be set up to 5 years from today.
activeYnstring
Default:Y
Enum:
YN
Stamp activation status.
If deactivated, customers will not be able to use the stamp.
memostring
Internal memo for reference.
userIdstring
User ID.
Used to manage the recipient of the stamp issuance.
Typically, enter the login ID of a website member.
If not specified, the system will automatically generate a user ID.
userNmstring
User name. For internal management.
userPhnnostring
User contact number. For internal management.
userEmlstring
User email address. For internal management.
userEtc1string
Additional internal management field.
userEtc2string
Additional internal management field. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

codeinteger
Response code: 0 = Success, other values = Error
messagestring
Response message. If the response code is not 0, an error message is returned.
resultinteger
Response value. The generated Stamp IDX will be returned.
Example: 1347