Créer un Tampon

Cette API permet d’émettre un nouveau tampon pour un client.

Le Card IDX est obligatoire et peut être consulté sur la page « Carte de Tampons » du tableau de bord.

Cette API est disponible uniquement à partir du plan Personal.

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.
Le Card IDX peut être consulté sur la page « Carte de Tampons » du tableau de bord.
domainstring
Default :https://vvd.bz
Domaine des tampons.
Si ce champ est vide, le domaine par défaut sera utilisé.
Disponible à partir du plan Premium : vous pouvez définir un domaine personnalisé enregistré dans la section Gestion des Domaines de Liens.
strtYmddaterequired
Date de début de validité du tampon. Exemple : 2025-01-01
endYmddaterequired
Date d’expiration du tampon. Exemple : 2025-12-31
La date d’expiration peut être définie jusqu’à 5 ans à compter d’aujourd’hui.
activeYnstring
Default :Y
Enum :
YN
Statut d’activation du tampon.
Si désactivé, les clients ne pourront pas utiliser le tampon.
memostring
Note interne à des fins de référence.
userIdstring
ID utilisateur.
Utilisé pour gérer le destinataire de l’émission du tampon.
En général, saisissez l’identifiant de connexion du membre du site web.
Si ce champ n’est pas défini, un ID utilisateur sera automatiquement généré par le système.
userNmstring
Nom de l’utilisateur. Usage interne uniquement.
userPhnnostring
Numéro de téléphone de l’utilisateur. Usage interne uniquement.
userEmlstring
Adresse e-mail de l’utilisateur. Usage interne uniquement.
userEtc1string
Champ supplémentaire pour la gestion interne.
userEtc2string
Champ supplémentaire pour la gestion interne. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

codeinteger
Code de réponse : 0 = Succès, autres valeurs = Erreur
messagestring
Message de réponse. Si le code n’est pas 0, un message d’erreur est renvoyé.
resultinteger
Valeur de réponse. Le Stamp IDX généré sera renvoyé.
Exemple : 1347