POST /test-tokens

{
  "type": "card",
  "data": {
    "cardNumber": "4111111111111111",
    "expirationMonth": "12",
    "expirationYear": "2025",
    "cvv": "123"
  }
}

{
  "success": true,
  "token": "tok_test_a1b2c3d4e5f6g7h8i9j0",
  "mask": {
    "card_number": "411111******1111"
  },
  "cvc_session_id": "550e8400-e29b-41d4-a716-446655440000",
  "bin": "411111",
  "is_test": true
}

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

// Create a test token once
const testToken = await ozuraVault.createTestToken({
  type: 'card',
  data: {
    cardNumber: '4111111111111111',
    expirationMonth: '12',
    expirationYear: '2025',
    cvv: '123'
  }
});

// Use in multiple tests
describe('Payment Tests', () => {
  it('should process payment', async () => {
    await ozuraVault.proxy({
      token: testToken.token,
      cvc_session_id: testToken.cvc_session_id,
      // ... proxy request
    });
  });

  it('should handle declined card', async () => {
    // Same token, same CVC session
    await ozuraVault.proxy({
      token: testToken.token,
      cvc_session_id: testToken.cvc_session_id,
      // ... different proxy request
    });
  });
});

// seeds/test-tokens.js
const testCards = [
  { number: '4111111111111111', type: 'visa' },
  { number: '5555555555554444', type: 'mastercard' },
  { number: '378282246310005', type: 'amex' }
];

for (const card of testCards) {
  const token = await ozuraVault.createTestToken({
    type: 'card',
    data: {
      cardNumber: card.number,
      expirationMonth: '12',
      expirationYear: '2030',
      cvv: card.type === 'amex' ? '1234' : '123'
    }
  });

  console.log(`${card.type}: ${token.token}`);
}

# .github/workflows/test.yml
jobs:
  test:
    steps:
      - name: Create test tokens
        run: |
          TOKEN=$(curl -X POST $VAULT_URL/test-tokens \
            -H "X-API-Key: $API_KEY" \
            -d '{"type":"card","data":{...}}')
          echo "TEST_TOKEN=$TOKEN" >> $GITHUB_ENV

      - name: Run integration tests
        env:
          TEST_TOKEN: ${{ env.TEST_TOKEN }}
        run: npm test

curl -X DELETE "$YOUR_VAULT_URL/tokens/tok_test_abc123" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "success": false,
  "message": "CVV is required for test tokens"
}

{
  "success": false,
  "message": "Invalid card number"
}