Stempel Erstellen

Diese API ermöglicht es, einem Kunden einen neuen Stempel auszustellen.

Die Karten-IDX ist ein Pflichtfeld und kann auf der Seite „Stempelkarte“ im Dashboard eingesehen werden.

Diese API ist nur im Personal-Tarif oder höher verfügbar.

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
Karten-IDX.
Die Karten-IDX kann auf der Seite „Stempelkarte“ im Dashboard eingesehen werden.
domainstring
Default:https://vvd.bz
Stempel-Domain.
Wenn kein Wert angegeben wird, wird die Standarddomain verwendet.
Verfügbar im Premium-Tarif oder höher – Sie können eine benutzerdefinierte Domain angeben, die im Bereich „Link-Domain-Verwaltung“ registriert ist.
strtYmddaterequired
Startdatum der Stempelgültigkeit. Beispiel: 2025-01-01
endYmddaterequired
Ablaufdatum des Stempels. Beispiel: 2025-12-31
Das Ablaufdatum kann bis zu 5 Jahre ab dem heutigen Datum festgelegt werden.
activeYnstring
Default:Y
Enum:
YN
Aktivierungsstatus des Stempels.
Wenn deaktiviert, können Kunden den Stempel nicht verwenden.
memostring
Interne Notiz zu Referenzzwecken.
userIdstring
Benutzer-ID.
Wird verwendet, um den Empfänger der Stempelausgabe zu verwalten.
Normalerweise geben Sie die Login-ID eines Website-Mitglieds ein.
Wenn nicht angegeben, wird die Benutzer-ID automatisch vom System generiert.
userNmstring
Benutzername. Nur für interne Verwaltung.
userPhnnostring
Telefonnummer des Benutzers. Nur für interne Verwaltung.
userEmlstring
E-Mail-Adresse des Benutzers. Nur für interne Verwaltung.
userEtc1string
Zusätzliches Feld für die interne Verwaltung.
userEtc2string
Zusätzliches Feld für die interne Verwaltung. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

codeinteger
Antwortcode: 0 = Erfolg, andere Werte = Fehler
messagestring
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
resultinteger
Antwortwert. Der generierte Stempel-IDX wird zurückgegeben.
Beispiel: 1347