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

Définir les paramètres de Refund Saver

Définir la préférence de remboursement individuellement pour l'utilisateur et enregistrer si l'utilisateur a donné son consentement au partage de ses données. Par défaut, Refund Saver demande toujours à Apple de refuser la demande de remboursement d'un utilisateur. Vous pouvez modifier ce comportement par défaut pour tous les utilisateurs dans l'Adapty Dashboard, ou l'ajuster pour un utilisateur spécifique via le Dashboard, le SDK Adapty ou l'API côté serveur.

Header parameters

adapty-customer-user-idstring

L'identifiant unique du client dans votre système. adapty-customer-user-id ou adapty-profile-id est requis.

adapty-profile-idstring · uuid

L'identifiant unique du profil dans votre système. Meilleure option si vous travaillez avec des profils anonymes. adapty-customer-user-id ou adapty-profile-id est requis.

Request body

custom_preferencestring

Définir la préférence de remboursement individuellement pour l'utilisateur. - grant : approuver chaque demande de remboursement - no_preference : ne fournir aucune recommandation - decline : refuser chaque demande de remboursement

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

consentboolean

Enregistrer si l'utilisateur a donné son consentement au partage de ses données. - true signifie que si vous recevez une demande de remboursement intégré à l'application, vous pouvez fournir à Apple des informations sur l'utilisateur

Responses

Paramètres mis à jour avec succès

Schema

profile_idstringrequired

Identifiant du profil client

settingsobjectrequired

Paramètres Refund Saver pour l'utilisateur

consentboolean

Indique si l'utilisateur a consenti au partage de ses données

custom_preferencestring

La préférence de remboursement

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

Example

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

Requête incorrecte

Schema

errorsarray of objectrequired

sourcestring

Source de l'erreur

errorsarray of string

Tableau de messages d'erreur

error_codestringrequired

Nom court de l'erreur

status_codeintegerrequired

Code de statut HTTP

Example

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

Non autorisé

Schema

errorsarray of objectrequired

sourcestring

Source de l'erreur

errorsarray of string

Tableau de messages d'erreur

error_codestringrequired

Nom court de l'erreur

status_codeintegerrequired

Code de statut HTTP

Example

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

Erreur interne du serveur

Schema

errorsarray of objectrequired

sourcestring

Source de l'erreur

errorsarray of string

Tableau de messages d'erreur

error_codestringrequired

Nom court de l'erreur

status_codeintegerrequired

Code de statut HTTP

Try it

Authorization

Header parameters

adapty-customer-user-id

adapty-profile-id

Body

curl --request POST \
  --url 'https://api.adapty.io/api/v2/server-side-api/purchase/profile/refund-saver/settings/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "custom_preference": "grant",
    "consent": true
  }'

const response = await fetch('https://api.adapty.io/api/v2/server-side-api/purchase/profile/refund-saver/settings/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "custom_preference": "grant",
    "consent": true
  }),
});
const data = await response.json();

import requests

response = requests.post('https://api.adapty.io/api/v2/server-side-api/purchase/profile/refund-saver/settings/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
}, json={
      "custom_preference": "grant",
      "consent": True
    })
data = response.json()