Documentation de l’API de notification de callback Gate Pay : https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
Interprétation des informations de statut des callbacks de paiement
Type d’adresse dynamique
1. Notification d’arrivée de fonds sur une adresse dynamique (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM : Les fonds sont crédités instantanément pendant la période de validité de la commande.
TRANSFERRED_ADDRESS_DELAY : Si le paiement est crédité après la période de validité, le montant effectivement payé est crédité sur le compte de solde du marchand (crédit instantané après la période de validité).
2. Notification de changement de statut de commande de paiement sur adresse dynamique (biztype = PAY_ADDRESS)
PAY_SUCCESS : Paiement réussi.
PAY_CLOSE : Commande expirée.
PAY_EXPIRED_IN_PROCESS : En attente de confirmation des fonds sur la blockchain.
Type d’adresse statique
1. Paiement réussi sur adresse statique (biztype=PAY_FIXED_ADDRESS)
PAY_SUCCESS : Paiement réussi et fonds crédités.
2. Adresse statique marquée comme adresse à risque (biztype=FIXED_ADDRESS_RISK)
RISK_ADDRESS : L’adresse statique a été signalée comme adresse à risque.
Type de paiement sur adresse anormale
Pour chaque transaction de paiement anormale, Gate Pay enverra une notification webhook au marchand concerné.
Le bizType pour ce type de paiement est toujours PAY_UNRESOLVED.
Les marchands doivent déterminer la nature du problème de facturation en se basant sur le champ errorType dans les données et consulter le Guide de gestion des paiements anormaux Gate Pay ou contacter leur gestionnaire de compte Gate Pay.
- address_risk_address
— Adresse dynamique à haut risque - address_error_currency
— Devise incorrecte pour l’adresse dynamique - address_error_chain
— Réseau blockchain incorrect pour l’adresse dynamique - fix_error_currency
— Devise incorrecte pour l’adresse statique - fix_error_chain
— Réseau blockchain incorrect pour l’adresse statique - fix_risk_address
— Adresse statique à haut risque - fix_delete
— Adresse statique supprimée - fix_partial_delete
— Adresse statique partiellement supprimée
À propos des informations de callback pour les paiements sur adresse dynamique
Pourquoi existe-t-il deux types d’informations de callback de paiement ?
- Notification d’arrivée de fonds (TRANSFER_ADDRESS) : notification du montant effectivement crédité.
- Notification de changement de statut de commande (PAY_ADDRESS) : notification des changements de statut de la commande.
Les marchands doivent utiliser ces deux types d’informations pour déterminer si une commande a abouti, afin de procéder à la livraison ou de gérer les commandes échouées.
Quand les notifications de callback sont-elles envoyées ?
- Notification d’arrivée de fonds : Après confirmation sur la blockchain d’un paiement réussi, les fonds sont crédités en temps réel au marchand et un callback est envoyé.
- Notification de changement de statut de commande : Déclenchée lors d’un changement de statut de la commande.
Scénarios de paiement sur adresse dynamique et détermination du statut de la commande
1. Paiement unique complet ou supérieur pendant la période de validité
Description : Tant que l’utilisateur paie la totalité ou un montant supérieur pendant la période de validité de la commande, un callback est envoyé en temps réel après confirmation sur la blockchain.
Statut de la commande : Initialement, le système attend la confirmation des fonds sur la blockchain et envoie un callback avec un statut intermédiaire : bizStatus est PAY_EXPIRED_IN_PROCESS. Après confirmation sur la blockchain, la commande est considérée comme réussie et un callback est envoyé avec bizStatus à PAY_SUCCESS et le montant crédité dans doneAmountOnChain.
Notification d’arrivée de fonds : bizStatus est TRANSFERRED_ADDRESS_IN_TERM, montant crédité dans transferAmount.
2. Paiement insuffisant pendant la période de validité
Description : Si l’utilisateur paie moins que le montant de la commande pendant la période de validité, après confirmation sur la blockchain, le montant effectivement payé est crédité au marchand et un callback d’arrivée de fonds est envoyé en temps réel.
Statut de la commande : Pendant la période de validité, le statut de la commande ne change pas et aucun callback de statut de commande n’est envoyé.
Notification d’arrivée de fonds : bizStatus est TRANSFERRED_ADDRESS_IN_TERM, montant crédité dans transferAmount.
3. Paiement insuffisant pendant la période de validité, sans complément
Description : Si l’utilisateur paie moins que le montant de la commande pendant la période de validité et ne complète pas le paiement pendant cette période.
Statut de la commande : À la fin de la période de validité, un callback de statut de commande est envoyé. bizStatus est PAY_CLOSE, montant crédité dans doneAmountOnChain.
Notification d’arrivée de fonds : Le callback d’arrivée de fonds a déjà été envoyé après le paiement et ne sera pas renvoyé.
4. Paiement insuffisant pendant la période de validité, puis complété
4.1 Complément effectué pendant la période de validité :
Après que l’utilisateur a complété le paiement :
Statut de la commande : Le système attend la confirmation des fonds sur la blockchain et envoie un callback avec un statut intermédiaire : bizStatus est PAY_EXPIRED_IN_PROCESS.
Notification d’arrivée de fonds : Aucune notification d’arrivée de fonds n’est envoyée en attendant la confirmation sur la blockchain du paiement complémentaire.
Après confirmation sur la blockchain :
Statut de la commande : Une fois les fonds confirmés sur la blockchain et le montant total suffisant, la commande est considérée comme réussie. bizStatus est PAY_SUCCESS, montant crédité dans doneAmountOnChain (total de tous les paiements).
Notification d’arrivée de fonds : bizStatus est TRANSFERRED_ADDRESS_IN_TERM, montant crédité dans transferAmount.
4.2 Complément effectué après la période de validité :
Statut de la commande : Comme le montant total n’a pas été payé pendant la période de validité, un callback de statut de commande est envoyé à la fin de la période. bizStatus est PAY_CLOSE, montant crédité dans doneAmountOnChain.
Notification d’arrivée de fonds : Le callback d’arrivée de fonds a déjà été envoyé après le paiement et ne sera pas renvoyé.
Si l’utilisateur complète le paiement après la période de validité : un callback d’arrivée de fonds est envoyé avec bizStatus à TRANSFERRED_ADDRESS_DELAY, montant crédité dans transferAmount. (Dans ce cas, aucun autre callback de statut de commande n’est envoyé, et le callback final ne comporte pas le champ doneAmountOnChain. Si l’utilisateur effectue le paiement en plusieurs transactions, le marchand doit additionner tous les montants transferAmount reçus dans les callbacks pour confirmer le montant total crédité.)
5. Paiement expiré
Description : Si l’utilisateur paie après la période de validité de la commande, que ce soit partiellement, totalement ou en excès, les fonds sont crédités en temps réel après confirmation sur la blockchain.
Changement de statut de la commande : Comme aucun paiement n’a été effectué pendant la période de validité, un callback est envoyé avec bizStatus à PAY_CLOSE à la fin de la période de validité.
Arrivée des fonds : Pas de notification d’arrivée de fonds.
Paiement après expiration : Après expiration, pour chaque paiement effectué, une notification d’arrivée de fonds est envoyée avec bizStatus à TRANSFERRED_ADDRESS_DELAY, montant crédité dans transferAmount. (Dans ce cas, aucun autre callback de statut de commande n’est envoyé, et le callback final ne comporte pas le champ doneAmountOnChain. Si l’utilisateur effectue le paiement en plusieurs transactions, le marchand doit additionner tous les montants transferAmount reçus dans les callbacks pour confirmer le montant total crédité.)
Les marchands doivent utiliser à la fois les informations de statut de commande et d’arrivée de fonds pour déterminer si la commande a réussi.
6. Informations de callback anormales pour les paiements sur adresse dynamique
6.1 Paiement effectué avec une devise ou un réseau blockchain différent de la commande
Le marchand recevra un callback avec Biztype=PAY_UNRESOLVED et data.errorType=address_error_currency ou address_error_chain.
6.2 Fonds signalés comme risqués et interceptés
Le marchand recevra un callback avec biztype=PAY_UNRESOLVED et data.errorType=address_risk_address.
À propos des informations de callback pour les adresses statiques
1. Paiement réussi crédité
Une notification PAY_SUCCESS sera reçue, indiquant que le paiement a réussi et que les fonds ont été crédités.
2. Callback de paiement anormal
2.1 Paiement effectué avec une devise ou un réseau différent de la commande
Le marchand recevra un callback avec biztype=PAY_UNRESOLVED et data.errorType=fix_error_currency ou fix_error_chain.
2.2 Fonds à risque
Le marchand recevra un callback avec biztype=PAY_UNRESOLVED et data.errorType=fix_risk_address.
2.3 Paiement envoyé à une adresse statique supprimée
Le marchand recevra un callback avec biztype=PAY_UNRESOLVED et data.errorType=fix_delete ou fix_partial_delete.
3. Notification de risque sur adresse statique
Une notification sera reçue avec bizType=FIXED_ADDRESS_RISK et bizStatus=RISK_ADDRESS, indiquant que l’adresse de réception statique liée au marchand a été identifiée comme adresse à risque. Les marchands doivent immédiatement supprimer l’adresse statique concernée. Si des utilisateurs continuent à effectuer des paiements vers cette adresse, les fonds ne seront pas crédités.
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.
