エクソーラは、次の条件が満たされると、指定されたURLにorder_paid
ウェブフックを送信します:
payment
ウェブフックの正常な処理に関する応答を受け
取りました。order_paid
ウェブフックには、購入したアイテムとトランザクションの詳細に関する情報が含まれています。
以下の場合、order_paid
ウェブフックは送信されません:
payment
ウェブフックの正常な処理に関する応答が受信されていません
。order_paid
ウェブフックの処理速度は3秒未満にすることをお勧めします。
予想される回答は、「応答」セクションに記載されています。他の応答コードを使用できます。応答コードと自動返金機能の接続に応じて、エクソーラ側のウェブ フック処理ロジックは以下のようになります:
応対コード | 自動返金は無効になっています(デフォルト) | 自動返金が有効になっています |
---|---|---|
400 、401 、402 、403 、404 、409 、422 、415 |
操作なし | ユーザーへの自動返金 |
200 、201 、204 |
操作なし | 操作なし |
別のコードまたはウェブフックへの応答なし | 指定された時間間隔内に複数のウェブフックが送信されます。5分間隔で2回、15分間隔で7回、60分間隔で10回試行されます。 | 指定された時間間隔内に複数のウェブフックが送信されます。5分間隔で2回、15分間隔で7回、60分間隔で10回試行されます。すべてのウェブフックが送信されても正常な応答が受信されない場合、ユーザーに自動返金が発行されます。 |
自動返金機能を接続するには、プロジェクトのアカウントマネージャーに連絡するか、am@xsolla.comまでお問い合わせください。
notification_type required | string 通知タイプ。 | ||||||||||||||||||||||||||||||||||||||
required | Array of objects ユーザーが購入したアイテムのリスト。 | ||||||||||||||||||||||||||||||||||||||
Array | |||||||||||||||||||||||||||||||||||||||
required | object 注文に関する情報。 | ||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
required | object ユーザー情報。 | ||||||||||||||||||||||||||||||||||||||
custom_parameters | object 追加情報。 |
処理の成功を示すために戻ります。
提供された情報(たとえば、必要なパラメーターの欠落、認可の失敗など。)にエラーが発生した場合に戻ります。
curl -v 'https://your.hostname/your/uri' \ -X POST \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -H 'Authorization: Signature d09695066c52c1b8bdae92f2d6eb59f5b5f89843' \ -d '{ "notification_type": "order_paid", "items": [ { "sku": "virtual-good-item_test", "type": "virtual_good", "is_pre_order": false, "quantity": 3, "amount": "1000", "promotions": [ { "amount_without_discount": "6000", "amount_with_discount": "5000", "sequence": 1 }, { "amount_without_discount": "5000", "amount_with_discount": "4000", "sequence": 2 } ], "custom_attributes": { "purchased": 0, "attr": "value" } }, { "sku": "virtual-good-item_test_test_new", "type": "bundle", "is_pre_order": false, "quantity": 1, "amount": "1000", "promotions": [] }, { "sku": "gold", "type": "virtual_currency", "is_pre_order": false, "quantity": 1500, "amount": "[null]", "promotions": [] } ], "order": { "id": 1, "mode": "default", "currency_type": "virtual", "currency": "sku_currency", "amount": "2000", "status": "paid", "platform": "xsolla", "comment": null, "invoice_id": "1", "promotions": [ { "amount_without_discount": "4000", "amount_with_discount": "2000", "sequence": 1 } ], "promocodes": [ { "code": "promocode_some_code", "external_id": "promocode_sku" } ], "coupons": [ { "code": "WINTER2021", "external_id": "coupon_sku" } ] }, "user": { "external_id": "id_xsolla_login_1", "email": "gc_user@xsolla.com" } }'