Autorisation

L'API x402 ne comporte ni compte, ni mot de passe, ni clé API. Elle utilise à la place trois types de justificatifs : la signature de paiement, le jeton d'accès de la commande et la signature du portefeuille.

Ne communiquez pas vos jetons d'accès à des tiers et n'envoyez jamais la clé privée de votre portefeuille à qui que ce soit, y compris à nous.

Caractéristiques principales

Signature de paiement

Le portefeuille qui valide le paiement est celui de l'acheteur. Le premier paiement effectué crée automatiquement un compte de portefeuille ; aucune inscription n'est nécessaire. Les renouvellements et le trafic résidentiel liés à une commande ne peuvent être réglés qu'à partir du portefeuille ayant payé la commande.

Jeton d'accès

Chaque commande payante donne lieu à un access_token une fois, dans le 202 Réponse. Envoyez-la dans le Authorization En-tête à joindre à chaque demande concernant cette commande : statut et identifiants, renouvellement, trafic, paramètres, remplacement d'adresse IP et événements.

Signature du portefeuille

Pour obtenir de nouveaux jetons pour vos commandes ou pour retirer votre solde, signez un SMS à usage unique (EIP-4361) avec le même portefeuille. La signature n'entraîne aucun transfert de fonds.

Jetons d'accès

Authorization: Bearer x402_q8Zt3Lw0mN6pR2vY9cK4hJ7sD1fG5bX8aE3uW0iO2nT

Propriété	Valeur
Mise en forme	`x402_` suivi de 43 caractères. Le mot `Bearer` n'est pas sensible à la casse
Où	Uniquement dans le `Authorization` en-tête. Les jetons dans la chaîne de requête ne sont pas acceptés
Périmètre	Une commande : `/orders/{id}` ainsi que ses sous-ressources, y compris le renouvellement et le trafic liés à cette commande. Un jeton de recharge ne s'ouvre que `GET /topup/{id}`
Publié	Une fois par opération, dans le `202` Réponse. La répétition de la même requête signée dans les 24 heures renvoie le même jeton. Passé ce délai, de nouveaux jetons ne sont émis que par Récupérer l'accès
Durée de vie	Jusqu’à la date d’expiration de la commande plus 90 jours ; les renouvellements prolongent ce délai. Pour une opération sans date d’expiration, 90 jours après son statut final.
Révocation	Blocage du portefeuille, `revoke_existing` dans Récupérer l'accès, ou assistance sur demande

Les nouveaux jetons n'annulent pas les anciens : chaque jeton valide d'une commande continue de fonctionner.

Erreurs

Réponse	Quand
`401 unauthorized`	Le `Authorization` L'en-tête est manquant ou n'est pas `Bearer x402_…`
`404 order_not_found`	Tout autre problème : l'ordre n'existe pas, le jeton appartient à un autre ordre, le jeton est révoqué ou a expiré. L'API ne fait pas la distinction entre ces cas.

Exemple

401 : Accès non autorisé

{
    "error": "unauthorized",
    "message": "Authorization is required",
    "retryable": false,
    "retry_action": "abandon",
    "detail": "Authorization: Bearer <access_token> from the order response is required"
}

Jeton perdu

Si vous perdez votre jeton, récupérez votre accès à l'aide de votre portefeuille : Récupérer l'accès. La réponse répertorie toutes les commandes du portefeuille contenant de nouveaux jetons.