Liens de paiement

Ce que comprend une facture#

Les factures du nouvel espace de travail utilisent un prix de base en USD et Any propose les quatre méthodes. SBP convertit en RUB au taux de référence gelé de la Banque de Russie ; la crypto utilise la règle de facturation explicite 1:1 USD/USDT. La tarification native héritée reste disponible pour les anciennes factures et les demandes API sans pricingMode=universal. Voir la section multi-boutiques et tarification USD ci-dessous.

N'incluez jamais de mots de passe, de clés API, de données de carte ou de codes bancaires dans les descriptions publiques. Utilisez un titre de commande et une référence que le client reconnaît.

• Nom du magasin, titre de commande jusqu'à 120 caractères et description jusqu'à 500 caractères.
• Montant de base et devise explicite USD, RUB ou USDT.
• Méthodes compatibles, frais séparés et parts de TVA, référence de commande et expiration du lien.
• Les réponses du propriétaire incluent link.payment avec l'état enregistré d'une opération existante ; cela est distinct de l'état de disponibilité du lien.

N’importe lequel — le client choisit#

N’importe lequel sélectionne toutes les méthodes compatibles avec la devise de la facture : cartes et Alipay pour USD, SBP pour RUB, et crypto pour USDT. L’API prend un tableau de méthodes concret plutôt que la chaîne any. Chaque méthode a sa propre citation.

Les factures du nouvel espace de travail utilisent un prix de base en USD et Any propose les quatre méthodes. SBP convertit en RUB au taux de référence gelé de la Banque de Russie ; la crypto utilise la règle de facturation explicite 1:1 USD/USDT. La tarification native héritée reste disponible pour les anciennes factures et les demandes API sans pricingMode=universal. Voir la section multi-boutiques et tarification USD ci-dessous.

Pour un nouveau paiement en direct par carte ou Alipay, la passerelle actuelle ne prend en charge que feeCustomerPercent=0 et vatCustomerPercent=100 : le marchand couvre la totalité des frais de traitement et la TVA est ajoutée intégralement pour le client. D'autres parts peuvent être enregistrées et calculées sur une facture, mais l'exécution est bloquée avec unsupported_allocation. Le serveur ne modifie jamais silencieusement les conditions enregistrées. Les paiements crypto SBP et USDT prennent en charge toutes les parts de frais de traitement et n'ont pas de TVA.

Créer un lien#

1. 1

   Ouvrez les liens de paiement dans votre compte.

2. 2

   Saisissez un titre, un montant, une devise et une description. Définissez les parts de frais et de TVA avec les deux commandes.

3. 3

   Gardez N’importe lequel pour laisser le client choisir, ou sélectionnez des méthodes spécifiques. Définissez l’expiration.

4. 4

   Comparez le total pour chaque méthode et visualisez le paiement.

5. 5

   Recevez le lien de paiement prêt immédiatement après la création, puis copiez-le pour votre client ou widget.

Les conditions restent avec la facture#

Une facture enregistrée ne change pas lorsque les paramètres de la boutique changent. Son prix, sa devise, ses parts de frais et de TVA, sa référence de commande et ses métadonnées appartiennent à cette commande. Cela maintient le total cohérent pour un client qui a déjà ouvert le lien.

Créez un nouveau lien et mettez l’ancien en pause lorsque le prix, la description ou la répartition des coûts change. Modifier un montant d’URL ne peut pas changer le calcul serveur.

Une page de paiement dédiée#

Les liens serveur sont enregistrés dans la base de données et s’ouvrent sur tous les appareils à /pay/… sans accès au compte marchand. Un client n’a pas besoin de s’inscrire pour voir une facture. Les soldes de boutique, paramètres et autres dossiers clients restent privés.

L’exemple /pay/demo montre l’expérience sans débiter d’argent. Les liens de démo navigateur sont des données de test et ne doivent pas être présentés comme de vraies factures.

Gestion de la disponibilité#

Mettre en pause, annuler ou faire expirer un lien bloque une nouvelle opération. Cela ne masque pas un paiement envoyé : le statut, le rapprochement et un code bancaire demandé restent disponibles. La disponibilité du lien et l’état financier sont vérifiés séparément.

La reprise lève une pause sans modifier les conditions. L’annulation est définitive, et un lien expiré ne peut pas être prolongé. Créez une nouvelle facture pour une nouvelle commande ou des conditions modifiées, pas pour réessayer un débit dont le résultat est inconnu.

Plusieurs boutiques et un prix de base USD unique#

Choisissez Toutes les boutiques pour les analyses et opérations agrégées, ou sélectionnez une boutique pour ses propres enregistrements. Chaque boutique possède un storeId, un nom, une TVA par défaut, des factures, des clés API, des points de terminaison webhook, un historique d'événements et une application de site Web distincts. Les notifications et les tickets de support appartiennent au compte. Un compte peut créer jusqu'à 100 boutiques. Les enregistrements existants restent dans sa première boutique.

Les factures du nouvel espace de travail utilisent pricingMode="universal" et un prix de base en USD. Any inclut carte, alipay, sbp et crypto ; un commerçant peut sélectionner un sous-ensemble. Les cartes et Alipay facturent en USD. SBP facture en RUB en utilisant le taux de référence USD/RUB de la Banque de Russie. La crypto facture en USDT selon la règle de facturation explicite 1 USD = 1 USDT. Il s'agit d'une règle de conversion de facturation, pas d'une cotation USDT de marché. La passerelle fournit le taux de la pièce sélectionnée, le montant exact du transfert et les instructions avant le transfert.

Le taux de référence et les deux montants sont gelés à la création. Les factures impliquant une conversion RUB expirent dans les 24 heures. Si le taux de référence ne peut pas être obtenu, la création échoue avec FX_UNAVAILABLE ; aucun taux de secours inventé ou obsolète n'est utilisé. Le montant en monnaie mineure du propriétaire et les cotations utilisent la monnaie comptable USD. quotes[method].settlement contient la cotation de frais native. Le paiement public expose la monnaie de frais sélectionnée dans currency, le prix d'origine dans baseAmountMinor/baseCurrency, et le taux de référence dans fx. Une fois qu'un paiement a été envoyé, sa méthode ne peut pas être modifiée ; une facture a une seule opération de passerelle.

Créez une clé API dans la boutique prévue et envoyez Authorization: Bearer <key> depuis votre serveur. Sa liaison de boutique est immuable ; X-Kevmi-Store ne peut pas lui accorder l'accès à une autre boutique. Les sessions de navigateur sélectionnent X-Kevmi-Store: <storeId> ; si omis, la première boutique est sélectionnée. La valeur all n'est acceptée que par GET /api/account/dashboard et GET /api/payment-links. Les mutations nécessitent une boutique sélectionnée, Origin et X-CSRF-Token. Les identifiants de compte et les identifiants de boutique sont des identifiants différents.

Pour la compatibilité, les demandes API sans pricingMode="universal" conservent la tarification native et les restrictions de monnaie d'origine. Les factures existantes ne sont jamais recalculées. Les reçus confirmés dans les analyses reflètent les paiements vérifiés moins les dépenses de facture enregistrées ; ils ne constituent pas un solde retirable. Les monnaies de facture héritées restent séparées et les paiements sont organisés avec le support. Exécutez une commande uniquement après avoir vérifié payment.fulfillmentReady=true et payment.status="succeeded" via l'API serveur, l'historique d'événements ou un webhook signé.