Server-Side Integration

🚀 Quick Start

1. Get credentials from Sovendus (Product ID + API Key)
2. Capture token on landing page
3. Send API call on order completion
4. Test the integration

⚙️ How It Works

🔑 Your Credentials

📝 Step 1: Capture Token

# Python/Django example
from django.core.cache import cache

def capture_token(request):
    token = request.GET.get('sovReqToken')
    if token:
        session_id = request.

// Node.js example
function captureToken(req, res, next) {
    const token = req.query.sovReqToken;
    if (token) {
        const key 

🎯 Step 2: Send API Call

# Python example
import requests

def send_conversion(token, product_id, api_key):
    url = f"https://press-order-api.sovendus.com/ext/{product_id}/{token}/api"

    response = requests

// Node.js example
async function sendConversion(token, productId, apiKey) {
    const url = `https://press-order-api.sovendus.com/ext/${productId}/${token}

📡 API Reference

Endpoint

POST https://press-order-api.sovendus.com/ext/{PRODUCT_ID}/{TOKEN}/api

Request Body

{
  "apiKey": "YOUR_API_KEY"
}

Response Codes

🧪 Test Your Integration

Quick Test

1. Add test token to your landing page URL:

   https://yoursite.com/landing?sovReqToken=12345-test-123-12345
   

   Note

   The API requires a certain format for test tokens. If this format is not met, you may receive a '422 - Unprocessable Content' - "Invalid API parameters" error message. Please test using the following tokens (or very similar):

   • 11111-test-111-11111
   • fffff-test-fff-fffff
   • 12345-test-123-12345
   • 1a2b3-test-1a2-1a2b3
2. Check token storage in your server logs or cache
3. Complete test order and verify API call in logs:

   POST https://press-order-api.sovendus.com/ext/YOUR_PRODUCT_ID/12345-test-123-12345/api
   

Debug Helper

def debug_sovendus(token, product_id, api_key):
    print(f"Token exists: {bool(token)}")
    print(f"Product ID: {product_id}

🔧 Troubleshooting

Common Issues

• 403 Forbidden: Check your API key
• 422 Invalid: Verify Product ID and token format
• No token found: Ensure token capture is working on landing page

📞 Need Help?

• Your Product ID
• Example token values
• Error messages
• Your tech stack (Python/Node.js/etc.)