PCI DSS
Card details are entered in secure fields that Kalixo.js loads from the payment provider. Card data never touches your page or Kalixo’s servers. This keeps your PCI scope at SAQ A, provided you load Kalixo.js fromhttps://js.kalixo.io. The hosted checkout keeps you at
SAQ A too.
Keys and secrets
Kalixo stores only a hash of your API keys and shows each key once. To rotate a secret key,
deploy a new one, then ask Kalixo to revoke the old one. Revocation takes effect within 30
seconds.
What Kalixo enforces
- Amounts. Kalixo charges only the amount of the checkout session and checks every amount the provider reports. See Amount integrity.
- Return domains. A
return_urlmust be on a domain registered for your account (return_url_not_allowedotherwise), so a leaked secret key cannot send shoppers to a look-alike site. - Webhook targets. Webhook endpoints must be public HTTPS URLs. Private and internal
addresses are refused (
url_not_public). - Card testing. Payment attempts are limited per session, per shopper IP address and per account. See Rate limits.
- Hosted checkout. The page shows order details only with the client secret.
What you must do
- Verify webhooks against the raw body, and reject a timestamp older than 5 minutes. See Webhooks.
- Confirm on your server before you fulfil. Read the payment with
GET /v1/payments/{id}. See Fulfilment. - Protect your pages. Serve your checkout and return pages over HTTPS with
Strict-Transport-Securityand a Content Security Policy that allows Kalixo.js. See Kalixo.js. - Show shoppers only the decline
message. It is written to be safe to display.
Data handling
- Kalixo encrypts shopper email addresses and names at rest. You never receive card numbers, so never store them.
- Never upload card numbers or identity documents as dispute evidence.
- Payments and events return your
referenceandmetadataunchanged. Do not put secrets or personal data in them. - Events are kept for 30 days (
GET /v1/events). Report files are kept for 30 days.
Report a vulnerability
Email [email protected] with the details and, where relevant, arequest_id. Do not include real card numbers or personal data.