$request = array(
     'notification_type' => 'refund',
 'purchase' => array(
         'virtual_currency' => array(
             'name' => 'Coins',
             'quantity' => 100,
 'currency' => 'USD',
 'amount' => 9.99
 ),
 'total' => array(
 'currency' => 'USD',
 'amount' => 9.99
 )
 ),
 'user' => array(
 'ip' => '127.0.0.1',
 'phone' => '18777976552',
 'email' => 'email@example.com',
         'id' => '1234567',
 'country' => 'US'
 ),
     'transaction' => array(
         'id' => 87654321,
         'payment_date' => '2014-09-23T19:25:25+04:00',
         'payment_method' => 1380,
         'dry_run' => 1
 ),
     'refund_details' => (
             'code' => 1,
             'reason' => 'Fraud'
 ),
     'payment_details' => array(
         'payment' => array(
 'currency' => 'USD',
 'amount' => 9.99
 ),
         'vat' => array(
 'currency' => 'USD',
 'amount' => 0
 ),
         'payout_currency_rate' => 1,
         'payout' => array(
 'currency' => 'USD',
 'amount' => 9.49
 ),
         'xsolla_fee' => array(
 'currency' => 'USD',
 'amount' => 0.19
 ),
         'payment_method_fee' => array(
 'currency' => 'USD',
 'amount' => 0.31
 )
 )
);

curl -v https://example.com/ \
-X POST \
-H 'Content-Type:application/json' \
-H 'Accept: application/json' \
-H 'Authorization:Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '
{
     "notification_type":"refund",
     "purchase":{
         "virtual_currency":{
             "name": "Coins",
             "quantity":10,
             "currency":"USD",
             "amount":100
 },
         "subscription":{
             "plan_id": "b5dac9c8",
             "subscription_id": "10",
             "date_create": "2014-09-22T19:25:25+04:00",
             "currency": "USD",
             "amount": 9.99
 },
         "checkout":{
             "currency":"USD",
             "amount":50
 },
         "virtual_items":{
             "items":[
 {
                     "sku": "test_item1",
                     "amount":1
 }
             ],
             "currency":"USD",
             "amount":50
 },
         "total":{
             "currency":"USD",
             "amount":200
 }
 },
 "user":{
 "ip":"127.0.0.1",
 "phone":"18777976552",
 "email":"email@example.com",
 "id":"1234567",
         "name": "Xsolla User",
 "country":"US"
 },
     "transaction":{
         "id":1,
         "external_id":1,
         "dry_run":1,
         "agreement":1
 },
     "refund_details":{
         "code":1,
         "reason":"Fraud"
 },
     "payment_details":{
         "xsolla_fee":{
             "currency":"USD",
             "amount":"10"
 },
         "payout":{
             "currency":"USD",
             "amount":"200"
 },
         "payment_method_fee":{
             "currency":"USD",
             "amount":"20"
 },
         "payment":{
             "currency":"USD",
            "amount":"230"
 }
 }
}'

パラメータの完全なリストは、API リファレンスで参照してください。

ウェブフックのテスト

ウェブフックハンドラーのテスト：

1. パブリッシャ―アカウントで、モジュールの設定を開く。
2. テスト タブに移動。
3. テストデータを入力してテストをクリック。Xsolla サーバーは送信可能なウェブフックをすべて送信。
4. 有効なリクエストの場合にはテストには緑の印が付き、エラーの場合には赤の印が付く。

開発者へのチップ

購入のごとにプロジェクトにチップが提供されます。この機能を有効にするには、モジュールを開き、料金タブで、Pay2play ウィジェットでチップの使用をオンにします。有効な通貨ごとにチップの金額オプションが3つ利用できます。

ユーザーはストアに入る前に、提供するチップの金額を選択できます。チップの金額は購入金額に追加されます。

プレオーダー数の限定

すべてのプロジェクトでプレオーダーの数を制限することができます。100件以下のプレオーダーが残っている場合、およびプレオーダーが残っていない場合に、次のEメール通知が届きます。ユーザーがプレオーダー制限を超過する場合、支払いは処理されません。

販売の地域制限

プレオーダーのモジュールでは、プレオーダーの販売に関する地域制限を設定することができます。特に以下を実行できます:

• 国ごとまたはグループ化した複数の国に異なる価格を設定する。
• 特定の国への販売を禁止する。

プロジェクトが適切に設定されると、制限対象国のユーザーがプレオーダーしようとすると、警告文が表示されます。プレオーダーが禁止された国では、決済は処理されません。

この機能を有効にするには、担当のアカウントマネージャーまでお問合せください。地域制限が適用される各プラットフォームの以下の情報が必要です:

• 制限の種類: 有効化：PIN コードは特定の国でのみ有効化できる。 発売開始：どの国でも PIN コードは有効化できるけれど、特定の国のみでゲームの発売を開始できる。 *有効化と発売開始:特定の国でのみ PIN コードを有効化し、ゲームを発売開始できる。
• プレオーダー価格が異なる国グループの一覧。
• 国のグループの設定: グループ名。 SKU - グループ固有の識別子。 様々な通貨での価格一覧。モジュール設定に規定されている、既定の通貨での価格を必ず含める。 各グループに含まれる国の一覧。
• プレオーダーが無効な国の一覧（存在する場合）。

どのプラットフォームでも、特定の国を異なる価格のグループまたはプレオーダー無効のグループのいずれかに含めることができます。国がどのグループにも含まれていない場合、プレオーダーを制限なしで、モジュール設定で規定された価格で利用することができます。

重要！ PIN コードの有効化およびゲームの開始があなた、またはプラットフォームにより実行される場合には、必ず、当社のシステムに PIN コードと地域制限をアップロードするようにしてください。