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

cardIdxintegerrequired
Card IDX.
El Card IDX puede consultarse en la página “Tarjeta de Sellos” del panel de control.
domainstring
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.
strtYmddaterequired
Fecha de inicio de validez del sello. Ejemplo: 2025-01-01
endYmddaterequired
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.
activeYnstring
Default:Y
Enum:
YN
Estado de activación del sello.
Si está desactivado, los clientes no podrán usar el sello.
memostring
Nota interna de referencia.
userIdstring
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.
userNmstring
Nombre del usuario. Solo para uso interno.
userPhnnostring
Número de contacto del usuario. Solo para uso interno.
userEmlstring
Correo electrónico del usuario. Solo para uso interno.
userEtc1string
Campo adicional para gestión interna.
userEtc2string
Campo adicional para gestión interna. 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

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