Python Examples

Complete Python integration examples for AuxVault API.

Installation

pip install auxvault

Setup

from auxvault import Client
import os

client = Client(
    api_key=os.getenv('LUQRA_API_KEY'),
    tenant_id=os.getenv('LUQRA_TENANT_ID'),
    environment='production' if os.getenv('ENV') == 'production' else 'sandbox'
)

Process Payment

try:
    transaction = client.transactions.create(
        type='sale',
        amount=100.00,
        currency='USD',
        card={
            'number': '4111111111111111',
            'expiry_month': '12',
            'expiry_year': '2027',
            'cvv': '123'
        },
        billing={
            'first_name': 'John',
            'last_name': 'Doe',
            'address': '123 Main St',
            'city': 'New York',
            'state': 'NY',
            'zip': '10001',
            'country': 'US'
        },
        customer={'email': 'john@example.com'}
    )
    
    print(f"Transaction approved: {transaction.id}")
    
except auxvault.exceptions.TransactionDeclinedError as e:
    print(f"Payment declined: {e}")
except Exception as e:
    print(f"Error: {e}")

Webhook Handler (Flask)

from flask import Flask, request
import json

app = Flask(__name__)

@app.route('/webhooks/auxvault', methods=['POST'])
def handle_webhook():
    payload = request.get_data()
    signature = request.headers.get('X-Luqra-Signature')
    
    if not client.webhooks.verify(payload, signature):
        return 'Invalid signature', 401
    
    event = request.get_json()
    
    if event['type'] == 'transaction.approved':
        handle_transaction_approved(event['data'])
    elif event['type'] == 'transaction.declined':
        handle_transaction_declined(event['data'])
    
    return '', 200

def handle_transaction_approved(data):
    print(f"Transaction approved: {data['transactionId']}")

if __name__ == '__main__':
    app.run(port=3000)

Next: Postman collection →