Buvei

Authentication

Required headers, timestamp window, and IP allow-listing.

Every API call carries four headers. Missing or malformed headers fail with 401 or 403 before reaching the handler.

HeaderDescriptionExample
X-API-KeyYour API keykey_abc123def456
X-TimestampRequest timestamp in milliseconds since epoch1640995200000
X-NonceUnique request identifier, minimum 8 charactersa1b2c3d4e5f6g7h8
X-SignatureHMAC-SHA256 signature, base64-encodeddGVzdC1zaWduYXR1cmU=

Security requirements

You authenticate the server, not a user. There is no per-user OAuth. Card-holder identity is captured separately through KYC.

See Request Signing for how X-Signature is computed.