Graph API-Version

Zahlung `/{payment-id}`

Die Details einer Zahlung, die in einer App mithilfe von Facebook Payments getätigt wurde.

Lesen

GET /v21.0/{payment-id} HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{payment-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{payment-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{payment-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Berechtigungen

Für die App, die die Zahlung erstellt hat, ist ein App-Zugriffsschlüssel erforderlich.

Felder

Name	Beschreibung	Typ
`id`	Zahlungs-ID	`string`
`user`	Vor- und Nachname des Verbrauchers zusammen mit dessen Nutzungs- `id`. Kann in bestimmten Fällen weggelassen werden.	`User`
`request_id`	Die eindeutige, optionale ID, die von der App erstellt und an die JS-Funktion übergeben wird (max. 255 Zeichen)	`string`
`application`	Mit dieser Zahlung verknüpfte	`App`
`actions`	Liste der verschiedenen Aktionsarten, die bei dieser Zahlung aufgetreten sind	object[]
`type`	Der Typ der jeweiligen Aktion. `type` kann sein: `charge`: Dies gibt an, dass die Art der Aktion für diese Zahlung eine Belastung war. Wenn die Zahlung abgeschlossen ist, solltest du die Bestellung erfüllen. `refund`: Der Rückerstattungstyp gibt an, dass die Zahlung erstattet wurde und der an dendie Verbraucherinnen verkaufte Artikel nach Möglichkeit zurückerlangt werden sollte, da du für diese Transaktion keine Auszahlung erhältst. `chargeback`: Von einemeiner Verbraucherin wurde eine Rückbuchung eingeleitet, wobei dessenderen Bank die betreffende Zahlung anfechtet. Bei einer Rückbuchung solltest du den Artikel im Spiel nach Möglichkeit vomvon der Verbraucherin zurückerlangen, da du für diese Bestellung keine Auszahlung erhältst. `chargeback_reversal`: Eine Stornierung einer Rückbuchung liegt dann vor, wenn eine Rückbuchung im Nachhinein zurückgenommen wird. In diesem Fall solltest du den Artikel desder Verbraucherin im Spiel nach Möglichkeit wieder bereitstellen, da du jetzt eine Auszahlung für diese Zahlung erhältst. `decline`: Eine Ablehnung liegt dann vor, wenn eine Finanzierungsquelle, die zur Erstellung einer zusammengefassten Transaktion verwendet wurde, im Moment der Zahlungsverarbeitung abgelehnt wird. Du solltest den Artikel im Spiel nach Möglichkeit vomvon der Verbraucher*in zurückerlangen, da du für diese Bestellung keine Auszahlung erhältst. Weitere Informationen zu zusammengefassten Transaktionen und Ablehnungen findest du unter Umgang mit Anfechtungen und Rückerstattungen.	`string`
`status`	Der Status der jeweiligen Aktion. `status` kann sein: `initiated`: Eine initiierte Zahlung bedeutet, dass die Zahlung initiiert, aber noch nicht vollständig abgeschlossen ist. Bestellungen dieser Art solltest du nicht erfüllen. Für eine Zahlung mit diesem Status solltest du keine Echtzeitaktualisierung erhalten. Bei Abschluss der zugehörigen Transaktion erhältst du jedoch eine Echtzeitaktualisierung. Entwicklerinnen sehen unter Umständen den Status „initiated“ bei bestimmten Zahlungsmethoden, die langwierig sind. Beispiel: Bei bestimmten Methoden muss derdie Verbraucherin ein Formular online ausfüllen, einen Zahlungsbeleg ausdrucken und zur Bank gehen, um vor Ort zu bezahlen. `completed`: Der Status „completed“ bedeutet, dass die Aktion erfolgreich abgeschlossen wurde. Wenn es sich um eine Belastung handelt, solltest du die Bestellung zu diesem Zeitpunkt für dendie Verbraucherin erfüllen. Dementsprechend solltest du bei einer Rückerstattung als Aktionsart den Artikel vomvon der Verbraucher*in zurückerlangen. `failed`: Dies kennzeichnet eine fehlgeschlagene Aktion für den zugrunde liegenden Typ. Dieser Wert kann sowohl bei einer Belastung als auch bei einer Rückerstattung vorhanden sein.	`string`
`amount`	Der Geldbetrag dieser Aktion.	`string`
`currency`	Die Währung des obigen `amount` dieser Aktion.	`string`
`time_created`	Zeitpunkt der Aktion.	`datetime`
`time_updated`	Letzte Aktualisierung dieser Aktion.	`datetime`
`tax_amount`	Der von deiner Auszahlung für Steuern abgezogene Betrag, der von Facebook abgeführt wurde. Wenn `tax` gleich `not_taxed` oder `already_paid` ist, entfällt dieses Feld.	`string`
`items`	Die mit der Zahlung verbundenen Artikel.	object[]
`type`	Art dieses Artikels.	`enum{IN_APP_PURCHASE, SUBSCRIPTION}`
`product`	Produkt-URL dieses Artikels.	`string`
`quantity`	Gekaufte Anzahl dieser Artikel.	`integer`
`country`	ISO-Länderkennzeichen desder Käuferin, für steuerliche Zwecke.	`string`
`tax`	Der Steuerparameter gibt an, ob eine Zahlung steuerpflichtig (USt oder Mehrwertsteuer) ist und, wenn ja, wie die Steuer gezahlt wurde. Folgende Werte sind möglich: `not_taxed`Die Zahlung ist nicht mehrwertsteuerpflichtig, da sie von außerhalb der Europäischen Union kam. `already_paid`: Die Steuer auf diese Zahlung wurde bereits vom Mobilfunkanbieter desder Nutzerin bzw. einer anderen für den Datenversand zuständigen Partei gezahlt. `tax_remitted`: Facebook hat die USt für diese Zahlung in deinem Namen gezahlt. Der Steuerbetrag wird von deiner Auszahlung abgezogen. Weitere Informationen findest du hier. `tax_remitted_USMPF`: Facebook hat in deinem Namen Umsatzsteuer auf diese Zahlung eingezogen und gezahlt. Der Steuerbetrag wird von deiner Auszahlung abgezogen, hat jedoch keine Auswirkungen auf die Nettoauszahlung, da der berechnete Steuerbetrag zusätzlich zum Artikelpreis erhoben wurde. Weitere Informationen findest du hier.	`string`
`tax_country`	Das Land, das von Facebook für die Steuerberechnung dieses Kaufs festgelegt wurde; als ISO 3166-1 alpha-2-Länderkennzeichen angegeben. Hinweis: Dieses Feld dient lediglich deiner Information und sollte deshalb nicht für Neuberechnungs- oder Abstimmungszwecke verwendet werden. Wenn `tax` gleich `not_taxed` oder `already_paid` ist, entfällt dieses Feld.	`string`
`created_time`	Zeitpunkt, zu dem die Zahlung ursprünglich erstellt wurde.	`string`
`payout_foreign_exchange_rate`	Wechselkurs, mit dem der Auszahlungsbetrag berechnet wurde, der in USD überwiesen wird.	`Gleitkommazahl`
`disputes`	Enthält die Informationen zu einer Anfechtung, darunter die Angaben `user_comment` und `user_email` , die zu Beginn der Anfechtung vom Verbraucher zur Verfügung gestellt werden. Enthält außerdem den aktuellen Status der Anfechtung, Zeitpunkt der Anfechtungserstellung sowie einen Grund für die Beilegung, sofern verfügbar.	`object[]`
`user_comment`	Kommentar desder Verbraucherin bei Einleitung der Anfechtung.	`string`
`user_email`	E-Mail desder Verbraucherin bei Einleitung der Anfechtung.	`string`
`time_created`	Zeitpunkt der Anfechtungserstellung.	`datetime`
`status`	Aktueller Status der Anfechtung.	`enum{resolved, pending}`
`reason`	Grund, den derdie Entwicklerin oder Facebook zur Beilegung der Anfechtung genannt haben, nachdem diese beigelegt wurde.	`enum{pending, refunded_in_cash, granted_replacement_item, denied_refund, banned_user, refunded_by_facebook}`
`test`	Optionaler Parameter, der angezeigt wird, wenn von einem Zahlungstester, der im App-Dashboard aufgeführt wird, eine Zahlung getätigt wird. Dies entspricht einer Transaktion, mit der das Zahlungsinstrument desder Verbraucherin nicht belastet wurde.	`Boolescher Wert`

Veröffentlichen

Du kannst Zahlungen mit Facebook Payments erstellen.

Löschen

Mit dieser API kannst du keine Zahlungen löschen.

Aktualisieren

Mit dieser Edge kannst du keine Zahlungen aktualisieren.

Edges

Name	Beschreibung
/dispute	Aktualisiert den Anfechtungsstatus einer Zahlung.
/refunds	Erstattet eine Zahlung zurück.

Zahlung /{payment-id}