1. Description
Ce document est destiné aux développeurs tiers (ci-après dénommés : ISV) ou aux commerçants développés indépendamment qui accèdent à l'API de remboursement et de retour pour développer les fonctions de remboursement et de gestion des retours des commerçants Tmall.
Ce document couvrira les scénarios d'appel d'API et les précautions. Les API de remboursement et de retour de Tmall et Bazaar seront unifiées dans un large ensemble d'interfaces ouvertes au public. Les autorisations d'API sont appliquées via le centre de certificats, et le temps de traitement est généralement ; dans les 5 jours ouvrables.
Pour ceux qui ont été connectés à l'interface tmall.eai.* pour le traitement des remboursements et des retours Tmall, vous devez d'abord resynchroniser les données de remboursement lors du traitement d'une commande de remboursement spécifique.
Veuillez rejoindre le groupe d'échange de problèmes :
1408358214
2. Processus d'appel
3. Changements de statut de remboursement
Le statut de la commande de remboursement peut être obtenu à partir du Statut dans la structure des données de remboursement et changera en fonction des changements dans l'opération de remboursement.
Concernant les changements dans le statut de la commande de remboursement, veuillez vous référer au processus de remboursement et de retour Tmall ci-dessus. La liste suivante est uniquement à titre de description :
.
API | Description | Description |
WAIT_SELLER_AGREE | L'acheteur a demandé un remboursement et attend pour l'approbation du vendeur | Statut lorsque l'acheteur soumet une demande de remboursement |
WAIT_BUYER_RETURN_GOODS | Le vendeur a accepté le remboursement et attend le retour de l'acheteur | Lorsque la demande de remboursement comprend un retour, le vendeur accepte le retour (backend ou taobao.rp.returngoods.agree ) |
WAIT_SELLER_CONFIRM_GOODS | L'acheteur a retourné la marchandise et attend que le vendeur confirme la réception | La demande de remboursement comprend le retour, le statut après le l'acheteur télécharge les informations logistiques de retour |
SELLER_REFUSE_BUYER | Le vendeur refuse de rembourser | Lorsque le vendeur refuse de retourner ou de rembourser |
SUCCÈS | Remboursement réussi | Le vendeur s'engage à retour par lots Statut après opération de paiement |
FERMÉ | Remboursement clôturé | Le statut après que le vendeur force l'expédition si la demande de remboursement expire ou lors d'une demande de remboursement pour une commande non expédiée |
IV. FAQ
1. Instructions d'utilisation pour les remboursements par lots (taobao.rp.refunds.agree)
L'interface taobao.rp.refunds.agree autorise uniquement les appels autorisés sous-compte, et le marché prend en charge lot (dans les 20 transactions, le montant total est inférieur à 6 000), Tmall prend en charge dans les 30 transactions, le montant total est inférieur à 10 000. Cette interface est divisée en deux étapes. La première fois sans le paramètre Code, le système enverra le code de vérification au téléphone mobile enregistré par l'utilisateur du sous-compte représenté par l'autorisation actuelle. La deuxième fois avec le paramètre Code (le paramètre). le contenu est le code de vérification), le consentement est exécuté. Si l'opération de paiement de remboursement est appelée avec succès, le paiement Alipay sera effectué directement à l'acheteur.所 Le numéro de sous-compte actuellement utilisé pour appeler l'API doit autoriser l'autorisation de l'opération de remboursement en arrière-plan du sous-compte et définir la limite de fonctionnement spécifique.
Instructions pour saisir les informations de remboursement
Pour le marché, les informations incluses sont les suivantes : RefundId (ID de la commande de remboursement), Frais (montant du remboursement), Version (obtenue via la structure de données de remboursement)
Pour Tmall, les données incluses incluent remboursement ID de paiement | son montant correspondant | liste des numéros de version correspondant | étape de remboursement (mise en vente après vente), où le montant est en unités, l'ID et le montant sont séparés par le symbole "|" et plusieurs commandes sont séparées par ","
Format :
RefundId1|Fee1|Version1|Refund_phase,RefundId2|Fee2|Version2|Refund_phase ...
Exemple :
192242532288979|6000|12312|envente,19224253229 8979|6000|32112|ons ale
Juge si le remboursement est réussi
Lorsque le succès est vrai, tous ne réussissent pas. Les éditeurs de logiciels indépendants doivent obtenir les résultats et juger s'ils réussissent un par un
2.
Jugé par Refund.has_good_return, true signifie à la fois le remboursement et le retour, false signifie uniquement le remboursement
3 Comment obtenir la phase de remboursement et la version de remboursement de la commande de remboursement
Il peut être obtenu à partir de Refund via l'interface de requête
4. Modification par l'acheteur Quel est l'impact de l'opération de remboursement par le vendeur après la demande de remboursement ?
Une fois que l'acheteur a modifié la demande de remboursement, la version_remboursement du remboursement sera vérifiée lors de l'opération de remboursement. interrogé via l'interface taobao.refund.get pendant l'opération. Informations de remboursement pour des commandes de remboursement spécifiques.
5. Tmall ne prend actuellement pas en charge l'opération consistant à laisser un message de remboursement ;
6. Il ne prend actuellement pas en charge l'interface de consentement au remboursement, qui ne doit être appelée qu'une seule fois pour terminer l'opération de remboursement. transférer directement de l'argent vers Alipay, pour des raisons de sécurité, il doit être obtenu via Complétez le remboursement par SMS.
7. Actuellement, seuls les sous-comptes sont autorisés à autoriser les opérations de remboursement pour les exigences de consentement aux opérations de remboursement, c'est-à-dire utiliser la SessionKey ou l'AccessToken obtenue via l'autorisation du sous-compte pour appeler taobao.rp.refunds.agree. Comment utiliser la référence d'autorisation de sous-compte :
//open.taobao.com/doc/detail.htm?spm=a219a.7386797.0.0.dXrNao&id=101141
Une attention particulière doit être portée pour s'assurer que le sous-compte le compte a un service client-vente Gestion après-vente - accepter le remboursement (le marché nécessite la gestion des transactions - remboursement à mi-vente du sous-compte - accepter le remboursement du sous-compte) point d'autorisation.
8. Le bac à sable ne prend pas en charge le débogage du consentement au remboursement
9. La liste error_code renvoyée par l'interface de consentement au remboursement est :
.
Numéro | Signification |
10000 | Deuxième vérification SMS envoyé avec succès |
10001 | Échec de l'envoi du deuxième SMS de vérification |
10002 | Le deuxième code de vérification a été envoyé dans les 5 minutes précédant |
10003 | Échec du code SMS de vérification |
10004 | SMS code de vérification Délai d'attente (15 minutes) |
10005 | Je n'ai pas saisi le code de vérification par SMS |
10006 | Veuillez d'abord obtenir le code de vérification |
20000 | Le nombre de demandes de remboursement dépasse la limite |
20001 | Le montant de la demande de remboursement dépasse la limite |
3 0000 | Numéro de remboursement illégal |
30001 | Le remboursement n'existe pas |
Petite commande |
40000 | Opération réussie |
40001 | Opération échouée |
40002 | Certaines opérations ont échoué |
40003 | Exception de défaillance du système de fonctionnement |
50000 | Non-sous-compte |
60000 | La version du formulaire de remboursement a changé |
6 0001 | Le montant appliqué est incompatible avec le montant réel |
99999 | Autres exceptions |
5. Impliquant l'API
Lien du document API :
//open.taobao.com/doc/api_cat_detail.htm?scope_id=11527&category_id=102
API | description de la fonction |
Demande de retour Liste de paiement
| taobao.refund.get | Demande pour un remboursement unique |
taobao.rp.returngoods.refuse | Retour refusé |
taobao.rp.returngoods.agree | Accepter de retourner |
taobao.rp.returngoods.refill | Le commerçant Tmall remplit le numéro de suivi logistique du remboursement |
taobao.rp.refund.review | Marque de commande de remboursement |
taobao.refund.refuse | Remboursement refusé |
taobao.rp.refunds.agree | Convenir des remboursements par lots |
FAQ
- Il n'y a pas encore de FAQ sur ce document