Troubleshooting

Common issues and solutions for AuxVault API integration.

🔐 Authentication Issues

"Invalid or expired token"

Cause: Token expired or incorrect
Solution:

# Get new token
curl -X POST https://dev.auxcore.net/api/v1/auth/login \
  -d '{"email": "...", "password": "..."}'

"X-Tenant-ID header required"

Cause: Missing tenant ID header
Solution:

# Always include tenant ID
curl -H "X-Tenant-ID: your-tenant-id" ...

💳 Transaction Issues

"Transaction declined"

Causes:

• Insufficient funds
• Card expired
• Invalid card details
• AVS/CVV mismatch

Solutions:

• Ask customer for different card
• Verify card details
• Check AVS/CVV responses

"Cannot void settled transaction"

Cause: Transaction already settled
Solution: Use refund instead of void

🔄 Subscription Issues

"Subscription payment failed"

Cause: Card declined, expired, or insufficient funds
Solution:

• Enable dunning management
• Send payment failure notifications
• Allow customers to update payment method

📧 Webhook Issues

Webhooks not received

Checks:

1. URL publicly accessible?
2. HTTPS enabled?
3. Returns 200 status?
4. Not timing out?

Solution:

# Test webhook
curl -X POST https://dev.auxcore.net/api/v1/webhooks/webhook_123/test

"Invalid signature"

Cause: Signature verification failing
Solution:

const isValid = client.webhooks.verify(payload, signature);

🐛 Common Errors

Rate limit exceeded

Solution: Implement exponential backoff

Gateway timeout

Solution: Retry request

Invalid JSON

Solution: Verify JSON syntax

Need help? Contact support@auxvault.com