Autenticación

Cada solicitud identifica su cuenta con una clave pública:

X-Public-Key: pk_your_public_key
Content-Type: application/json

La clave se puede incluir sin riesgo en un bundle del navegador. Puede crear pagos y leer un pago por su ID, pero no puede mover dinero, cambiar sus wallets de liquidación ni acceder a los datos de otro comerciante. Las lecturas de toda la cuenta usan en su lugar su clave de API y secreto.

curl https://hub.stablezact.com/api/v1/networks \
  -H "X-Public-Key: pk_your_public_key"

Clave de API y secreto

Las lecturas de toda la cuenta, la lista de pagos (/payments/merchant/list) y las estadísticas de pagos (/payments/merchant/stats), se autentican con su clave de API y su secreto, que encontrará en Dashboard, Settings, API:

X-API-Key: your_api_key
X-API-Secret: your_api_secret
Content-Type: application/json

• Envíelos solo desde su servidor. El secreto nunca debe llegar a un navegador.
• Envíe estas dos cabeceras sin X-Public-Key. Si hay una clave pública presente, la solicitud se autentica con la clave pública.
• La clave y el secreto siempre leen datos del modo live.

curl https://hub.stablezact.com/api/v1/payments/merchant/stats \
  -H "X-API-Key: $STABLEZACT_API_KEY" \
  -H "X-API-Secret: $STABLEZACT_API_SECRET"

Las llamadas a estas dos rutas solo con una clave pública siguen funcionando por ahora, y la respuesta incluye una cabecera Deprecation: true. Páselas a la clave de API y el secreto. Las integraciones que ya envían la clave y el secreto en cada solicitud siguen funcionando.

Credenciales ausentes o no válidas

{
  "error": "API credentials required. Use x-public-key header or x-api-key and x-api-secret headers."
}

Se devuelve con 401.