# 支払い ユーザーが支払いを完了すると、エクソーラはpaymentタイプのウェブフックで決済詳細をウェブフックURLに送信します。 予想される応答コードについては、Responsesセクションでは、他の応答コードも使用できます： 応答コード 説明 200、201、204 成功応答。 4xx エラーが発生しました。たとえば、指定されたユーザーが見つからない場合や、無効な署名が渡された場合などです。 5xx 一時的なサーバーエラーです。この応答を受信すると、エクソーラはウェブフックの送信を自動的に再試行し、リスナーが受信を確認するまで試行間隔を徐々に長くします。最大再試行回数は48時間で12回です。 パブリッシャーアカウン トでウェブフックURLを保存すると、ウェブフックで追加情報を受信するように設定することもできます。 注意 2025年1月22日以前にパブリッシャーアカウントに登録した場合は、プロジェクトで設定 > ウェブフック > テスト > 決済ソリューション > 詳細設定セクションでトグルを見つけます。 トグル 説明 保存された決済アカウントに関する情報を表示する 保存された決済方法に関する情報は、payment_accountカスタムオブジェクト。 保存された決済方法による取引に関する情報を表示する 情報は、ウェブフックの以下のカスタムパラメータに渡されます：saved_payment_method:0 — 保存された決済方法は使用されませんでした1 — 決済方法は現在の支払い時に保存されました2 — 保存された決済方法は使用されませんでしたpayment_type:1 — 一回払い2 — 定期支払い 注文オブジェクトをウェブフックに追加する 注文に関する情報は、決済ウェブフックのorderオブジェクトに渡されます。 機密データは含まず、必要なユーザーパラメータのみを送信する ウェブフックでは、ユーザーに関する次の情報のみが渡されます：ID国 カードのBINとサフィックスを表示する ウェブフックには、銀行カード番号に関する以下の情報が渡されます：card_binパラメータの最初の6桁card_suffixパラメータの最後の4桁 カードブランドを表示する 決済に使用したカードのブランド。例えば、MastercardやVisaなど。 お知らせ ウェブフックで送信されるフィールドのセットは、以下によって異なります：パブリッシャーアカウントで構成された詳細設定エクソーラ側で構成されたカスタム設定ご質問がある場合は、カスタマーサクセスマネージャーを連絡して、またはcsm@xsolla.comまで電子メールを送信してお問い合わせください。 Endpoint: POST payment Version: 1.0 ## Request fields (application/json): - `custom_parameters` (object) カスタムパラメータ。 - `notification_type` (string, required) 通知タイプ。 - `payment_details` (object, required) 支払詳細（オブジェクト）。 - `payment_details.country_wht` (object) 国境を越えた取引により特定の国で適用される源泉徴収税（オブジェクト）。 - `payment_details.country_wht.amount` (number) 金額。 - `payment_details.country_wht.currency` (string) 通貨。[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)に基づく3文字の通貨コード。 - `payment_details.country_wht.percent` (number) 国別源泉徴収税率（%）。 - `payment_details.direct_wht` (object) 直接源泉徴収税。 - `payment_details.direct_wht.percent` (number) 直接源泉徴収税率。 - `payment_details.payment` (object) ユーザーが支払った金額（オブジェクト）。 - `payment_details.payment_method_fee` (object) 決済システム料金。 - `payment_details.payment_method_sum` (object) 決済システムから引き落とされた金額。 - `payment_details.payout` (object) ペイアウトの詳細（オブジェクト）。 - `payment_details.payout_currency_rate` (string) 決済とペイアウトの通貨間の為替レート。 - `payment_details.repatriation_commission` (object) 第三者によってエクソーラに課される送金コストに関するデータを含むオブジェクト - `payment_details.sales_tax` (object) 売上税（オブジェクト；米国とカナダのみ）。 - `payment_details.sales_tax.percent` (number) 売上税率。 - `payment_details.user_acquisition_fee` (object) アフィリエイトネットワークおよびインフルエンサー経由の購入に適用された顧客獲得料の合計額 （オブジェクト）。 - `payment_details.user_acquisition_fee.percent` (number) 顧客獲得料率（%）。 - `payment_details.vat` (object) VATの詳細（オブジェクト；EUのみ）。 - `payment_details.vat.percent` (number) VAT率。 - `payment_details.xsolla_balance_sum` (object) エクソーラ残高から引き落とされた金額。 - `payment_details.xsolla_fee` (object) エクソーラ手数料（オブジェクト）。 - `purchase` (object) 購入詳細（オブジェクト）。 - `purchase.checkout` (object) チェックアウト詳細（オブジェクト）。 - `purchase.checkout.amount` (number) 購入金額。 - `purchase.coupon` (object) クーポン詳細（オブジェクト; サブスクリプション作成時にクーポンが使用された場合）。 - `purchase.coupon.campaign_code` (string) キャンペーンコード。 - `purchase.coupon.coupon_code` (string) クーポンコード。 - `purchase.gift` (object) ギフト詳細（オブジェクト）。 - `purchase.gift.giver_id` (string) 贈り主ID。 - `purchase.gift.hide_giver_from_receiver` (string) 受取人から贈り主の身元を非表示にするかどうか。 - `purchase.gift.message` (string) 贈り主からのメッセージ。 - `purchase.gift.receiver_email` (string) ギフト受取人のメールアドレス。 - `purchase.gift.receiver_id` (string) ギフト受取人ID。 - `purchase.order` (object) 注文に関する情報を含むオブジェクト。この情報を受け取るには、プロジェクト設定 > ウェブフック > 高度な設定セクションでの[アドミンページ](https://publisher.xsolla.com/)で注文オブジェクトをウェブフックに追加するトグルをオンに設定します。 - `purchase.order.id` (integer) 注文ID。 - `purchase.order.lineitems` (array) アイテムに関する情報を含むパラメータの配列。 - `purchase.order.lineitems.price` (object) アイテム価格に関する情報を含むオブジェクト。 - `purchase.order.lineitems.price.amount` (number) 選択した通貨でのアイテムの合計価格。 - `purchase.order.lineitems.price.currency` (string) アイテム価格の通貨。 - `purchase.order.lineitems.quantity` (integer) アイテム数量。 - `purchase.order.lineitems.sku` (string) アイテムSKU。 - `purchase.promotions` (array) このトランザクションに適用されるプロモーション。 - `purchase.promotions.id` (integer) プロモーションID。 - `purchase.promotions.technical_name` (string) プロモーションの技術名称。 - `purchase.subscription` (object) サブスクリプション詳細（オブジェクト）。 - `purchase.subscription.amount` (number) 現金通貨での価格。 - `purchase.subscription.date_create` (string) サブスクリプション作成日。日付時刻表記は、[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)形式。 - `purchase.subscription.date_next_charge` (string) 次回の請求日。[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)に基づく日付と時刻。 - `purchase.subscription.plan_id` (string) プランID（プランがAPIを使用して作成された場合は外部）。 - `purchase.subscription.product_id` (string) 製品ID（アクセストークンで送信された場合）。 - `purchase.subscription.subscription_id` (integer) エクソラデータベースのサブスクリプションID。 - `purchase.subscription.tags` (array) プランのタグ。 - `purchase.total` (object, required) 購入の合計価格（オブジェクト）。 - `purchase.total.amount` (number) 総支払額。 - `settings` (object) カスタムプロジェクト設定（オブジェクト）。 - `settings.merchant_id` (integer) マーチャントID。 - `settings.project_id` (integer) プロジェクトID。このパラメータは、[ドメインページ](https://publisher.xsolla.com/)のプロジェクト名の横にあります。 - `transaction` (object, required) トランザクションの詳細（オブジェクト）。 - `transaction.agreement` (integer) 契約ID。 - `transaction.dry_run` (integer) テストトランザクション。テストトランザクションの場合は値が1になり、実際の取引の場合は送信されません。 - `transaction.external_id` (string) 取引external ID。詳細について[よくある質問](/ja/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id)を参照してください。 - `transaction.id` (integer) トランザクションID。 - `transaction.payment_date` (string) 支払日。 - `transaction.payment_method` (integer) 決済方法ID。 - `transaction.payment_method_name` (string) 決済方法の名称。 - `transaction.payment_method_order_id` (string) 決済システムの決済ID。 - `user` (object) ユーザー詳細（オブジェクト）。 - `user.country` (string) ユーザーの国。2文字の国コード（大文字）は、[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)に従って使用されます。 - `user.email` (string) ユーザーのEメール。 - `user.id` (string, required) ユーザーID。 - `user.ip` (string) ユーザーIP。 - `user.name` (string) ユーザー名。 - `user.phone` (string) ユーザーの電話。 - `user.zip` (string) Zipまたは郵便番号。 ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields