Autenticación y firma HMAC. Elige un SDK o integra con cURL; todos los ejemplos usan la misma autenticación HMAC.
Autenticación
El SDK genera las cabeceras en cada solicitud con la misma regla que Postman. La firma es HMAC-SHA256(apiKey, timestamp + rawBody) en hexadecimal. En solicitudes con cuerpo (POST, PUT, PATCH, DELETE), rawBody debe ser el JSON exacto enviado, con claves ordenadas alfabéticamente.
| Cabecera | Descripción |
|---|---|
| business-merchant-id | UUID del comercio |
| business-timestamp | Unix timestamp en segundos |
| business-signature | Firma HMAC hexadecimal del cuerpo |
Seguridad
Cada solicitud a /business/* lleva tres cabeceras firmadas. El payload firmado es timestamp + rawBody (sin separador). En Postman: CryptoJS.HmacSHA256(payload, apiKey).toString(CryptoJS.enc.Hex).
stableStringify).business-signature.import { createHmac } from 'node:crypto';
import {
stableStringify,
signBusinessPayload,
buildBusinessAuthHeaders,
} from '@hanix.io/business';
const merchantId = process.env.HANIX_MERCHANT_ID!;
const apiKey = process.env.HANIX_API_KEY!;
const body = {
merchant_reference: 'orden-124',
amount_in_cents: 50000,
currency_id: process.env.HANIX_CURRENCY_ID!,
country_id: process.env.HANIX_COUNTRY_ID!,
description: 'opcional',
customer_email: 'opcional@email.com',
success_url: 'https://tu-tienda.com/ok',
cancel_url: 'https://tu-tienda.com/cancel',
expires_at: '2026-05-16T12:00:00.000Z',
metadata: { sku: 'ABC' },
};
// 1) JSON estable (claves ordenadas) — mismo bytes que el cuerpo HTTP
const rawBody = stableStringify(body);
// 2) Timestamp Unix en segundos (string)
const timestamp = String(Math.floor(Date.now() / 1000));
// 3) payload = timestamp + rawBody → HMAC-SHA256(apiKey, payload) en hex
const signature = signBusinessPayload(apiKey, timestamp, rawBody);
// Cabeceras (igual que el pre-request de Postman)
const headers = {
'Content-Type': 'application/json',
...buildBusinessAuthHeaders({ merchantId, apiKey, rawBody }),
};
// Manual: createHmac('sha256', apiKey).update(timestamp + rawBody, 'utf8').digest('hex')
await fetch(`https://api.hanix.io/api/v1/business/payment-orders`, {
method: 'POST',
headers,
body: rawBody,
});