Aide
Gate Pay
Guide d_intégration des marchands

FAQ Gate Pay | Gate

28/05/2026 (UTC)
36 955 Lire
3

Foire Aux Questions

Limites de montant de commande

1. Limite de montant minimum :
Gate Payment : 0,0001 (toutes unités monétaires)
Paiement Web3 On-Chain : 0,01 USDT (ou équivalent dans d’autres devises)
Montant minimum d’échange Flash : L’API de requête de paire de devises retournera les valeurs maximales et minimales.

Le montant de la commande ne doit pas être inférieur au montant minimum défini. Par exemple, si la limite minimale est de 0,0001, le montant de la commande doit être ≥ 0,0001, comme 0,0001, 0,00011, etc.

2. Limite de précision :
Le nombre de décimales du montant de la commande ne doit pas dépasser la précision définie. Par exemple, si la précision est définie à 0,0001 (c’est-à-dire jusqu’à 4 décimales), 0,001 est valide, mais 0,00011 générera une erreur et ne sera pas arrondi.

Le montant de la commande doit respecter à la fois les exigences de montant minimum et de précision, sinon il ne pourra pas être soumis. Par exemple, si le montant minimum est de 0,0001 et la limite de précision est de 0,1, 0,01 ne répondra pas à la condition de précision et générera une erreur.


Description des frais de retrait

API des frais de retrait

https://docs.gate.com/api-reference/version/100/en/endpoint/withdraw/withdrawStatus

Description

L’appel de l’API “Withdrawal Fee Query” retournera les frais requis pour chaque réseau blockchain pris en charge par la devise. Les utilisateurs peuvent choisir la chaîne appropriée selon leurs besoins.

Veuillez vous référer aux deux paramètres suivants :

Paramètres de frais

  • withdraw_fix_on_chains : Frais de retrait fixes
  • withdraw_percent_on_chains : Frais de retrait basés sur un pourcentage
    (Pour certaines devises spécifiques, les frais de retrait sont calculés comme montant du retrait × ce pourcentage)

Méthode de calcul

Les frais de retrait correspondent à la somme des deux parties suivantes :
Frais fixes + (taux en pourcentage × montant du retrait)

Autres remarques

Actuellement, la plupart des chaînes courantes ne facturent qu’un frais fixe
(ce frais fixe est mis à jour toutes les heures).

Il est recommandé d’appeler cette API à chaque retrait pour confirmer le dernier montant des frais, car ceux-ci sont mis à jour chaque heure.


Pourquoi un paiement effectué pendant la période de validité est-il marqué comme une commande expirée ?

L’heure du paiement est déterminée en fonction du moment où la transaction est détectée sur la blockchain, et non lorsque l’utilisateur a initié le paiement. Un délai peut exister entre ces deux moments.


Pourquoi les enregistrements des revenus et dépenses diffèrent-ils entre l’application Gate et le tableau de bord marchand ?

Les informations de facturation affichées dans le tableau de bord marchand Gate Pay correspondent au compte de solde marchand
(ce compte n’est disponible que pour les marchands inscrits sur Gate Pay). Il est principalement utilisé pour la collecte et la distribution de fonds des marchands.

L’application Gate, quant à elle, correspond à un compte personnel sur la plateforme d’échange Gate.

Puisque le compte de solde marchand et le compte personnel sont indépendants, les fonds et les enregistrements de facturation ne sont pas partagés entre eux. Par conséquent, les informations de facturation affichées dans l’application Gate ou sur la plateforme Web peuvent différer des véritables enregistrements d’encaissement.


Signification de merchantTradeNo et merchantUserId dans l’API Create Order

  1. merchantTradeNo : Numéro de commande dans le système du marchand, longueur maximale de 32 caractères.
  2. merchantUserId : Identifiant du compte utilisateur dans le système du marchand. Il doit s’agir d’un identifiant utilisateur valide ; sinon, les remboursements liés au paiement vers cette adresse échoueront car le système ne pourra pas identifier l’utilisateur.

Informations de callback pour les paiements à une adresse on-chain

Pourquoi y a-t-il deux notifications de callback pour les paiements ?

  1. Notification d’arrivée de fonds (TRANSFER_ADDRESS) : Notification de la réception des fonds.
  2. Notification de changement de statut de commande (PAY_ADDRESS) : Notification des changements de statut de la commande.

Les marchands doivent s’appuyer sur ces deux types d’informations pour déterminer si la commande est réussie afin de procéder à l’expédition ou de gérer les commandes échouées.

Quand les notifications de callback sont-elles envoyées ?

  1. Notification d’arrivée de fonds
    Envoyée après la confirmation du paiement sur la blockchain, permettant le crédit des fonds sur le compte du marchand en temps réel tout en notifiant ce dernier.
  2. Notification de changement de statut de commande
    Déclenchée lors d’un changement de statut de la commande.

Comprendre le statut des callbacks

