Crear Sello

Esta API permite emitir un nuevo sello a un cliente.

El Card IDX es obligatorio y puede consultarse en la página «Tarjeta de Sellos» del panel de control.

Esta API está disponible solo en los planes Personal o superiores.

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.
El Card IDX puede consultarse en la página “Tarjeta de Sellos” del panel de control.
domain string
Default:https://vvd.bz
Dominio de sellos.
Si se deja vacío, se guardará con el dominio predeterminado.
Disponible en planes Premium o superiores: puedes especificar un dominio personalizado registrado en la sección de Gestión de Dominios de Enlaces.
strtYmd date required
Fecha de inicio de validez del sello. Ejemplo: 2025-01-01
endYmd date required
Fecha de expiración del sello. Ejemplo: 2025-12-31
La fecha de expiración puede configurarse hasta 5 años a partir de hoy.
activeYn string
Default:Y
Enum:
YN
Estado de activación del sello.
Si está desactivado, los clientes no podrán usar el sello.
memo string
Nota interna de referencia.
userId string
ID de usuario.
Se utiliza para gestionar el destinatario de la emisión del sello.
Normalmente, introduce el ID de inicio de sesión de un miembro del sitio web.
Si no se especifica, el sistema generará automáticamente un ID de usuario.
userNm string
Nombre del usuario. Solo para uso interno.
userPhnno string
Número de contacto del usuario. Solo para uso interno.
userEml string
Correo electrónico del usuario. Solo para uso interno.
userEtc1 string
Campo adicional para gestión interna.
userEtc2 string
Campo adicional para gestión interna. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

code integer
Código de respuesta: 0 = Éxito, otros valores = Error
message string
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
result integer
Valor de respuesta. Se devolverá el Stamp IDX generado.
Ejemplo: 1347