Aller au contenu principal

Produits, liens gérés et abonnements

Ces ressources commerciales appartiennent au compte. Clé API ou Bearer partenaire et fonctions activées sont requis. Une clé n’active pas de route. Voir authentification.

Pour lecture et suppression, env est un filtre query. Pour création et modification de produits/liens, placez env dans le corps JSON. Le propriétaire est déterminé par l’accès ; ne fournissez pas une autre partner_id. Les prix des ressources peuvent être des entiers propres à l’endpoint ; amount des transactions reste une chaîne d’entier exacte.

Produits​

GET /api/v1/products?env=prod&limit=10
GET /api/v1/products/{id}?env=prod
POST /api/v1/products
PUT /api/v1/products/{id}
DELETE /api/v1/products/{id}?env=prod

Un produit définit header, text, price, qty et currency ; ce n’est pas un paiement. Les listes renvoient data/total, les détails et la création du produit data. Le prix d’exemple est 1 USDT avec decimals=6.

{
  "env": "prod",
  "header": "Example item",
  "text": "Example item",
  "price": 1000000,
  "qty": "1",
  "currency": "USDT"
}

Liens de paiement gérés​

GET /api/v1/links?env=prod&limit=10
POST /api/v1/links
PUT /api/v1/links/{id}
DELETE /api/v1/links/{id}?env=prod

Les liens sont des ressources serveur avec montant, configuration de paiement et produits facultatifs. Utilisez URL/paramètres de formulaire retournés, sans inventer d’adresse. Le lien de réception Heth créé localement est distinct. Supprimer un lien ne rembourse pas une opération déjà réglée.

Abonnements du commerçant​

GET /api/v1/recurrents?env=prod&limit=10
GET /api/v1/recurrents/{id}?env=prod
POST /api/v1/recurrents
PUT /api/v1/recurrents/{id}
POST /api/v1/recurrents/{id}/pause
POST /api/v1/recurrents/{id}/resume
POST /api/v1/recurrents/{id}/cancel

Un abonnement repose sur un paiement initial réussi du compte. POST /recurrents accepte payment_id et recurrent ; interval vaut daily, weekly, monthly ou yearly, period compte les intervalles. L’environnement est hérité du paiement initial. Le payeur doit autoriser le moyen et les débits récurrents. Créer un abonnement ne prouve pas un mandat utilisable.

Actions : POST /recurrents/{id}/pause, /resume et /cancel. Vérifiez le statut ; annuler les prochains débits ne rembourse pas les précédents. Le payeur Heth gère ses propres mandats crypto avec sa session de portefeuille dans Paramètres → Subscription mandates, si cette fonction est activée. Ils sont distincts des abonnements commerçants.

Dernière mise à jour le