Aide
Gate Pay
Guide d_intégration des marchands

Gate Pay FAQ

2025-06-25 UTC
17857 Lire
3

Questions Fréquemment Posées

Limites de Montant de l'Ordre

1. Montant minimum limite : Gate Payment: 0.0001 (toutes les unités monétaires)

Web3 Paiement 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 renverra les valeurs maximales et minimales.

Le montant de l'ordre ne doit pas être inférieur au montant minimum fixé. Par exemple, si la limite de montant minimum est 0.0001, le montant de l'ordre doit être ≥ 0,0001, tel que 0.0001, 0.00011, etc.

2. Limite de Précision: Le nombre de décimales dans le montant de l'ordre 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 entraînera une erreur et ne sera pas arrondi.

Le montant de l'ordre doit rencontrer les deux le montant minimum et les exigences de précision, sinon, il ne peut pas être soumis. Par exemple, si le le montant minimum est de 0.0001 et le la limite de précision est de 0,1, 0.01 ne satisferait toujours pas l'exigence de précision et entraînerait une erreur.

Explication des frais de retrait

API pour vérifier le statut de retrait

https://www.gate.com/docs/developers/apiv4/fr/#retrieve-withdrawal-status

Description

Le « Vérifier l'état du retrait » L'API permet aux utilisateurs de récupérer des informations sur les frais de retrait pour différents tokens sur les chaînes prises en charge. Les utilisateurs peuvent sélectionner la chaîne selon leurs besoins.

Paramètres de frais

retirer_fixe_sur_chains: Frais de retrait fixes

pourcentage_de_retrait_sur_chaînes: Frais de retrait basés sur un pourcentage (applicable à certains jetons spéciaux, calculé comme Montant de retrait × Taux de pourcentage)

Formule de calcul

Frais de retrait = Frais fixes + ( Taux de frais en pourcentage × Montant du retrait)

Remarques supplémentaires

Les chaînes les plus couramment utilisées ne facturent qu'un frais de retrait fixes, qui mises à jour toutes les heures.

Veuillez Faites une demande API avant chaque retrait pour obtenir les dernières données de frais et garantir des calculs précis.

Pourquoi un paiement effectué dans la période de validité est-il marqué comme un ordre expiré ?

Le temps de paiement est déterminé en fonction du moment où la transaction est détectée on-chain, et non lorsque l'utilisateur a initié le paiement. Un retard peut survenir entre ces deux moments.

Pourquoi les factures affichées sur l'application ou le site web de Gate diffèrent-elles du paiement réel reçu ?

L'application ou le site Web affiche le montant de la commande, et non le montant réel payé par l'utilisateur. Même si le paiement de l'utilisateur diffère du montant de la commande, le montant de la commande sera toujours affiché. Pour une facturation détaillée, référez-vous toujours au backend du marchand.

Signification de merchantTradeNo et merchantUserId dans l'API de création d'ordre

  1. merchantTradeNo: Le numéro de commande dans le système du merch, avec une longueur maximale de 32 caractères.
  2. merchantUserId: L'ID de compte utilisateur dans le système du marchand. Cela doit être un ID utilisateur valide ; sinon, les remboursements liés aux paiements à l'adresse échoueront car le système ne peut pas identifier l'utilisateur.

Informations de rappel pour les paiements d'adresse on-chain

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

  1. Notification d'arrivée de fonds (TRANSFER_ADDRESS): Une notification concernant le fonds reçu.
  2. Notification de changement d'état de l'ordre (PAY_ADDRESS): Une notification concernant les changements dans le statut de l'ordre.

Les commerçants doivent s'appuyer sur ces deux types d'informations pour déterminer si l'ordre est réussi pour procéder à l'expédition ou gérer les commandes échouées.

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

  1. Notification d'arrivée de fonds Envoyé après que le paiement est confirmé off-chain, permettant aux fonds d'être crédités sur le compte du merch en temps réel tout en informant le merch.
  2. Notification de changement de statut de l'ordre Déclenché lorsque le statut de l'ordre change.

Comprendre l'état de rappel

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 l'ordre.
  • TRANSFERRED_ADDRESS_DELAY: Les fonds reçus après la période de validité sont crédités sur le compte de paiement du merch (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 été réussi.
  • PAY_CLOSE: La commande a expiré.
  • PAY_EXPIRED_IN_PROCESS: En attente de confirmation off-chain des fonds.

Scénarios de paiement et détermination du statut des ordres pour les paiements d'adresse off-chain

1. Paiement complet ou paiement excessif dans la période de validité

Description : Si un utilisateur paie le montant total ou plus que le montant requis dans la période de validité, une fois confirmé off-chain, les deux rappels sont déclenchés.

Notification de l'état de l'ordre :

  • 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 dans la période de validité

Description : L'utilisateur paie moins que le montant de l'ordre dans la période de validité. Une fois confirmé off-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é.

Notification d'arrivée de fonds : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, montant = transferAmount.

3. Paiement partiel sans supplément

Description : Un paiement partiel est effectué, mais aucun montant supplémentaire n'est ajouté avant l'expiration.

Notification de statut de l'ordre : Envoyé à l'expiration de la commande : bizStatus = PAY_CLOSE, montant = doneAmountOnChain.

Notification d'arrivée de fonds : Déjà envoyé plus tôt lorsque les fonds sont arrivés. Pas de rappel répété.

4. Paiement partiel avec supplément

4.1 Supplémenté dans la période de validité Notification de l'état de l'ordre :

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

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

4.2 Supplémenté après la période de validité

Notification de statut de l'ordre :

  • À l'expiration : bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
  • Aucune notification d'état de l'ordre supplémentaire après le complément tardif.

Notification d'arrivée de fonds :

  • En cas de supplément tardif : bizStatus = TRANSFERRED_ADDRESS_DELAY, montant = transferAmount.
  • doneAmountOnChain ne sera pas inclus. Les marchands doivent agréger manuellement plusieurs valeurs de transferAmount.

5. Paiement effectué après expiration

Description : L'utilisateur paie après l'expiration de l'ordre, quel que soit le montant.

Notification de l'ordre : À l'expiration : bizStatus = PAY_CLOSE.

Notification d'arrivée de fonds :En cas de paiement tardif : bizStatus = TRANSFERRED_ADDRESS_DELAY, montant = transferAmount. Pas de doneAmountOnChain et pas de rappel de statut de commande pour les paiements après expiration. Les commerçants doivent additionner toutes les valeurs de transferAmount reçues..

Le marchand doit déterminer le succès d'un ordre en fonction à la fois de l'état de l'ordre et des notifications de rappel d'arrivée de fonds.

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