Pour les développeurs

Checkout agentique, en quatre appels.

Alyte est la couche de confiance qu'un agent franchit avant de pouvoir acheter. Vous vous intégrez à une API hébergée, sans migration de PSP, sans que l'argent ne nous touche. Le même chemin de requête exécute chaque vérification côté serveur, si bien qu'un agent ne peut pas dépasser son mandat, quoi que dise son prompt.

L'intégration

Discover, quote, reserve, confirm.

Un seul chemin de requête. Chaque étape est un appel REST normal avec un token Bearer.

checkout.sh bac à sable · sans carte
# 1 · discover, inventaire pour l'événement d'un marchand
GET  /v1/merchants/mrc_42/events          Authorization: Bearer $TOKEN

# 2 · quote, verrouille le prix (renvoie un quote_id)
POST /v1/quotes          { "tier_id": "tier_ga", "qty": 2 }

# 3 · reserve, une réservation atomique, à l'épreuve de la survente
POST /v1/holds           { "quote_id": "qt_9f3" }   Idempotency-Key: 3b1c…

# 4 · confirm, le propre PSP du marchand règle la charge
POST /v1/holds/hd_7c/confirm   { "instrument": "inst_tok_…" }
discover quote reserve confirm L'argent est réglé du marchand vers le PSP du marchand. Alyte déplace uniquement des instructions, jamais des fonds.
Auth

Un token Bearer, avec scope et lié au tenant.

L'important : le plafond de dépense est résolu côté serveur à partir de la fiche de l'agent, jamais lu depuis le token.

Ce que vous envoyez

Un en-tête. Les scopes contrôlent chaque route.

Authorization: Bearer <jwt>
scope: catalog:read payments:write agent:run
Ce qu'Alyte fait respecter

Le plafond, le scope, la propriété et les vérifications de survente s'exécutent tous dans l'orchestrateur. Le modèle ne peut pas augmenter son propre plafond de dépense ; cette autorité est résolue côté serveur à partir de la fiche de l'agent.

cap → côté serveur, à partir de la fiche de l'agent
Surfaces

Trois portes d'entrée. Une seule enveloppe de politique.

REST, MCP et A2A passent tous par le même orchestrateur, la même auth, les mêmes scopes, tenant, idempotence et vérifications.

Honnêtes sur la maturité : Les surfaces et les contrôles de politique sont actifs et testés. Les adaptateurs d'attestation de schéma (TAP, Visa Intelligent Commerce) sont connectés et appliqués dans leur forme, mais la vérification de signature en direct et l'agent de production restent à venir. L'agent sandbox fonctionne comme un script déterministe. Nous indiquons honnêtement ce qui est réel, simulé ou provisoire.

Garanties de la trajectoire de l'argent

Idempotent par contrat. Typé en cas d'échec.

Idempotency-Key

Réclamé de façon atomique avant tout traitement de charge, par tenant. Deux requêtes concurrentes avec la même clé n'autorisent jamais toutes les deux. Réessayez librement.

Idempotency-Key: 3b1c-…-9f
Taxonomie d'erreurs stable

Codes typés, forme stable. Un résultat ambigu du PSP arrête le traitement pour réconciliation, jamais un refus silencieux que vous réessaieriez jusqu'à une double charge.

{ "error": { "code": "validation_error", "message": … } }
Côté approvisionnement

Apportez votre inventaire et votre PSP.

Les quatre appels ci-dessus sont le côté achat. Pour rendre les billets d'un marchand disponibles aux agents, deux éléments sont connectés, tous deux réels aujourd'hui, via la console marchand.

réel · console
Liaison du PSP

Enregistrez vos rails PSP et stockez les identifiants comme une référence opaque, jamais le secret, résolue au moment de la charge. Les charges se règlent sur votre propre compte PSP. Alyte n'est jamais bénéficiaire.

credential_ref → résolu à la charge
réel · console
Catalogue

Créez des événements et des paliers, fixez le prix et la disponibilité. L'inventaire modifiable contre lequel les devis verrouillent le prix et que les réservations décrémentent de façon atomique, la source de la garantie à l'épreuve de la survente.

events · tiers · availableCount

Honnête sur l'API d'approvisionnement : La liaison PSP et la gestion du catalogue sont en production aujourd'hui dans la console marchand, une surface d'administration que vous exploitez vous-même. Une API de synchronisation d'inventaire serveur à serveur, pour les marchands qui gèrent leur propre système de billetterie et veulent pousser l'inventaire par programmation, ainsi que des webhooks sortants (payment.succeeded, hold.expired), sont sur la roadmap, non livrés. Si vous avez votre propre source d'inventaire, cet adaptateur est ce que nous construisons ensuite avec des partenaires de conception.

Lire la documentation complète.

Le guide de démarrage rapide, la spécification OpenAPI lisible par machine, le SDK en préversion et la référence complète des points de terminaison et des erreurs arrivent sur un site de documentation hébergé. Parlez-nous en attendant, nous vous guiderons directement à travers l'API.

Parlez-nous Essayer le bac à sable