# 払い戻し 支払いがキャンセルされると、エクソーラはキャンセルされた取引の詳細を、refundタイプのウェブフックとしてウェブフックURLに送信します。 ウェブフックの再試行メカニズムは、誰が返金を開始したかによって異なります： * 返金がお客様側で開始された場合、ウェブフックは再送されません。ウェブフックへの応答に関係なく、支払いはユーザーに返金されます。 * 返金がサードパーティ（例：決済システム、またはエクソーラカスタマーサポートチームなど）によって開始され、かつウェブフックへの応答として5xxステータスコード が返された場合、ウェブフックは間隔を空けながら再送されます。最大再試行回数は、最初の試行から48時間以内に12回です。 返金プロセスに関する詳細な情報は、こちらの説明.をご参照ください。 注意 以下の条件がすべて満たされている場合でも、支払いはユーザーに返金されます：返金はエクソーラによって開始されました。ウェーブフックに対する応答として、4xxステータスコードが返された、またはすべての再試行後に応答がなかった、あるいは5xxステータスコードが返された場合。 パブリッシャーアカウン トでウェブフックURLを保存すると、ウェブフックで追加情報を受信するように設定することもできます。 注意 2025年1月22日以前にパブリッシャーアカウントに登録した場合は、プロジェクトで設定 > ウェブフック > テスト > 決済ソリューション > 詳細設定セクションでトグルを見つけます。 トグル 説明 保存された決済方法による取引に関する情報を表示する 情報は、ウェブフックの以下のカスタムパラメータに渡されます：saved_payment_method:0 — 保存された決済方法は使用されませんでした1 — 決済方法は現在の支払い時に保存されました2 — 保存された決済方法は使用されませんでしたpayment_type:1 — 一回払い2 — 定期支払い 返金コード： コード 理由 説明 1 Cancellation by the user request / the game request パブリッシャーアカウントからキャンセルが開始されました。 2 Chargeback トランザクションのチャージバックが要求されました。 3 Integration error エクソラとゲームの統合に関する問題推奨事項：ブロックリストにユーザーを追加しません。 4 Potential fraud 不正の疑いがあります。推奨事項: ユーザーをブロックリストに追加してください。 5 Test payment テストトランザクション後にキャンセル処理が実行されます。推奨事項：ブロックリストにユーザーを追加しません。 6 User invoice expired 請求書の期限が切れました（後払いモデルで使用）。 7 Fraud notification from PS 決済システムで支払いが拒否されました。決済システムで不正の可能性が検出されました。推奨事項：ユーザーをブロックリストに追加してください。 8 Cancellation by the PS request 決済システムによってキャンセルが要求されました。推奨事項：ブロックリストにユーザーを追加しません。 9 Cancellation by the user request ユーザは何らかの理由でゲームや購入に満足していませんでした。推奨事項：ブロックリストにユーザーを追加しません。 10 Cancellation by the game request ゲームによってキャンセルが要求されました。推奨事項：ブロックリストにユーザーを追加しません。 11 Account holder called to report fraud アカウント所有者がトランザクションを行わなかったと述べています。 12 Friendly fraud フレンドリー詐欺が報告されました。 13 Duplicate 同じインボイスのトランザクションが重複しています。 Endpoint: POST refund Version: 1.0 ## Request fields (application/json): - `custom_parameters` (object) カスタムパラメータ。 - `notification_type` (string, required) 通知タイプ。 - `payment_details` (object, required) 支払明細（オブジェクト）。 - `payment_details.country_wht` (object) 国境を越えた取引により特定の国に課せられる源泉徴収税（オブジェクト）。 - `payment_details.country_wht.amount` (number) 金額。 - `payment_details.country_wht.currency` (string) 通貨。[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)に基づく3文字の通貨コード。 - `payment_details.country_wht.percent` (number) 直接源泉徴収税率（%）。 - `payment_details.direct_wht` (object) 直接源泉徴収税。 - `payment_details.direct_wht.percent` (number) 直接源泉徴収税率。 - `payment_details.payment` (object) ユーザー（オブジェクト）によって支払われた金額。 - `payment_details.payment_method_fee` (object) 決済システム料金。 - `payment_details.payment_method_sum` (object) 決済システムから振り込まれた金額。 - `payment_details.payout` (object) 配当の詳細（オブジェクト）。 - `payment_details.payout_currency_rate` (string) 決済と配当間の為替レート。 - `payment_details.repatriation_commission` (object) 本国送金費用のデータ付きオブジェクト。サードパーティがエクソラに課します。 - `payment_details.sales_tax` (object) 売上税（オブジェクト；米国とカナダのみ）。 - `payment_details.sales_tax.percent` (number) 消費税率。 - `payment_details.user_acquisition_fee` (object) アフィリエイトネットワークやインフルエンサー経由での購入から差し引かれた顧客獲得料の総額（オブジェクト）。 - `payment_details.user_acquisition_fee.percent` (number) 顧客獲得料率（%）。 - `payment_details.vat` (object) VATの詳細（オブジェクト；EUのみ）。 - `payment_details.xsolla_balance_sum` (object) エクソラの残高から振り込まれた金額。 - `payment_details.xsolla_fee` (object) エクソラ料金（オブジェクト）。 - `purchase` (object) 購入内容（オブジェクト）。 - `purchase.checkout` (object) チェックアウトの詳細（オブジェクト）。 - `purchase.checkout.amount` (number) 購入金額。 - `purchase.subscription` (object) サブスクリプションの詳細（オブジェクト）。 - `purchase.subscription.amount` (number) 現金通貨での価格。 - `purchase.subscription.date_create` (string) サブスクリプション作成日。日付時刻表記は、[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)形式。 - `purchase.subscription.plan_id` (string) プランID（プランがAPIを使用して作成された場合は外部）。 - `purchase.subscription.subscription_id` (integer) エクソラデータベースのサブスクリプションID。 - `purchase.subscription.tags` (array) プランのタグ。 - `purchase.total` (object, required) 購入（オブジェクト）の合計価格。 - `purchase.total.amount` (number) 支払額合計。 - `refund_details` (object) 返金の詳細（オブジェクト）。 - `refund_details.author` (string) 返金イニシエーター。フィールド値は、次の表に従って渡されます： 返金イニシエーター フィールド値 ゲーム（API経由）。 API パブリッシャーアカウントのユーザー（自動返金）。 ユーザーのメールアドレス パブリッシャー アカウント ユーザー（エクソラカスタマーサポートの支援を受けて)。 support@xsolla.com エクソラ（エクソラカスタマーサポートの支援を受けて）。 support@xsolla.com - `refund_details.code` (integer) コードID。 - `refund_details.reason` (string) 返金の理由。 - `settings` (object) カスタムプロジェクト設定（オブジェクト）。 - `settings.merchant_id` (integer) マーチャントID。 - `settings.project_id` (integer) プロジェクトID。このパラメータは、[ドメインページ](https://publisher.xsolla.com/)のプロジェクト名の横にあります。 - `transaction` (object, required) トランザクションの詳細（オブジェクト）。 - `transaction.agreement` (integer) 契約ID - `transaction.dry_run` (integer) テストトランザクション。パラメータは、テストトランザクションの場合は1つの値を持ち、もしくはトランザクションが実際の場合は送信されません。 - `transaction.external_id` (string) トランザクション外部ID。 - `transaction.id` (integer) トランザクションID。 - `transaction.payment_method_order_id` (string) 決済システムの決済ID。 - `user` (object) ユーザーの詳細（オブジェクト）。 - `user.country` (string) ユーザーの国。2文字の国コード（大文字）は、[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)に従って使用されます。 - `user.email` (string) ユーザーのEメール。 - `user.id` (string, required) ユーザーID。 - `user.ip` (string) ユーザーIP。 - `user.name` (string) ユーザー名。 - `user.phone` (string) ユーザーの電話。 - `user.zip` (string) Zipまたは郵便番号。 ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields