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

cardIdx integer required
Card IDX.
The Card IDX can be found on the “Stamp Card” page in the dashboard.
domain string
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.
strtYmd date required
Stamp validity start date. Example: 2025-01-01
endYmd date required
Stamp validity end date. Example: 2025-12-31
The expiration date can be set up to 5 years from today.
activeYn string
Default:Y
Enum:
YN
Stamp activation status.
If deactivated, customers will not be able to use the stamp.
memo string
Internal memo for reference.
userId string
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.
userNm string
User name. For internal management.
userPhnno string
User contact number. For internal management.
userEml string
User email address. For internal management.
userEtc1 string
Additional internal management field.
userEtc2 string
Additional internal management field. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

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