POST
/api/v2/server-side-api/purchase/profile/refund-saver/settings/ 设置退款保护配置
为用户单独设置退款偏好并记录用户是否同意共享其数据。默认情况下，退款保护功能会请求 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：批准每笔退款请求
- grant_prorated：按用户尚未消费的购买比例批准退款
- no_preference：不提供任何建议
- decline：拒绝每笔退款请求
One of: "grant", "grant_prorated", "no_preference", "decline"
consentboolean
记录用户是否同意共享其数据。
- true 表示如果您收到应用内退款请求，可向 Apple 提供该用户的相关信息
Responses
设置更新成功
Schema
profile_idstringrequired
客户用户画像 ID
settingsobjectrequired
用户的退款保护设置
consentboolean
定义用户是否同意共享其数据
custom_preferencestring
退款偏好设置
One of: "grant", "grant_prorated", "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 状态码