1. Notification d’arrivée de fonds (biztype = TRANSFER_ADDRESS)

  • TRANSFERRED_ADDRESS_IN_TERM : Les fonds sont crédités en temps réel pendant la période de validité de la commande.
  • TRANSFERRED_ADDRESS_DELAY : Les fonds reçus après la période de validité sont crédités sur le compte de paiement du marchand (crédit en temps réel après la période de validité).
  • TRANSFERRED_ADDRESS_BLOCK : La transaction présente un risque de sécurité potentiel et est rejetée. Veuillez contacter Gate Pay pour obtenir de l’aide concernant le remboursement du paiement.

2. Notification de changement de statut de commande (biztype = PAY_ADDRESS)

  • PAY_SUCCESS : Le paiement a réussi.
  • PAY_CLOSE : La commande a expiré.
  • PAY_EXPIRED_IN_PROCESS : En attente de confirmation on-chain des fonds.

Scénarios de paiement et détermination du statut de commande pour les paiements à une adresse on-chain

1. Paiement complet ou excédentaire pendant la période de validité

Description : Si un utilisateur paie la totalité ou plus que le montant requis pendant la période de validité, une fois confirmé on-chain, les deux callbacks sont déclenchés.
Notification de statut de commande :

  • Initialement : bizStatus = PAY_EXPIRED_IN_PROCESS
  • Après confirmation : bizStatus = PAY_SUCCESS, doneAmountOnChain inclus.

Notification d’arrivée de fonds : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, montant crédité = transferAmount.


2. Paiement partiel pendant la période de validité

Description : L’utilisateur paie moins que le montant de la commande pendant la période de validité. Une fois confirmé on-chain, le montant est crédité et une notification d’arrivée de fonds est envoyée.
Notification de statut de commande : Non déclenchée.
Notification d’arrivée de fonds : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, montant = transferAmount.


3. Paiement partiel sans complément

Description : Un paiement partiel est effectué, mais aucun montant supplémentaire n’est ajouté avant expiration.
Notification de statut de commande : Envoyée à l’expiration de la commande : bizStatus = PAY_CLOSE, montant = doneAmountOnChain.
Notification d’arrivée de fonds : Déjà envoyée lors de la réception des fonds. Pas de rappel supplémentaire.


4. Paiement partiel avec complément

4.1 Complété pendant la période de validité
Notification de statut de commande :

  • Lors du complément : bizStatus = PAY_EXPIRED_IN_PROCESS
  • Après confirmation : bizStatus = PAY_SUCCESS, doneAmountOnChain reflète le total reçu.

Notification d’arrivée de fonds : Envoyée uniquement après confirmation : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, montant = transferAmount.

4.2 Complété après la période de validité

Notification de statut de commande :

  • À l’expiration : bizStatus = PAY_CLOSE, montant = doneAmountOnChain.
  • Aucune notification de statut de commande supplémentaire après un complément tardif.

Notification d’arrivée de fonds :

  • Lors du complément tardif : bizStatus = TRANSFERRED_ADDRESS_DELAY, montant = transferAmount.
  • doneAmountOnChain ne sera pas inclus. Les marchands doivent additionner manuellement les différentes valeurs de transferAmount.

5. Paiement effectué après expiration

Description : L’utilisateur paie après l’expiration de la commande, quel que soit le montant.
Notification de statut de commande : À l’expiration : bizStatus = PAY_CLOSE.
Notification d’arrivée de fonds : Lors du paiement tardif : bizStatus = TRANSFERRED_ADDRESS_DELAY, montant = transferAmount. Pas de doneAmountOnChain et pas de callback de statut de commande pour les paiements post-expiration. Les marchands doivent additionner toutes les valeurs transferAmount reçues.


Le marchand doit déterminer le succès d’une commande en se basant à la fois sur le statut de la commande et sur les notifications de callback d’arrivée de fonds.

Clause de non-responsabilité

Le contenu présenté ici est fourni à titre informatif et éducatif uniquement et ne constitue en aucun cas un conseil financier, d'investissement, de trading ou juridique, ni une offre ou une sollicitation d'achat ou de vente de tout actif numérique. Gate ne donne aucune garantie expresse ou implicite quant à l'exactitude, l'exhaustivité ou l'actualité des informations contenues dans ce Les fonctions des produits, les interfaces, les règles et les structures tarifaires peuvent être modifiées ou ajustées à tout moment. Veuillez vous référer aux dernières annonces ainsi qu'aux informations affichées sur la plateforme Gate pour obtenir les détails les plus précis.

Les investissements en actifs numériques comportent des risques importants, et les prix peuvent connaître d'importantes fluctuations. Vous pouvez perdre la totalité de votre investissement. Veillez à prendre vos décisions avec prudence, en fonction de votre situation financière et de votre tolérance au risque, après avoir pleinement compris les risques associés. Si nécessaire, il est recommandé de consulter un conseiller financier ou juridique indépendant.

Pour plus d'informations sur les risques potentiels, veuillez consulter la déclaration des risques et les conditions d'utilisation de Gate.

Inscrivez-vous dès maintenant pour tenter de gagner jusqu’à $10,000!
signup-tips