POST /api/v2/server-side-api/purchase/profile/refund-saver/settings/

Refund Saver の設定を行う

ユーザーごとに返金設定を個別に設定し、ユーザーがデータ共有に同意したかどうかを記録します。デフォルトでは、Refund Saver は常に Apple にユーザーの返金リクエストを拒否するよう求めます。Adapty ダッシュボードですべてのユーザーに対してこのデフォルト動作を変更するか、ダッシュボード・Adapty SDK・またはサーバーサイド API を使用して特定のユーザー向けに調整できます。

Header parameters

adapty-customer-user-idstring

お客様のシステムにおける顧客の一意の ID です。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。

adapty-profile-idstring · uuid

お客様のシステムにおけるプロファイルの一意の ID です。匿名プロファイルを扱う場合に最適です。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。

Request body

custom_preferencestring

ユーザーごとに返金設定を個別に指定します。 - grant: 各返金リクエストを承認する - no_preference: 推奨を提供しない - decline: 各返金リクエストを拒否する

One of: "grant", "no_preference", "decline"

consentboolean

ユーザーがデータ共有に同意したかどうかを記録します。 - true は、アプリ内返金リクエストを受け取った場合に Apple にユーザー情報を提供できることを意味します

Responses

設定が正常に更新されました

Schema
profile_idstringrequired

顧客プロファイル ID

settingsobjectrequired

ユーザーの Refund Saver 設定

consentboolean

ユーザーがデータ共有に同意したかどうかを示します

custom_preferencestring

返金設定

One of: "grant", "no_preference", "decline"

Example
{
  "profile_id": "e5aab402-b1bd-4039-b632-57a91ebc0779",
  "settings": {
    "consent": true,
    "custom_preference": "grant"
  }
}

リクエストが不正です

Schema
errorsarray of objectrequired
sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

Example
{
  "errors": [
    "Profile does not exist"
  ],
  "error_code": "profile_does_not_exist",
  "status_code": 400
}

認証エラー

Schema
errorsarray of objectrequired
sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

Example
{
  "errors": [
    "Invalid API key"
  ],
  "error_code": "unauthorized",
  "status_code": 401
}

内部サーバーエラー

Schema
errorsarray of objectrequired
sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード