Xsolla-logo

異議申立Webhook POST

新しい異議申立が行われ、または異議申立のステータスが変更された時、エクソーラは「dispute」タイプのウェブフックをウェブフックURLに送信します。このウェブフックを受信するには、カスタマーサクセスマネージャーにご連絡いただくか、csm@xsolla.comまで電子メールでお問い合わせください。

Request
Request Body schema: application/json
notification_type
required
string

通知タイプ。

action
required
string

アクションのタイプ。

Enum: Description
adding

新しい異議申立が行われました。

updating

異議申立のステータスが変更されました。

required
object

トランザクションに関する情報を含むオブジェクト。

id
required
integer

トランザクションID。

date_create
required
string

支払日。

required
object

異議申立に関する情報を含むオブジェクト。

amount
required
number <float>

支払金額。

currency
required
string

通貨。ISO 4217に基づく3文字の通貨コード。

payment_method
required
string

決済方法。

Enum: Description
credit_debit_card

クレジットカードまたはデビットカード

paypal

PayPal

country_code
required
string

ユーザーの国。2文字の国コード(大文字)は、ISO 3166-1 alpha-2に従って使用されます。

external_id
string

取引external ID。詳細についてよくある質問を参照してください。

required
object

カスタムプロジェクト設定に関する情報を含むオブジェクト。

project_id
required
integer

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

merchant_id
required
integer

マーチャントID。

required
object

ユーザーに関する情報を含むオブジェクト。

id
required
string

ユーザーID。

email
string

ユーザーのEメール。

required
object

異議申立に関する情報を含むオブジェクト。

incoming_date
required
string

RFC 3339標準に基づく紛争の開始日。

reason
required
string

紛争手続きを開始する理由。理由のグループの説明については、ドキュメンテーション を参照してください。

Enum: "non_receipt" "not_as_described" "duplicate_processing" "paid_by_other_means" "incorrect_amount" "credit_not_processed" "general" "fraud" "cancelled_recurring" "cancelled_merchandise" "late_presentment" "no_authorization" "problem_with_remittance" "other"
type
required
string

紛争のタイプ。

Enum: Description
1st_time_chargeback

1回目のチャージバック。

2nd_time_chargeback

2 回目のチャージバック(事前仲裁)。

arbitration

1 回目のチャージバックと 2 回目のチャージバックが拒否された場合の発行銀行とマーチャントの間の紛争を解決します。

chargeback

1回目のチャージバック。

chargeback_reversal

チャージバックは取り消されました。

claim

PayPal における顧客とマーチャント間の紛争。

dispute

カード所有者が銀行に支払いの詳細を要求しました。

inquiry

カード所有者が銀行に支払いの詳細を要求しました。

other

他のタイプでカバーされていないチャージバックタイプに使用されます。

reimbursement

返金が行われました。

reimbursement_reversal

チャージバックは取り消されました。

representment

チャージバック管理チームは証拠を決済システムに送信しました。

representment_reversal

チャージバックは取り消されました。

retrieval

カード所有者が銀行に支払いの詳細を要求しました。

status
required
string

紛争の状況。

Enum: Description
accepted

承認済み

lost

負ける

new

新規

no_actions_required

進行中

won

勝つ

Responses
204

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

400

提供された情報(たとえば、必要なパラメーターの欠落、認可の失敗など。)にエラーが発生した場合に戻ります。

500

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

Request samples
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Authorization: Signature 32c64a80d2527dc08906ae1891bac4489509b9f6' \
-d '{
  "notification_type": "dispute",
  "action": "adding",
  "transaction": {
    "id": 123456789,
    "date_create": "2023-08-24T10:21:00+04:00",
    "total": {
      "amount": 1,
      "currency": "EUR"
    },
    "payment_method": "credit_debit_card"
  },
  "settings": {
    "project_id": 18404,
    "merchant_id": 2340
  },
  "user": {
    "id": "1234567",
    "email": "email@example.com",
    "country_code": "US"
  },
  "dispute": {
    "incoming_date": "2024-01-25T01:02:03+04:00",
    "reason": "not_as_described",
    "type": "retrieval",
    "status": "new"
  }
}'
Response samples
application/json
{
  • "error": {
    }
}