注文の払い戻し

3.1.4. 注文の払い戻し#

このページには、注文の払い戻しのプロセスや払い戻しに関わるさまざまな期限について説明するビデオチュートリアルのすべての文書が含まれています。

3.1.4.1. ビデオ#

3.1.4.2. インフォメーション#

注文を作成するプロセスに慣れていない場合は、 Taler merchant creating orders チュートリアルをご覧ください。

3.1.4.3. 必要条件#

このチュートリアルシリーズに必要：

  • Talerマーチャントバックエンド
    マーチャントバックエンドを初めて使用する際にヘルプが必要な場合は、 Taler merchant introduction チュートリアルをご覧ください。
  • Talerウォレットのインスタンス
    セットアップ方法はhttps://wallet.taler.net。
  • REST API管理ソフトウェアまたは関連プログラミングスキル
    このビデオシリーズでは、https://insomnia.rest からダウンロードできるフリーソフト「インソムニア」を使用します。

3.1.4.4. デモ・バックエンドのお知らせ#

このチュートリアルでは、ご自身のマーチャント・バックエンド・サービス、または https://backend.demo.taler.net/instances/sandbox/ のオンライン・デモンストレーション・サービスをご利用いただけます。

3.1.4.5. マーチャント・オーダーの払い戻しに関するその他の注意事項#

GNU Talerにおける払い戻しは、支払いを「取り消す」方法です。商人によって承認される必要があります。払い戻しは、元の支払額の何分の一でも可能ですが、元の支払額を超えることはできません。払い戻しには期限があり、取引所が特定の支払いの資金をエスクローで保管している間のみ可能です。払い戻しが可能な期間は、注文で refund_deadline を設定することで制御できます。この払い戻し期限のデフォルト値は、マーチャントのバックエンドの設定で指定します。

フロントエンドは、 /private/orders/$ORDER_ID/refund エンドポイントに POST することで、マーチャントのバックエンドに返金を承認するように指示することができます。

払い戻しリクエストJSONオブジェクトには2つのフィールドしかありません：

  • 払い戻し払い戻される金額。もし同じオーダーに対して以前の払い戻しが許可されていた場合、新しい払い戻し金額の方が高くなければなりません。この値は払い戻される合計金額を示し、払い戻しの増加ではありません。

  • 理由 reason：払い戻しを正当化するために人間が読めるようにしたもの。理由はバックオフィスでのみ使用され、顧客には公開されません。

リクエストが成功した場合(HTTPステータスコード200で示される)、レスポンスには taler_refund_uri が含まれます。フロントエンドは、払い戻しがウォレットによって処理されるように、顧客のブラウザをそのURLにリダイレクトしなければなりません。

このコードは払い戻しを説明するためのものです：

>>> import requests
>>> refund_req = dict(refund="KUDOS:10",
...                   reason="Customer did not like the product")
>>> requests.post("https://backend.demo.taler.net/instances/sandbox/private/orders/"
...               + order_id + "/refund", json=refund_req,
...               headers={"Authorization": "Bearer secret-token:sandbox"})
<Response [200]>

注釈

払い戻しを許可した後、公開された https://example.com/orders/$ORDER_ID エンドポイントは、ウォレットのインタラクションを支払い要求から払い戻しの申し出に変更します。 従って、フロントエンドはブラウザを再びこのエンドポイントにリダイレクトすることができる。 しかし、そうするためには、h_contract フィールドを追加する必要があります(?h_contract=$H_CONTRACT)。 要求された $H_CONTRACT の値は、払い戻しレスポンスの h_contract フィールドの下に返されます。

3.1.4.6. その他のチュートリアル#

その他のチュートリアルを見るには、このサイトを閲覧するか、https://docs.taler.net、Talerサービスに関する最新のドキュメントを入手することができます。