cURL Examples

Command-line examples for all Ozura Vault endpoints.

Setup

Set your API key as an environment variable:

export OZURA_API_KEY="key_your_api_key_here"
export OZURA_PUB_KEY="pk_your_pub_key_here"
export VAULT_URL="$YOUR_VAULT_URL"

Tokenization

Tokenize a Card

curl -X POST "$VAULT_URL/tokenize" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $OZURA_API_KEY" \
  -H "X-Pub-Key: $OZURA_PUB_KEY" \
  -d '{
    "type": "card",
    "data": {
      "cardNumber": "4111111111111111",
      "expirationMonth": "12",
      "expirationYear": "2025",
      "cvv": "123"
    }
  }'

Tokenize a Bank Account

curl -X POST "$VAULT_URL/tokenize" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $OZURA_API_KEY" \
  -H "X-Pub-Key: $OZURA_PUB_KEY" \
  -d '{
    "type": "bank",
    "data": {
      "accountNumber": "1234567890",
      "routingNumber": "021000021",
      "accountType": "checking"
    }
  }'

Create Test Token

curl -X POST "$VAULT_URL/test-tokens" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $OZURA_API_KEY" \
  -H "X-Pub-Key: $OZURA_PUB_KEY" \
  -d '{
    "type": "card",
    "data": {
      "cardNumber": "4111111111111111",
      "expirationMonth": "12",
      "expirationYear": "2025",
      "cvv": "123"
    }
  }'

Detokenization

curl -X POST "$VAULT_URL/detokenize" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $OZURA_API_KEY" \
  -d '{
    "token": "tok_your_token_here"
  }'

Proxy

JSON Proxy (Stripe)

curl -X POST "$VAULT_URL/proxy/transaction" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $OZURA_API_KEY" \
  -d '{
    "token": "tok_your_token_here",
    "cvc_session_id": "your_cvc_session_id",
    "proxy_url": "https://api.stripe.com/v1/charges",
    "request_data": {
      "amount": 2000,
      "currency": "usd",
      "source": {
        "object": "card",
        "number": "${cardNumber}",
        "exp_month": "${expirationMonth}",
        "exp_year": "${expirationYear}",
        "cvc": "${cvv}"
      }
    },
    "http_headers": {
      "Authorization": "Bearer sk_test_your_stripe_key"
    }
  }'

XML Proxy

curl -X POST "$VAULT_URL/proxy/transaction" \
  -H "Content-Type: text/xml" \
  -H "X-API-Key: $OZURA_API_KEY" \
  -H "X-Token: tok_your_token_here" \
  -H "X-Proxy-URL: https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp" \
  -H "X-CVC-Session-ID: your_cvc_session_id" \
  -d '<?xml version="1.0" encoding="UTF-8"?>
<paymentService version="1.4" merchantCode="MERCHANT">
  <submit>
    <order orderCode="ORDER123">
      <amount value="1000" currencyCode="USD"/>
      <paymentDetails>
        <CARD-SSL>
          <cardNumber>${cardNumber}</cardNumber>
          <expiryDate>
            <date month="${expirationMonth}" year="${expirationYear}"/>
          </expiryDate>
          <cvc>${cvv}</cvc>
        </CARD-SSL>
      </paymentDetails>
    </order>
  </submit>
</paymentService>'

API Key Verification

curl -X GET "$VAULT_URL/api/applications/key" \
  -H "X-API-Key: $OZURA_API_KEY"

Authentication

curl -X POST "$VAULT_URL/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "yourPassword123!"
  }'

Verify MFA

curl -X POST "$VAULT_URL/auth/mfa/verify" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "code": "123456"
  }'

Verify Session

curl -X GET "$VAULT_URL/auth/verify" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Tokens Management

List Tokens

curl -X GET "$VAULT_URL/tokens" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

List Tokens with Filters

curl -X GET "$VAULT_URL/tokens?type=card&page=1&limit=20" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Delete Token

curl -X DELETE "$VAULT_URL/tokens/tok_your_token_here" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Applications

Create Application

curl -X POST "$VAULT_URL/api/applications" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "name": "My Application",
    "permissions": {
      "tokenization": { "allowed": true },
      "provisioning": { "allowed": false }
    }
  }'

List Applications

curl -X GET "$VAULT_URL/api/applications" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Delete Application

curl -X DELETE "$VAULT_URL/api/applications/app_id_here" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Projects

Create Project

curl -X POST "$VAULT_URL/projects/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "name": "My Project",
    "description": "Production environment"
  }'

List Projects

curl -X GET "$VAULT_URL/projects" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Invite Member

curl -X POST "$VAULT_URL/projects/proj_id_here/invite" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "email": "newmember@example.com",
    "role": "member"
  }'

Provisioning

curl -X POST "$VAULT_URL/internal/provision" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $OZURA_API_KEY" \
  -d '{
    "project_name": "Customer Acme Corp",
    "user_email": "admin@acme.com"
  }'

Settings

Get Settings

curl -X GET "$VAULT_URL/user/settings" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Update Settings

curl -X PUT "$VAULT_URL/user/settings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "deduplication_enabled": true
  }'

MFA

Enable MFA

curl -X POST "$VAULT_URL/user/settings/mfa" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Verify MFA Setup

curl -X POST "$VAULT_URL/user/settings/mfa/verify" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "code": "123456"
  }'

Disable MFA

curl -X DELETE "$VAULT_URL/user/settings/mfa" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "code": "123456"
  }'

Audit Logs

Get Audit Logs

curl -X GET "$VAULT_URL/audit-logs" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Filter Audit Logs

curl -X GET "$VAULT_URL/audit-logs?event_type=TOKEN_CREATION&start_date=2024-01-01&limit=100" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Tips

Pretty Print JSON

curl ... | jq .

Save Response to File

curl ... -o response.json

Verbose Output

curl -v ...

Time the Request

time curl ...

Next Steps

JavaScript Examples - Node.js client
Python Examples - Python client

​cURL Examples

​Setup

​Tokenization

​Tokenize a Card

​Tokenize a Bank Account

​Create Test Token

​Detokenization

​Proxy

​JSON Proxy (Stripe)

​XML Proxy

​API Key Verification

​Authentication

​Login

​Verify MFA

​Verify Session

​Tokens Management

​List Tokens

​List Tokens with Filters

​Delete Token

​Applications

​Create Application

​List Applications

​Delete Application

​Projects

​Create Project

​List Projects

​Invite Member

​Provisioning

​Settings

​Get Settings

​Update Settings

​MFA

​Enable MFA

​Verify MFA Setup

​Disable MFA

​Audit Logs

​Get Audit Logs

​Filter Audit Logs

​Tips

​Pretty Print JSON

​Save Response to File

​Verbose Output

​Time the Request

​Next Steps

cURL Examples

Setup

Tokenization

Tokenize a Card

Tokenize a Bank Account

Create Test Token

Detokenization

Proxy

JSON Proxy (Stripe)

XML Proxy

API Key Verification

Authentication

Login

Verify MFA

Verify Session

Tokens Management

List Tokens

List Tokens with Filters

Delete Token

Applications

Create Application

List Applications

Delete Application

Projects

Create Project

List Projects

Invite Member

Provisioning

Settings

Get Settings

Update Settings

MFA

Enable MFA

Verify MFA Setup

Disable MFA

Audit Logs

Get Audit Logs

Filter Audit Logs

Tips

Pretty Print JSON

Save Response to File

Verbose Output

Time the Request

Next Steps