Freund beschenken

So funktioniert's

Mit der Funktion können Benutzer virtuelle Währungspakete, virtuelle Gegenstände, Spielschlüssel oder Abonnements gegen echte Währung erwerben und diese an ihre Freunde im Spiel verschenken. Nach erfolgreicher Zahlung erhält der Geschenkgeber eine Quittung und der Beschenkte eine E-Mail mit näheren Angaben zum Geschenk. Der Geschenkgeber kann sich dafür entscheiden, seine Identität zu verbergen, um das Geschenk anonym zu versenden.

Note: Der Kauf von virtuellen Währungspaketen oder virtuellen Gegenständen als Geschenk ist nur bei Projekten möglich, bei denen die Nutzerdatenspeicherung bei Xsolla deaktiviert ist.

Für wen ist es

  • Partner, die Buy Button bereits integriert und das Modul "Virtuelle Gegenstände", "Virtuelle Währung" und/oder "Spielschlüssel" aktiviert haben.
  • Partner die das Modul Abonnements integriert haben.

Info: Diese Funktion ist nur in Projekten mit Checkout API (veraltet) verfügbar. Navigieren Sie zu Projekteinstellungen > Integration, und stellen Sie sicher, dass der Umschalter Commerce API integrieren auf Aus gestellt ist.

Wie komme ich dazu

So aktivieren Sie die Funktion:

  1. Konfigurieren Sie virtuelle Währungspakete, virtuelle Gegenstände, Spielschlüsselpakete oder Abonnements.
  2. Wählen Sie eine der folgenden Möglichkeiten für das Senden der Freundesliste aus, und implementieren Sie sie: über eine API-Methode oder über einen Token.
  3. Implementieren Sie die Verarbeitung des Parameters purchase.gift im Webhook für den erfolgreichen Kauf.
  4. Wenden Sie sich an Ihren Account Manager, um die Einrichtung abzuschließen.

Freundesliste via Token senden

Übermitteln Sie die Freundesliste des Benutzers als Parameter purchase.gift.friends in der Anfrage Token abrufen, damit ein Geschenkgeber den Empfänger aus der vorgeschlagenen Liste auswählen kann. Sorgen Sie dafür, dass die erhaltene Liste in Ihrer App angezeigt wird. Wenn die Liste nur einen Benutzer umfasst, wird dieser automatisch als Empfänger festgelegt.

Um Informationen über den Geschenkgeber hinzuzufügen, übermitteln Sie die Parameter purchase.gift.giver_id, purchase.gift.message und purchase.gift.hide_giver_from_receiver in der Anfrage für das Abrufen eines Tokens.

Beispielhafter Token für das Verschenken von virtueller Währung an einen Benutzer:

Copy
Full screen
Small screen
"purchase":{
   "virtual_currency":{
       "quantity":100
   },
   "description":{
       "value":"Test Purchase"
   },
   "gift":{
       "giver_id":"John Smith",
       "message":"GG WP",
       "hide_giver_from_receiver" : true,
       "friends": [
       {
        "id": "123",
        "name": "captain",
        "email": "captain@ship.com"
       }]
   }
}

Beispielhafter Token für das Verschenken eines Abonnements an einen Benutzer:

Copy
Full screen
Small screen
"purchase": {
  "gift": {
    "giver_id": "John Smith",
    "message": "GG WP",
    "hide_giver_from_receiver": true,
    "friends": [
    {
      "id": "123",
      "name": "captain",
      "email": "captain@ship.com"
    }
    ]
  }
}

Freundesliste über API-Anfrage übermitteln

Implementieren Sie die API für das Übermitteln der Freundesliste, und generieren Sie eine Signatur. So generieren Sie eine Signatur:

  1. Stellen Sie sicher, dass eine Webhook-URL unter Kundenportal > Projekteinstellungen > Webhooks angegeben ist.
  2. Generieren Sie die Anfragesignatur.
  3. Stellen Sie während der Verarbeitung der API-Anfrage sicher, dass die generierte Signatur mit der im Parameter sign übergebenen Signatur übereinstimmen.

Anfragebeispiel:

Copy
Full screen
Small screen
$ curl -v 'https://your.webhook.url?notification_type=friends_list&user=user_id&query=frien&offset=10&limit=20&sign=12dfg3f5gdsf4g5s6dfg2sdg1' \
-X GET \
-u merchant_id:merchant_api_key

Antwortbeispiel:

Copy
Full screen
Small screen
[
  {
  "friends": [
      {
        "id": "1",
        "name": "John Carter",
        "email": "carter@xsolla.com",
        "image_url": "https://partner/link/doctor.jpg"
      },
      {
        "id": "2",
        "name": "John Smith",
        "email": "smith@xsolla.com",
        "image_url": "https://partner/link/cook.jpg"
      }
    ],
  "total": 10
  }
]

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 27. April 2022

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.