VALIDATA Developers

API

Autenticación

Cada integración (un comercio conectando un canal) tiene su propia credencial. No existe una clave global de cuenta. Hay dos perfiles; el de tu credencial lo fija VALIDATA al crearla.

Perfil signed (recomendado)#

Obligatorio para WooCommerce. Tres cabeceras:

CabeceraValor
X-Validata-Key-Id16 caracteres [a-z0-9]
X-Validata-TimestampSegundos Unix, exactamente 10 dígitos
X-Validata-Signaturev1= + HMAC-SHA256 en hexadecimal minúscula

La firma es:

HMAC-SHA256(secreto, "<timestamp>." + <cuerpo crudo>)
  • Se firman los bytes exactos que envías, incluidos espacios y saltos de línea. Si tu cliente re-serializa el JSON, la firma falla.
  • En el GET de readback el cuerpo está vacío: se firma "<timestamp>.".
  • El secreto tiene 43 caracteres base64url. La ventana de tiempo es de ±300 segundos (TIMESTAMP_OUT_OF_WINDOW).
  • Los vectores oficiales incluyen casos con UTF-8, barras escapadas y cuerpo vacío para probar tu implementación.

Perfil static#

Para bots sin código que solo permiten cabeceras fijas:

Authorization: Bearer vdk_<key_id>.<secreto>

Es menos seguro (el secreto viaja en cada llamada y no protege contra repetición). Úsalo solo si tu plataforma no puede firmar, y no lo uses con WooCommerce.

Scopes#

ScopePermite
validations:writePOST /v1/channel/validations
validations:readGET /v1/channel/validations/readback

Sin el scope necesario: 403 INSUFFICIENT_SCOPE.

Errores de autenticación#

CódigoHTTPCuándo
INVALID_CREDENTIALS401Falta la credencial, o es desconocida. No revela si el key_id existe.
SIGNATURE_INVALID401La firma no coincide.
TIMESTAMP_OUT_OF_WINDOW401Reloj desfasado más de 300 s.
MALFORMED_HEADER400Formato de cabecera inválido.
INTEGRATION_REVOKED403La integración fue revocada.

Cómo obtener credenciales: Futuro — hoy no se autoemiten; ver Inicio rápido.