Edit Stamp

This API allows you to modify existing stamp information.

You can update details such as the customer’s collected stamps (stamps), benefit usage status (useYn), and PIN reset option (resetPinYn).

This API is available for Personal plans and higher.

PUT

/api/stamp/v1/update 

{
    "stampIdx": 1457,
    "cardIdx": 172,
    "stamps": 7,
    "resetPinYn": "Y",
    "userEml": "example@gmail.com"
}

Request Parameters

stampIdx integer required
Stamp IDX.
cardIdx integer
Card IDX.
The Card IDX can be found on the “Stamp Card” page in the dashboard.
stamps integer
Specifies the number of collected stamps.
Represents the total number of stamps the customer has collected. Updating this value refreshes the stamp progress and can either increase or decrease it.
When all stamps are collected (stamps = the card’s maximum stamp count), you must set useYn to Y to mark the stamp as redeemed.
resetPinYn string
Default:N
Enum:
YN
Determines whether to reset the customer’s PIN code for the stamp.
Y: Resets the customer’s existing PIN. After reset, the customer must set a new PIN upon the next visit to the stamp page.
N: Keeps the current PIN unchanged.
useYn string
Default:N
Enum:
YN
Specifies whether the customer has used the stamp reward.
Y: The customer has collected all stamps and redeemed a reward (e.g., free drink, discount, etc.). After redemption, the stamp becomes inactive and a new one must be issued.
N: The reward has not been used yet.
domain string
Default:https://vvd.bz
Stamp domain.
If empty, the default domain will be used.
Available for Premium plans or higher — you can specify a custom domain registered in the Link Domain Management section.
strtYmd date
Stamp start date. Example: 2025-01-01
endYmd date
Stamp expiration date. Example: 2025-12-31
The expiration date can be set up to 5 years from today.
activeYn string
Default:Y
Enum:
YN
Indicates whether the stamp is active. If disabled, the customer cannot use the stamp.
memo string
Internal memo for reference.
userId string
User ID. Used to manage the stamp recipient.
Typically, enter the website member’s login ID.
If not specified, a unique user ID is automatically generated by the system.
userNm string
User name. For internal use only.
userPhnno string
User contact number. For internal use only.
userEml string
User email address. For internal use only.
userEtc1 string
Additional internal field for management purposes.
userEtc2 string
Additional internal field for management purposes. 
{
    "code": 0,
    "message": "",
    "result": null
}

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 null