Relivrer, rembourser, reprendre un véhicule : les ventes en argent réel

En bref. Une vente de la concession payée en argent réel (PayPal direct, ou Tebex quand c'est Agora qui livre) peut mal tourner : paiement jamais noté, véhicule jamais livré, remboursement fait chez PayPal ou chez Tebex. Modération → Concession a les gestes pour chaque cas, réservés aux administrateurs. Pour les ventes en argent du jeu, voir La concession de véhicules.

Ce qu'il faut savoir d'abord #

• Chaque geste exige la 2FA du staff (si elle est exigée) et la licence couvrant le MDT, comme le reste de la concession.
• Chaque geste est écrit au journal d'administration, famille Ventes et paiements.
• Le montant et la devise sont toujours relus chez PayPal ou dans la vente : rien ne vient du navigateur.
• Les lignes qui demandent un geste (payée mais non livrée, véhicule à reprendre, achat Tebex non livré ou livraison interrompue) restent en tête de la liste, même noyées sous de nouvelles ventes. Seules les 100 dernières lignes « normales » s'affichent, mais une ligne à traiter n'en sort jamais.

Une vente PayPal direct : que faire selon l'état #

Revérifier le paiement #

PayPal peut avoir encaissé sans qu'Agora l'ait noté (la réponse a dépassé le délai, l'acheteur a vu une page d'échec et n'est jamais revenu). Revérifier le paiement relit la commande chez PayPal, sans jamais déclencher lui-même un encaissement : un acheteur qui n'a rien approuvé n'est pas débité par ce bouton. Si l'argent est bien encaissé (montant et devise de la vente), le paiement est noté et le véhicule livré. Sinon, rien ne change.

Automatique si le webhook PayPal est branché (événement Payment capture completed coché : voir Les campagnes de dons) : quand PayPal passe une capture « en attente » à « complété », Agora fait ce même geste tout seul. Jamais de doublon (déjà livrée = rien), jamais de livraison sur un paiement refusé ou non réglé. Si le véhicule ne peut pas être livré (joueur en ligne…), le paiement est noté et chaque administrateur reçoit une notification « livraison à refaire » : clique Relivrer.

Relivrer #

Relivrer rejoue la livraison d'une vente payée dont le véhicule n'est pas arrivé en jeu. Jamais deux véhicules : Agora cherche d'abord celui qui serait déjà déposé (ses plaques sont déterminées par la vente) et relit le paiement chez PayPal avant de livrer. Une capture déjà remboursée, un montant différent ou un PayPal qui ne répond pas : rien n'est livré. Un double clic ne livre qu'un véhicule.

Rembourser #

Rembourser (avec une case « Je comprends… ») rend à l'acheteur le montant de la capture en entier, retire le véhicule du garage et le remet au stock.

• Le stock n'est rendu que si le véhicule a vraiment été retiré et si la livraison avait bien décompté une unité : un véhicule retrouvé en jeu après une livraison interrompue n'avait rien décompté, rien n'est rendu. Un modèle à stock illimité le reste.
• Une vente payée mais jamais livrée se rembourse aussi : l'argent est rendu, rien n'est retiré, le stock ne bouge pas.
• Si PayPal ne peut pas rembourser et que le véhicule est parti, l'écran te dit de rendre l'argent à la main depuis PayPal. Si rien n'a bougé du tout, la vente reste remboursable.
• Si le retrait du véhicule échoue, l'écran le dit et la vente redevient réessayable.
• Le joueur ne peut plus se faire livrer une vente remboursée, même en rouvrant son lien de retour.
• Un modèle qui a des ventes en argent réel ne peut plus être supprimé du catalogue : désactive-le (décoche En vente).

Reprendre le véhicule #

L'argent est rendu mais le véhicule n'a pas pu être retiré (joueur en ligne, base du jeu injoignable, livraison en cours) : la ligne l'affiche en orange. Clique Reprendre le véhicule quand le joueur est hors ligne.

Le drapeau « à reprendre » est levé dès que le remboursement est enregistré et ne retombe qu'après un retrait constaté : si Agora est interrompu au milieu (mise à jour, redémarrage), la vente reste « à reprendre » et visible, rien ne se perd. Si tu cliques pendant qu'un retrait est en cours, Agora refuse quelques minutes pour ne pas retirer deux fois. Le stock n'est remis qu'une seule fois, même si la reprise est rejouée.

Un remboursement fait chez PayPal #

Si tu rembourses (ou perds un litige) directement dans le tableau de bord PayPal, Agora peut le reprendre tout seul grâce au webhook PayPal : la vente passe à Remboursé (chez PayPal), le stock revient et le véhicule est repris. Si le joueur est en ligne, la ligne l'indique et chaque administrateur reçoit une notification ; Reprendre le véhicule le fait plus tard.

• Le webhook se branche dans Administration → Configuration → Paiements : voir Les campagnes de dons, section « Remboursements faits chez PayPal ». Sans lui, rembourse depuis Agora : Rembourser rend l'argent par PayPal.
• Un remboursement partiel note le montant rendu sur la ligne (« Remboursée en partie chez PayPal : … ») et prévient les administrateurs, mais le véhicule reste au joueur : Agora ne le reprend jamais pour un remboursement partiel, c'est à toi de décider. Rembourser rend alors le reste et reprend le véhicule. Un litige ouvert ne change rien (l'argent est seulement retenu), mais les administrateurs sont prévenus.
• Un remboursement signé dont Agora ne retrouve pas la capture, ou dont il ne peut pas relire l'état chez PayPal, n'est jamais rangé en silence : une notification « à vérifier dans PayPal » part.
• Le journal d'administration garde la trace, avec l'auteur « PayPal ».

Les paniers abandonnés #

Un acheteur qui ferme PayPal avant de payer laisse une ligne « paiement non confirmé ». Agora les supprime seul après 90 jours (tâche de fond, par petits lots). Une vente qui porte la moindre trace d'argent ou de véhicule (paiement noté, remboursement, livraison, véhicule à reprendre) n'est jamais supprimée. Si un paiement a réussi chez PayPal sans qu'Agora le sache, Revérifier le paiement reste possible pendant ces 90 jours.

Les achats Tebex livrés par Agora #

Quand tu as choisi Agora livre (voir Vendre sur ton serveur avec Tebex), les achats apparaissent dans la liste Achats reçus.

• Agora ne peut pas rembourser chez Tebex : il n'a que la clé publique de ta boutique, qui lit le catalogue et crée des paniers. Rembourse l'achat dans le panneau Tebex (le lien et le numéro de transaction sont sur la ligne), puis clique Marquer remboursé : Agora garde la trace et retire le véhicule déjà livré. Le stock n'est pas touché (Agora ne le décompte jamais pour Tebex).
• Relivrer reprend une livraison interrompue (plantage) : le véhicule déjà déposé est retrouvé, jamais doublé. Il n'existe que pour les achats reçus après cette version.
• Un achat d'avant le suivi des plaques (livré, sans plaque notée) ne peut pas être retrouvé en jeu : Marquer remboursé te demande de confirmer « sans reprise du véhicule » (tu le retires à la main du garage du joueur). J'ai retiré le véhicule à la main règle une ligne que Tebex a remboursée de lui-même.
• Remboursement fait chez Tebex (ou litige perdu) : avec le webhook Tebex branché, coche payment.refunded, payment.dispute.lost et payment.dispute.opened dans le webhook de ta boutique. L'achat passe à Remboursé (chez Tebex) et le véhicule déjà livré est repris ; si le joueur est en ligne, la ligne l'indique et les administrateurs sont prévenus. Un litige seulement ouvert ne change rien (l'argent est retenu) : les administrateurs sont prévenus.
• Seuls les paquets que l'événement désigne sont marqués et repris : si une transaction de plusieurs paquets n'en voit qu'un remboursé, les autres véhicules restent et les administrateurs sont prévenus. Un remboursement qui arrive avant l'encaissement n'est pas annulé par lui : l'ordre des événements ne compte pas.
• Le journal d'administration garde la trace, avec l'auteur « Tebex ».

Un événement rejoué #

PayPal et Tebex rejouent un événement tant qu'ils n'ont pas reçu de réponse. Pendant qu'un premier passage tourne, le rejeu reçoit « occupé » (503) et revient plus tard : un événement n'est jamais traité en parallèle. Si le premier passage est tombé en route et que le véhicule est resté « à reprendre », les administrateurs sont prévenus de nouveau.

Le remboursement n'apparaît pas dans Agora #

C'est presque toujours le webhook PayPal : voir Un remboursement fait chez PayPal n'apparaît pas.