Altruon SKILL.md

This page mirrors Altruon's public AI integration guide:

• https://docs.altruon.io/SKILL.md

Use this guide when building or troubleshooting Altruon integrations with AI assistants.

What It Covers

• Product mental model (tenant, session, routing, gateway vs billing, trials)
• Canonical integration setup order
• Supported integration paths:
  • Static Hosted Pages (/checkout/p/{id})
  • Dynamic Hosted Checkout (/checkout/s/{sessionId})
  • Altruon JS embedded checkout
• Subscription trials (catalog trials and forceTrialPeriodDays, supported gateway × method matrix)
• Session API essentials (discovery vs pinned payment method, customer pre-fill, locale, metadata)
• Environment and authentication guardrails
• API surface overview
• Webhook model:
  • Altruon Webhooks sent to merchant endpoints (backoffice setup, event types, Altruon-Signature verification, retries)
  • Inbound provider webhooks and provider-specific caveats
• Troubleshooting workflow and AI operating instructions

Recommended Usage

1. Start from SKILL.md to understand constraints and sequence.
2. Follow the provider docs under Integrations and billing provider pages.
3. Use the getting-started guides for hosted flows:
   • Hosted Pages
   • Dynamic Hosted Checkout
   • Trials
4. Use the Altruon JS developer docs for implementation details:
   • Quick Start
   • Session API
   • Callbacks
5. To receive event notifications on your own server, set up Altruon Webhooks.