Versione API Graph

Pagamento `/{payment-id}`

I dettagli di un pagamento effettuato in un'app con Pagamenti di Facebook.

Lettura

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
}];

Autorizzazioni

È necessario un token d'accesso dell'app per l'app che ha creato il pagamento.

Campi

Nome	Descrizione	Tipo
`id`	ID del pagamento	`string`
`user`	Nome e cognome del consumatore insieme al suo `id`utente. Possono essere omessi in alcuni casi.	`Utente`
`request_id`	L'identificativo unico opzionale creato dall'app e passato nella funzione JavaScript (massimo 255 caratteri)	`string`
`application`	L'app associata a questo pagamento	`App`
`actions`	La lista dei diversi tipi di azione verificatisi in questo pagamento.	object[]
`type`	Il tipo di azione in particolare. `type` può essere: `charge`: indica che il tipo di azione eseguita su questo pagamento era un addebito. Se lo stato dell'addebito risulta essere completato, allora devi evadere l'ordine. `refund`: il tipo di rimborso indica che il pagamento è stato rimborsato e l'articolo venduto al consumatore deve essere ritirato, se possibile, poiché non riceverai più alcun pagamento per quella transazione. `chargeback`: un consumatore avvia un chargeback con la propria banca per contestare il pagamento in questione. Quando si verifica un chargeback, devi ritirare l'articolo nel gioco del cliente, se possibile, poiché non riceverai alcun pagamento per quell'ordine. `chargeback_reversal`: un chargeback_reversal si verifica quando un chargeback viene annullato in maniera retroattiva. In questo caso, devi ripristinare l'articolo nel gioco del consumatore, se possibile, poiché riceverai il pagamento corrispondente. `decline`: un rifiuto si verifica quando una fonte di finanziamento usata per creare una transazione mista viene rifiutata al momento dell'elaborazione del pagamento. Devi ritirare l'articolo nel gioco del consumatore, se possibile, poiché non riceverai il pagamento per quell'ordine. Maggiori informazioni sulle transazioni miste e sui rifiuti sono disponibili in Gestione di contestazioni e rimborsi.	`string`
`status`	Il tipo di stato per questa azione in particolare. `status` può essere: `initiated`: un pagamento iniziato indica che il pagamento è stato solo iniziato ma non ancora completato. Non devi evadere un ordine di questo tipo e non devi ricevere un aggiornamento in tempo reale relativo a un pagamento con questo stato. Tuttavia, riceverai un aggiornamento in tempo reale quando la transazione corrispondente viene completata. Gli sviluppatori potrebbero vedere lo stato di pagamento "initiated" per alcuni metodi di pagamento che richiedono un tempo maggiore per l'elaborazione, ad esempio i metodi che richiedono la compilazione di un modulo online da parte del cliente, la stampa di una ricevuta e il pagamento presso uno sportello bancario fisico. `completed`: questo stato indica che l'azione è stata portata a termine correttamente. Se il tipo di azione era un addebito, dovrai a questo punto evadere l'ordine del consumatore. Allo stesso modo, se il tipo di azione era un rimborso, dovrai ritirare l'articolo. `failed`: indica un'azione non riuscita per il tipo in oggetto. Questo valore può riguardare un tipo di azione "addebito", ma anche un tipo di azione "rimborso".	`string`
`amount`	L'importo in denaro coperto da questa azione.	`string`
`currency`	La valuta del valore `amount` indicato sopra per questa azione.	`string`
`time_created`	Quando è avvenuta questa azione.	`datetime`
`time_updated`	Quando è avvenuto l'ultimo aggiornamento di questa azione.	`datetime`
`tax_amount`	L'importo sottratto dal pagamento per le imposte versate da Facebook. Se `tax` corrisponde a `not_taxed` o a `already_paid` , questo campo sarà omesso.	`string`
`items`	Gli articoli associati al pagamento.	object[]
`type`	Il tipo di articolo.	`enum{IN_APP_PURCHASE, SUBSCRIPTION}`
`product`	L'URL del prodotto di questo articolo.	`string`
`quantity`	Il numero di articoli acquistati.	`integer`
`country`	Il codice ISO del Paese, per scopi fiscali.	`string`
`tax`	Il parametro tax specifica se un pagamento è soggetto a imposta (IVA o imposte sulle vendite) e, in tal caso, come viene corrisposta. Può assumere i valori seguenti: `not_taxed`: non si applica IVA su questo pagamento perché proveniente da Paesi al di fuori dell'Unione europea. `already_paid`: l'imposta di questo pagamento è stata già pagata dall'operatore di telefonia mobile dell'utente o da un'altra parte a monte `tax_remitted`: Facebook ha pagato l'IVA su questo pagamento per tuo conto. Il valore dell'imposta sarà detratto dal tuo pagamento. Qui puoi trovare maggiori informazioni. `tax_remitted_USMPF`: Facebook ha riscosso e pagato l'imposta sulle vendite su questo pagamento per tuo conto. L'importo delle imposte verrà sottratto dal pagamento, ma non influenzerà il tuo pagamento netto, poiché l'importo delle tasse addebitato è in aggiunta al prezzo del bene. Qui puoi trovare maggiori informazioni.	`string`
`tax_country`	Il Paese determinato da Facebook per il calcolo delle imposte dell'acquisto, espresso con il codice del Paese in base allo standard ISO 3166-1 alpha-2. Nota: questo campo è fornito esclusivamente a titolo informativo e non deve essere usato per fini di ricalcolo o riconciliazione. Se `tax` corrisponde a `not_taxed` o ad `already_paid` , questo campo sarà omesso.	`string`
`created_time`	Il momento in cui il pagamento è stato originariamente creato.	`string`
`payout_foreign_exchange_rate`	Il tasso di cambio usato per calcolare l'importo del pagamento corrisposto in USD.	`float`
`disputes`	Contiene le informazioni legate a una contestazione, inclusi `user_comment` e `user_email` forniti dal consumatore all'avvio della contestazione stessa. Inoltre, contiene lo stato attuale della contestazione, il momento in cui tale contestazione è stata creata e il motivo della risoluzione, se disponibile.	`object[]`
`user_comment`	Il commento fornito dal consumatore all'avvio della contestazione.	`string`
`user_email`	L'indirizzo e-mail fornito dal consumatore all'avvio della contestazione.	`string`
`time_created`	Il momento in cui la contestazione è stata creata.	`datetime`
`status`	Lo stato attuale della contestazione.	`enum{resolved, pending}`
`reason`	Il motivo che lo sviluppatore o Facebook hanno fornito per la risoluzione della contestazione, dopo che è stata risolta.	`enum{pending, refunded_in_cash, granted_replacement_item, denied_refund, banned_user, refunded_by_facebook}`
`test`	Parametro facoltativo che mostra quando un pagamento viene effettuato da un tester presente nella Dashboard gestione app. Rappresenta una transazione che non è stata addebitata nello strumento dei pagamenti del consumatore	`boolean`

Pubblicazione

Puoi creare dei pagamenti con Pagamenti di Facebook.

Eliminazione

Non puoi eliminare i pagamenti usando questa API.

Aggiornamento

Non puoi aggiornare i pagamenti usando questo segmento.

Segmenti

Nome	Descrizione
/dispute	Aggiorna lo stato della contestazione di un pagamento.
/refunds	Rimborsa un pagamento.

Pagamento /{payment-id}