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

Đặt cài đặt Refund Saver

Đặt tùy chọn hoàn tiền riêng lẻ cho người dùng và ghi lại việc người dùng đã đồng ý chia sẻ dữ liệu của họ. Theo mặc định, Refund Saver luôn yêu cầu Apple từ chối yêu cầu hoàn tiền của người dùng. Bạn có thể thay đổi hành vi mặc định này cho tất cả người dùng trong Adapty Dashboard, hoặc điều chỉnh cho một người dùng cụ thể thông qua Dashboard, SDK, hoặc server-side API.

Header parameters

adapty-customer-user-idstring

ID duy nhất của khách hàng trong hệ thống của bạn. Cần cung cấp adapty-customer-user-id hoặc adapty-profile-id.

adapty-profile-idstring · uuid

ID duy nhất của hồ sơ người dùng trong hệ thống của bạn. Lựa chọn tốt nhất khi làm việc với hồ sơ ẩn danh. Cần cung cấp adapty-customer-user-id hoặc adapty-profile-id.

Request body

custom_preferencestring

Đặt tùy chọn hoàn tiền riêng lẻ cho người dùng. - grant: chấp thuận từng yêu cầu hoàn tiền - no_preference: không đưa ra khuyến nghị nào - decline: từ chối từng yêu cầu hoàn tiền

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

consentboolean

Ghi lại việc người dùng đã đồng ý chia sẻ dữ liệu của họ. - true có nghĩa là nếu bạn nhận được yêu cầu hoàn tiền trong ứng dụng, bạn có thể cung cấp thông tin về người dùng cho Apple

Responses

Cài đặt được cập nhật thành công

Schema
profile_idstringrequired

ID hồ sơ người dùng

settingsobjectrequired

Cài đặt Refund Saver cho người dùng

consentboolean

Xác định liệu người dùng có đồng ý chia sẻ dữ liệu của họ hay không

custom_preferencestring

Tùy chọn hoàn tiền

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

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

Yêu cầu không hợp lệ

Schema
errorsarray of objectrequired
sourcestring

Nguồn gốc lỗi

errorsarray of string

Mảng thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP

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

Không được phép

Schema
errorsarray of objectrequired
sourcestring

Nguồn gốc lỗi

errorsarray of string

Mảng thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP

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

Lỗi máy chủ nội bộ

Schema
errorsarray of objectrequired
sourcestring

Nguồn gốc lỗi

errorsarray of string

Mảng thông báo lỗi

error_codestringrequired

Tên lỗi rút gọn

status_codeintegerrequired

Mã trạng thái HTTP