支払いが拒否されました

Xsolla Developers

または

支払いが拒否されましたWebhook POST

決済システムによってトランザクションが拒否された場合、エクソーラは設定されたウェブフックURLに、ps_declinedタイプのウェブフックでトランザクションの詳細を送信します。このウェブフックは認証または支払い処理の段階で送信されます。この場合、payment\ order_paidウェブフックは送信されません。

決済システムで支払いが拒否される一般的な理由：

カードの認証が失敗した（例：技術的なエラーや銀行からの応答がないため、決済システムが認証プロセスを完了できなかった場合）または認証が拒否された（例：銀行からの応答があったものの、残高不足やカード情報の誤りなどにより取引を拒否した場合）。
3-Dセキュア認証が失敗した、完了しなかった、またはユーザーの確認がタイムアウトした場合。
決済処理業者または加盟店契約銀行が一時的に利用不能である、あるいは口座閉鎖や無効なカード番号といった不可逆的なエラーによる確定的な拒否（ハードディクライン）が返された場合。根本的な問題に対処せずに再試行しても、取引の成功にはつながりません。

以下と混同しないでください：

不正決済防止による拒否は、afs_rejectウェブフックで報告されます。
成功した支払い後の全額返金および一部返金（refundおよびpartial_refundウェブフックで報告されます）。

注意

ps_declinedウェブフックを受け取るには、担当のカスタマーサクセスマネージャーにご連絡いただくか、csm@xsolla.comまでメールでお問い合わせください。

Request

Request Body schema: application/json

notification_type

required

string

通知タイプ。

required

object

トランザクションの詳細（オブジェクト）。

dry_run	integer テストトランザクション。パラメータは、テストトランザクションの場合は1つの値を持ち、もしくはトランザクションが実際の場合は送信されません。
external_id	string トランザクション外部ID。
id	integer トランザクションID。
payment_method	integer 決済方法のID。

object

返金の詳細（オブジェクト）。

author

string

返金イニシエーター。フィールド値は、次の表に従って渡されます：

返金イニシエーター	フィールド値
ゲーム（API経由）。	API
パブリッシャーアカウントのユーザー（自動返金）。	ユーザーのメールアドレス
パブリッシャーアカウントユーザー（エクソラカスタマーサポートの支援を受けて)。	support@xsolla.com
エクソラ（エクソラカスタマーサポートの支援を受けて）。	support@xsolla.com

code

integer

コードID。

reason

string

返金の理由。

object

カスタムプロジェクト設定（オブジェクト）。

merchant_id	integer マーチャントID。
project_id	integer プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

object

ユーザーの詳細（オブジェクト）。

id required	string ユーザーID。
country	string ユーザーの国。2文字の国コード（大文字）は、ISO 3166-1 alpha-2に従って使用されます。
email	string ユーザーのEメール。
ip	string ユーザーIP。
name	string ユーザー名。

Responses

204

処理の成功を示すために戻ります。

400

提供された情報にエラーがある場合に返されます（例: 必須パラメータの欠落、認証の失敗など）。この場合、ユーザーのお金は引き落とされますが、購入は失敗します。返金を行うには、エクソーラカスタマーサポートsupport@xsolla.comにお問い合わせください。

500

リターンはサーバーに一時的なエラーが発生したことを示します。

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 80543ba63e1e50cf05f15150fe75e7245da9a898' \
-d '{
  "notification_type": "ps_declined",
  "settings": {
    "project_id": "18404",
    "merchant_id": "2340"
  },
  "user": {
    "ip": "127.0.0.1",
    "email": "email@example.com",
    "id": "1234567",
    "country": "US"
  },
  "transaction": {
    "id": "1",
    "dry_run": "1",
    "payment_method": "1"
  },
  "refund_details": {
    "author": "support@xsolla.com",
    "code": "8",
    "reason": "Cancellation by the PS request",
    "reason_detail": "Insufficient funds"
  }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}