PYLON SDKs

Official SDKs for PYLON. Development in progress.

SDK Status

All SDKs are under development. Direct API integration is currently recommended.

Current Integration Method

Use direct HTTP requests to the PYLON API until SDKs are released.

API Endpoint

{BASE_URL}

Local Testing

http://localhost:7777

Use the local emulator (pylon-cli) for development.

Common Integration Pattern

1. Initialize HTTP client with API key
2. Call POST /v1/verify/age with policy and callback URL
3. Get walletUrl from response
4. Redirect user to walletUrl
5. Receive webhook when verification completes
6. Validate webhook signature (HMAC-SHA256)
7. Process verification result

Environment Variables

export PYLON_API_KEY=<your-api-key>
export PYLON_WEBHOOK_SECRET=<your-webhook-secret>

Webhook Signature Validation

Critical: Always validate webhook signatures to prevent spoofed requests.

Validation Steps

1. Extract X-Pylon-Signature header
2. Get raw request body (bytes, before JSON parsing)
3. Retrieve webhook secret from environment
4. Compute HMAC-SHA256 signature
5. Compare using timing-safe comparison

See Webhooks Guide for implementation examples in multiple languages.

Error Handling

Common error codes:

Webhook Reliability

PYLON provides at-least-once delivery with:

• Exponential backoff retries (1s → 2s → 4s → 8s → 16s → 32s)
• Timeout: 10 seconds per attempt
• Max retries: 5 attempts
• Idempotency via X-Pylon-Idempotency-Key header

Return HTTP 200 to acknowledge receipt.

Support

• Questions: See Troubleshooting
• Issues: GitHub
• Email: support@pylonid.eu

Next Steps

• See API Reference for endpoint documentation
• Try Local Testing with the emulator
• Review Webhooks Guide for integration examples

Roadmap

• Q1 2026: Official SDK releases for all listed languages
• Q2 2026: Additional language support on request

See Changelog for updates.