返金と返品のシナリオ
1. 説明
このドキュメントは、Tmall 加盟店の返金と返品を開発するために返金と返品 API にアクセスするサードパーティ開発者 (以下、isv と呼びます) または独立して開発した開発者を対象としています。管理機能、販売者。
このドキュメントでは、API 呼び出しのシナリオと注意事項について説明します。Tmall とバザールの返金および返品 API は、一般公開されている大規模なインターフェイスのセットに統合されます。API 権限は証明書センターを通じて適用され、処理時間は通常 5 営業日以内です。
## Tmall の返金および返品処理のために tmall.eai.* インターフェイスに接続している方は、特定の返金注文を処理するときに、必ず最初に返金を再同期してください。支払いデータ。
問題交換グループに参加してください:
1408358214
2. 呼び出しプロセス
3. 返金ステータスの変更
返金注文のステータスは次のとおりです。 OK 返金データ構造で取得されるステータスは、返金操作の変更に応じて変化します。
返金注文ステータスの変更については、上記の Tmall 返金および返品プロセスを参照してください。以下のリストは説明のみを目的としています。既存の返金注文ステータス:
#API | ##説明 | #説明
|
##WAIT_SELLER_AGREE|
購入者が返金を申請し、販売者の承認を待っています |
購入者が返金申請を送信したときのステータス |
|
WAIT_BUYER_RETURN_GOODS | 販売者は返金に同意し、購入者が商品を返品するのを待っています | 返金申請が行われるとき返品が含まれている場合、販売者は返品に同意します (バックエンドまたは taabao.rp.returngoods.agree) |
# 後のステータス# WAIT_SELLER_CONFIRM_GOODS | 購入者は商品を返品し、販売者が受領を確認するのを待っています | 返金申請（返品を含む）、購入者が返品物流情報をアップロードした後のステータス |
| ## SELLER_REFUSE_BUYER
| 販売者が返金を拒否した場合 | 販売者が商品の返品または返金を拒否した場合 |
成功 | ##払い戻し成功 | 販売者が一括払い戻し操作に同意した後のステータス |
CLOSED | 払い戻しは終了しました | 返金申請がタイムアウトになった、または販売者が未出荷の注文に対する返金申請を強制した後のステータス |
4. よくある質問
1. 一括同意返金の操作手順 (taabao.rp.refunds.agree)
taovao.rp .refunds.agree インターフェイスではサブアカウントの承認済みコールのみが許可され、マーケットはバッチ (20 トランザクション以内、合計金額 6,000 以内) をサポートし、Tmall は 30 トランザクション以内、合計金額 10,000 以内をサポートします。このインターフェイスは 2 つの段階に分かれており、最初は Code パラメーターが指定されていない場合、システムは現在の認証で表されるサブアカウント ユーザーが登録した携帯電話に確認コードを送信します。2 回目は Code パラメーター (コンテンツパラメータのは検証コードです)、同意が実行され、返金支払い操作が正常に呼び出された場合、Alipay の支払いは購入者に直接行われます。
API の呼び出しに現在使用されているサブアカウントは、サブアカウントのバックグラウンドで返金操作の権限を承認し、特定の操作制限を設定する必要があります。
入力パラメータrefund_infosの説明
マーケットの場合、含まれる情報は次のとおりです:RefundId (払い戻し注文ID)、Fee (払い戻し金額)、バージョン(Refundデータ構造を通じて取得)
Tmall の場合、含まれるデータには返金 ID|対応する金額|対応するバージョン番号リスト|返金ステージ (販売中/アフターセール) が含まれます。金額は単位であり、ID と金額は「|」記号で区切られています。 、複数の注文は ","
Format:
RefundId1|Fee1|Version1|Refund_phase,RefundId2|Fee2|Version2|Refund_phase...
で区切られます。例:
192242532288979|6000|12312|onsale,192242532298979|6000|32112|onsale
返金が成功したかどうかを判断する
成功が true の場合、そうでない場合必ずすべてが成功します。ISV は結果を 1 つずつ取得して、成功したかどうかを判断する必要があります。
2. 利益があるかどうかを確認するにはどうすればよいですか?
Refund.has_good_return によって判断され、true は返金と返品の両方を意味し、false は返金のみを意味します
3. 返金注文の返金フェーズと返金バージョンを取得する方法
クエリを介してインターフェイスは返金から取得されます
4. 購入者が返金申請を変更した後の販売者の返金注文操作の影響は何ですか?
購入者が返金申請を変更した後、返金の返金バージョンが変更されます。返金バージョンは支払い操作中にチェックされます。操作中に、特定の返金注文の返金情報は、taobao.refund.get インターフェースを通じて照会できます。
5. Tmall は現在、返金メッセージの操作をサポートしていません;
6. 現在、返金インターフェースを 1 回だけ呼び出すことによる返金操作はサポートされていません。 Alipay の場合、セキュリティ上の理由から、返金はテキスト メッセージを取得することで完了する必要があります。
7. 現在、払い戻し操作要件にはサブアカウント承認操作のみが許可されています。つまり、サブアカウント承認を通じて取得した SessionKey または AccessToken を使用して taabao.rp.refunds.agree を呼び出す操作のみです。サブアカウント認証の使用方法のリファレンス:
//open.taabao.com/doc/detail.htm?spm=a219a.7386797.0.0.dXrNao&id=101141
特別な注意と保証このサブアカウントには、顧客サービス - 販売およびアフターセールス管理 - 返金同意の権限ポイントがあります (市場では、取引管理 - 販売中のサブアカウント返金 - サブアカウント返金同意が必要です)。
8. サンドボックスは返金同意のデバッグをサポートしていません
9. 返金同意インターフェイスによって返される error_code リストは次のとおりです:
#番号 | ##意味 |
#10000
##2 番目の確認 SMS が正常に送信されました | | ##10001
2 段階認証テキスト メッセージの送信に失敗しました |
| 10002
2 番目の確認コードが 5 分以内に発行されました。 |
#10003 | ##SMS コードの確認に失敗しました |
#10004
SMS 確認コードのタイムアウト (15 分) | | ##10005
##SMS 確認コードが入力されていません |
10006 |
まず確認コードを取得してください | ##20000 | #払い戻しリクエストの数が制限を超えています |
| #20001 | #返金要求額が制限を超えています
|
##30000
| 不正な払い戻し番号
|
##30001 払い戻しは存在しません |
| #30002
Tmall 注文 ## |
##40000 | ##操作は成功しました
|
40001
操作は失敗しました |
| 40002
部分的な操作が失敗しました |
##40003 |
操作に失敗したシステム例外 | # # 50000 | #非サブアカウント |
| ##60000 | 払い戻しフォームのバージョンが変更されました
|
##60001
| 適用金額が実際の金額と一致しません
|
##99999 その他の例外 |
5. API の関与API ドキュメント リンク: //open.taabao.com/doc/api_cat_detail.htm?scope_id=11527&category_id=102 | ##API
| ##関数の説明 | taabao.user.seller.get
販売者情報のクエリ |
##taabao.refunds.receive.get | # 返金リストをクエリする | タオバオ.refund.get | #単一払い戻しのクエリ | ##taabao.rp.returngoods.raise #返品拒否 |
| #taovao.rp.returngoods.agree 返品に同意する |
#taovao.rp.returngoods.refill | Tmall 販売者が返金物流注文番号をバックフィルします | #taabao.rp.refund.review | #返金注文マーク | ##taabao.refund.refles
| 返金を拒否
| taabao.rp.refunds.agree##一括払い戻しに同意する |
##FAQ | このドキュメントに関する FAQ はありません
|
