Xsolla-logo

Von gespeichertem Konto abbuchenServer-side

post/projects/{project_id}/users/{user_id}/payments/{type}/{account_id}

Von einem gespeicherten Zahlungskonto des Benutzers abbuchen.

Hinweis

In der Testumgebung funktioniert dieser API-Aufruf nur mit Testkarten ohne "3-D Secure"-Funktion.

Hinweis

Damit der API-Aufurf korrekt funktioniert, müssen Sie einen Timeout von 2 Minuten konfigurieren.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

Projekt-ID.

user_id
required
string

Die bei Ihnen gespeicherte eindeutige Benutzer-ID im Spiel. Stellen Sie sicher, dass Sie die vorhandene Benutzer-ID übermitteln. Falls ein Fehler auftritt, lesen Sie die FAQ.

type
required
string

Zahlungskontotyp.

Enum: Description
alipayplus_boost

Boost.

alipayplus_cn

Alipay.

alipayplus_dana

DANA.

alipayplus_gcash

GCash.

alipayplus_hk

Alipay (Hongkong).

alipayplus_rabbitlinepay

Rabbit LINE pay.

alipayplus_tng

Touch 'n Go.

alipayplus_truemoney

TrueMoney Wallet.

amazon

Amazon Pay.

card

Bankkarten.

klarna

Klarna. Das Speichern der Kontodaten ist nur in den USA, im Vereinigten Königreich, in Schweden, in Deutschland, in Österreich, in Norwegen, in Finnland, in Dänemark und in den Niederlanden möglich.

paypal

PayPal.

paysafecard_eu

Paysafecard (EU).

paysafecard_us

Paysafecard (USA).

skrill

Skrill Digital Wallet.

softbank_paypay

PayPay.

toss

Toss Wallet.

account_id
required
integer

ID des gespeicherten Kontos in der Xsolla-Datenbank.

Request Body schema: application/json
object

Dieses Objekt enthält Parameter für die Konfiguration von Betrugsschutzfiltern. Die Liste der Parameter ist unten aufgeführt. Wenn Sie benutzerdefinierte Parameter hinzufügen möchten, wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.

active_date
string

Letztmalig online; Datum gemäß ISO 8601.

additional_verification
boolean

Filtert danach, ob der Spieler Konto-Verifikationsverfahren verwendet.

character_customized
boolean

Filtert danach, ob der Spieler seinen Charakter individuell angepasst hat.

chat_activity
boolean

Filtert danach, ob der Spieler die Chatfunktion verwendet.

completed_tasks
integer

Anzahl der erledigten Aufgaben bzw. erreichten Ziele.

forum_activity
boolean

Filtert danach, ob der Spieler die Chatfunktion verwendet.

items_used
boolean

Filtert danach, ob der Spieler im Spiel gekaufte Gegenstände verwendet.

karma_points
integer

Karma des Spielers.

last_change_password_date
string

Datum der letzten Kennwortänderung; Datumsangabe gemäß ISO 8601.

non_premium_currency
number <float>

Betrag der gewöhnlichen ("non-premium") Währung.

notifications_enabled
boolean

Filtert danach, ob der Spieler den Erhalt von Benachrichtigungen aktiviert hat.

profile_completed
boolean

Filtert danach, ob der Spieler auf seinem Profil zusätzliche Informationen hinzugefügt hat.

profile_image_added
boolean

Filtert danach, ob der Spieler ein Profilbild hochgeladen hat.

pvp_activity
boolean

Filtert danach, ob der Spieler an PvP-Schlachten teilnimmt.

registration_date
string

Datum der Kontoerstellung gemäß ISO 8601.

session_time
string

Durchschnittliche Sitzungsdauer, Angabe gemäß ISO 8601.

social_networks_added
boolean

Filtert danach, ob der Spieler Profile von sozialen Netzwerken verknüpft hat.

total_bans
integer

Filtert danach, wie oft der Spieler im Chat/Forum gesperrt wurde.

total_characters
integer

Anzahl der Charaktere im Spiel.

total_clans
integer

Anzahl der Clans, bei denen der Spieler Mitglied ist.

total_friends
integer

Anzahl der Freunde.

total_game_events
integer

Anzahl der Ingame-Events, an denen der Spieler teilgenommen hat.

total_gifts
integer

Anzahl der Geschenke im Spiel, die der Spieler verschickt/erhalten hat.

total_hours
integer

Gesamtzahl der Spielstunden.

total_inventory_value
number <float>

Gesamtwert des Inventars (in Ingame-Währung).

total_sum
number <float>

Gesamtbetrag der Zahlungen.

tutorial_completed
boolean

Filtert danach, ob der Spieler das Tutorial des Spiels absolviert hat.

unlocked_achievements
integer

Anzahl an freigeschalteten Errungenschaften.

user_level
integer

Level, Ansehen oder Rang des Spielers.

win_rate
integer

Gewinnquote.

object

Objekt, welches Angaben zum Kauf enthält.

object

Objekt, welches Angaben zur Bezahlung enthält.

amount
number <float>

Kaufbetrag.

currency
string

Kaufwährung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object <= 4000 characters
value
string
object

Objekt, welches Angaben zur virtuellen Währung enthält.

quantity
number <float>

Kaufbetrag in der virtuellen Währung.

object

Objekt, welches die Einstellungen für den Kauf enthält.

currency
string

Bevorzugte Zahlungswährung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

external_id
string

Transaktions-ID im Spiel. Muss für jede Benutzerzahlung eindeutig sein. Detaillierte Informationen dazu finden Sie in der Dokumentation.

mock_code
integer

Ein zu reproduzierender Fehlercode beim Testen des Zahlungsvorgangs über PayPal in der Testumgebung. Funktioniert nur korrekt, wenn Sie den Parameter "mode":"sandbox" übermitteln.

Enum: 1057 1015 3006 1801 1803 1039 3031 1203 3006 1201 1002 1089 2031 1046 5004
mode
string

Legen Sie als Wert sandbox fest, um den Zahlungsvorgang auszutesten. Entfernen Sie den Parameter für tatsächliche Zahlungen.

object

Benutzerdaten (Objekt).

ip
required
string

IP-Adresse des Benutzers.

object

Objekt mit Angaben zur juristischen Person.

address
string

Vollständige Unternehmensanschrift.

country
string

Land des Unternehmenssitzes. Ländercode, bestehend aus 2 Großbuchstaben gemäß ISO 3166-1 ALPHA-2.

name
string

Vollständiger Name des Unternehmens.

vat_id
string

Steuerliche Identifikationsnummer.

name
string

Benutzername.

Responses
201

Created.

422

Unprocessable Entity.

Request samples
application/json
{
  • "purchase": {
    },
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "transaction_id": 123458390
}