# 支払いが拒否されました 決済システムによってトランザクションが拒否された場合、エクソーラは設定されたウェブフックURLに、ps_declinedタイプのウェブフックでトランザクショ ンの詳細を送信します。このウェブフックは認証または支払い処理の段階で送信されます。この場合、payment\ order_paidウェブフックは送信されません。 決済システムで支払いが拒否される一般的な理由： * カードの認証が失敗した（例：技術的なエラーや銀行からの応答がないため、決済システムが認証プロセスを完了できなかった場合）または認証が拒否された（例：銀行からの応 答があったものの、残高不足やカード情報の誤りなどにより取引を拒否した場合）。 * 3-Dセキュア認証が失敗した、完了しなかった、またはユーザーの確認がタイムアウトした場合。 * 決済処理業者または加盟店契約銀行が一時的に利用不能である、あるいは口座閉鎖や無効なカード番号といった不可逆的なエラーによる確定的な拒否（ハードディクライン）が返 された場合。根本的な問題に対処せずに再試行しても、取引の成功にはつながりません。 以下と混同しないでください： * 不正決済防止による拒否は、afs_rejectウェブフックで報告されます。 * 成功した支払い後の全額返金および一部返金（refundおよびpartial_refundウェブフックで報告されます）。 注意 ps_declinedウェブフックを受け取るには、担当のカスタマーサクセスマネージャーにご連絡いただくか、csm@xsolla.comまでメールでお問い合わせください。 Endpoint: POST payment-declined Version: 1.0 ## Request fields (application/json): - `notification_type` (string, required) 通知タイプ。 - `refund_details` (object) 返金の詳細（オブジェクト）。 - `refund_details.author` (string) 返金イニシエーター。フィールド値は、次の表に従って渡されます： 返金イニシエーター フィールド値 ゲーム（API経由）。 API パブリッシャーアカウントのユーザー（自動返金）。 ユーザーのメールアドレス パブリッシャー アカウント ユーザー（エクソラカスタマーサポートの支援を受けて)。 support@xsolla.com エクソラ（エクソラカスタマーサポートの支援を受けて）。 support@xsolla.com - `refund_details.code` (integer) コードID。 コード 理由 説明 1 Cancellation by the user request / the game request パブリッシャーアカウントからキャンセルが開始されました。 2 Chargeback トランザクションのチャージバックが要求されました。 3 Integration error エクソラとゲームの統合に関する問題推奨事項：ブロックリストにユーザーを追加しません。 4 Potential fraud – AFS reject エクソーラの不正決済防止システムが不正の可能性を検知したため、トランザクションが拒否されました。 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 Potential fraud – friendly fraud 正当なカード所有者が、自身のトランザクションに対して異議申し立てを行いました。 13 Duplicate 同じインボイスのトランザクションが重複しています。 21 Potential fraud – BIN attack 1つまたは複数のBINから盗まれたカードのバッチ。主な指標は、短期間のうちに特定のBIN範囲を共有する試行が急増することであり、多くの場合、列挙されたカード番号が含まれます。 22 Potential fraud – monetization fraud 盗まれたカードを使用して、転売を目的とした取引可能アイテムを購入しました。 23 Potential fraud – low-scale card fraud 1つまたは複数のBINから盗まれたカード。BIN攻撃ほど広範囲かつ組織的なものではありません（返金コード21）。 24 Potential fraud – regional price abuse 地域別価格の悪用、またはキーの転売の不正行為。ユーザーが場所や決済方法を偽装して地域別価格を悪用し、安価にアイテムを入手して、より高価な市場で転売する行為。 25 Potential fraud – partner or PS exploit 認証情報の窃取およびアカウントの乗っ取り。カードの直接的な不正利用ではなく、パートナー側または決済システムの合意アカウントや統合設定を悪用した行為。 26 Potential fraud – not definable 不正行為が確認されたが、正確な攻撃タイプを特定するための証拠が不十分なもの。 27 Fraud notification from PS – linked transactions 決済システムの不正報告において、当該トランザクション自体は指定されていなかったが、共有のカードやデバイスを介して、不正行為に関連する理由で返金されたトランザクションと関連があるもの。 - `refund_details.reason` (string) 返金の理由。 - `settings` (object) カスタムプロジェクト設定（オブジェクト）。 - `settings.merchant_id` (integer) マーチャントID。 - `settings.project_id` (integer) プロジェクトID。このパラメータは、[ドメインページ](https://publisher.xsolla.com/)のプロジェクト名の横にあります。 - `transaction` (object, required) トランザクションの詳細（オブジェクト）。 - `transaction.dry_run` (integer) テストトランザクション。パラメータは、テストトランザクションの場合は1つの値を持ち、もしくはトランザクションが実際の場合は送信されません。 - `transaction.external_id` (string) トランザクション外部ID。 - `transaction.id` (integer) トランザクションID。 - `transaction.payment_method` (integer) 決済方法の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) ユーザー名。 ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields