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

cardIdx integer required
Card IDX.
Le Card IDX peut être consulté sur la page « Carte de Tampons » du tableau de bord.
domain string
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.
strtYmd date required
Date de début de validité du tampon. Exemple : 2025-01-01
endYmd date required
Date d’expiration du tampon. Exemple : 2025-12-31
La date d’expiration peut être définie jusqu’à 5 ans à compter d’aujourd’hui.
activeYn string
Default :Y
Enum :
YN
Statut d’activation du tampon.
Si désactivé, les clients ne pourront pas utiliser le tampon.
memo string
Note interne à des fins de référence.
userId string
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.
userNm string
Nom de l’utilisateur. Usage interne uniquement.
userPhnno string
Numéro de téléphone de l’utilisateur. Usage interne uniquement.
userEml string
Adresse e-mail de l’utilisateur. Usage interne uniquement.
userEtc1 string
Champ supplémentaire pour la gestion interne.
userEtc2 string
Champ supplémentaire pour la gestion interne. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

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