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:
- Konfigurieren Sie virtuelle Währungspakete, virtuelle Gegenstände, Spielschlüsselpakete oder Abonnements.
- 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.
- Implementieren Sie die Verarbeitung des Parameters
purchase.gift
im Webhook für den erfolgreichen Kauf. - 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:
- http
"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:
- http
"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:
- Stellen Sie sicher, dass eine Webhook-URL unter Kundenportal > Projekteinstellungen > Webhooks angegeben ist.
- Generieren Sie die Anfragesignatur.
- Stellen Sie während der Verarbeitung der API-Anfrage sicher, dass die generierte Signatur mit der im Parameter
sign
übergebenen Signatur übereinstimmen.
Anfragebeispiel:
- http
$ 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:
- http
[
{
"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?
Diese Seite bewerten
Jetzt nicht
Vielen Dank für Ihr Feedback!
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.