Skip to main content

Card Payments — Using the API (your own inputs)

If you collect card data with your own form inputs (instead of Ozura’s secure Elements or Checkout page), you need to understand the PCI/DSS scope implications for your application. Handling cardholder data on your systems increases your compliance scope and security responsibilities. If you want your own checkout UI but want card data to never touch your server, use Elements so tokenization happens in the browser.

Flow

  1. Tokenize — From your server, call POST /tokenize with card number, expiry, and optionally CVV. See API Reference → POST /tokenize for request/response.
  2. Store — Save the returned token and, if you sent CVV, cvc_session_id. Use the token in Proxy requests; CVC session is short-lived (90 seconds; use test tokens for long-lived test CVC).
  3. Charge — Send the token to your payment processor via the Proxy (see API Reference → POST /proxy/transaction) or use PayAPI (e.g. transactions).
Your server must never expose your Vault API key to the browser. Card data should only be sent to Vault from your backend.

Next steps