紛争

紛争Webhook POST

新しい紛争手続きが開かれると、エクソーラはdisputeタイプをウェブフックURLに送信します。このウェブフックを受信するには、カスタマーサクセスマネージャーにご連絡いただくか、csm@xsolla.comまで電子メールでお問い合わせください。

Request

Request Body schema: application/json

notification_type

required

string

通知タイプ。

action

required

string

アクションのタイプ。

Value: "adding"

required

object

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

required

integer

トランザクションID。

date_create

required

string

支払日。

required

object

紛争に関する情報を含むオブジェクト。

amount required	integer <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
HTTP

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": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}