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.

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.

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:

"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:

"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:

$ 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:

[
  {
  "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
  }
]

Diese Seite bewerten

Gibt es etwas, das wir verbessern können? Senden

Jetzt nicht

Vielen Dank für Ihr Feedback!