Version API du graphe

Paiement `/{payment-id}`

Les détails d’un paiement effectué dans une application utilisant les paiements Facebook.

Lecture

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

Autorisations

Un token d’accès d’application est requis pour l’application qui a créé le paiement.

Champs

Nom	Description	Type
`id`	L’ID du paiement.	`string`
`user`	Le prénom et le nom du consommateur, ainsi que son `id` utilisateur. Peut être omis dans certains cas.	`User`
`request_id`	L’identifiant unique facultatif créé par l’application, transmis à la fonction JS (255 caractères maximum).	`string`
`application`	L’application associée à ce paiement.	`App`
`actions`	La liste des différents types d’action qui ont eu lieu dans ce paiement.	object[]
`type`	Le type de cette action particulière. `type` peut être : `charge` : indique que le type d’action effectué sur ce paiement était une facturation. Si le statut de la facturation est Terminé, vous devez honorer la commande. `refund` : indique que le paiement a été remboursé et que l’article vendu au consommateur doit être retiré, si possible, car vous ne serez plus payé pour cette transaction. `chargeback` : un chargeback est initié par un consommateur, sa banque contestant le paiement en question. Lorsqu’un chargeback se produit, vous devez reprendre au consommateur l’article intégré, si possible, car vous ne serez pas payé pour cette commande. `chargeback_reversal` : un chargeback_reversal se produit quand un chargeback est annulé de façon rétroactive. Dans ce cas, vous devez rendre au consommateur l’article intégré, si possible, car le paiement vous sera versé. `decline` : un refus se produit lorsqu’une source d’approvisionnement utilisée pour créer une transaction groupée est refusée au moment du traitement du paiement. Vous devez reprendre au consommateur l’article intégré, si possible, car vous ne serez pas payé pour cette commande. Pour plus d’informations sur les transactions groupées et les refus, consultez la page Gestion des litiges et des remboursements.	`string`
`status`	Le statut de l’action concernée. `status` peut être : `initiated` : indique que le paiement a été simplement initié et qu’il n’est pas encore terminé. Vous ne devez pas honorer une commande de ce type avec le consommateur et vous ne devez pas recevoir de mise à jour en temps réel pour un paiement ayant ce statut. Vous obtiendrez cependant une mise à jour en temps réel lorsque la transaction correspondante sera terminée. Les développeurs peuvent voir l’état initié pour certains moyens de paiement qui prennent beaucoup de temps, comme ceux qui exigent que le consommateur remplisse un formulaire en ligne, imprime un reçu et se rende à la banque pour effectuer le paiement. `completed` : indique que l’action s’est terminée avec succès. S’il s’agit d’une action de type facturation, vous devez maintenant honorer la commande du consommateur. De même, si l’action est de type remboursement, vous devez retirer l’article au consommateur. `failed` : indique que l’action associée au type sous-jacent a échoué. Cette valeur peut être présente à la fois pour une action de type facturation et pour une action de type remboursement.	`string`
`amount`	Le montant d’argent couvert par cette action.	`string`
`currency`	La devise du `amount` ci-dessus dans cette action.	`string`
`time_created`	L’horodatage de l’action.	`datetime`
`time_updated`	L’horodatage de la dernière mise à jour de l’action.	`datetime`
`tax_amount`	Le montant déduit de votre paiement pour toutes les taxes versées par Facebook. Si `tax` correspond à `not_taxed` ou `already_paid`, ce champ sera omis.	`string`
`items`	Les articles associés au paiement.	object[]
`type`	Le type de cet article.	`enum{IN_APP_PURCHASE, SUBSCRIPTION}`
`product`	L’URL du produit correspondant à cet article.	`string`
`quantity`	La quantité achetée de cet article.	`integer`
`country`	Le code de pays au format ISO de l’acheteur, à des fins fiscales.	`string`
`tax`	Ce paramètre indique si un paiement est soumis à une taxe (TVA ou taxe de vente) et, le cas échéant, de quelle manière cette taxe a été payée. Il peut prendre les valeurs suivantes : `not_taxed` : ce paiement n’est pas soumis à la TVA, car il ne provient pas de l’Union européenne. `already_paid` : la taxe sur ce paiement a déjà été payée par l’opérateur mobile de l’utilisateur ou une autre partie en amont. `tax_remitted` : Facebook a payé la TVA sur ce paiement en votre nom. Le montant de la taxe sera déduit de votre paiement. Pour plus d’informations, cliquez ici. `tax_remitted_USMPF` : Facebook a collecté et payé la taxe de vente sur ce paiement en votre nom. Le montant de la taxe sera déduit de votre paiement, mais n’affectera pas votre paiement net, car le montant de la taxe facturé s’ajoute au prix du bien. Pour plus d’informations, cliquez ici.	`string`
`tax_country`	Le pays défini par Facebook pour le calcul de la taxe sur cet achat, indiqué sous la forme d’un code pays ISO 3166-1 alpha-2. Remarque : ce champ est fourni à titre d’information uniquement et ne doit pas être utilisé à des fins de recalcul ou de rapprochement. Si `tax` correspond à `not_taxed` ou `already_paid`, ce champ sera omis.	`string`
`created_time`	L’horodatage de la création initiale du paiement.	`string`
`payout_foreign_exchange_rate`	Le taux de change utilisé pour calculer le montant du paiement qui est versé en USD.	`float`
`disputes`	Contient les informations relatives à un litige, y compris `user_comment` et `user_email` qui sont fournis par le consommateur lorsque le litige est initié. Contient également le statut actuel du litige, l’horodatage de sa création et une raison de résolution, le cas échéant.	`object[]`
`user_comment`	Le commentaire fourni par le consommateur lorsque le litige est initié.	`string`
`user_email`	L’adresse e-mail fournie par le consommateur lorsque le litige est initié.	`string`
`time_created`	L’horodatage de la création du litige.	`datetime`
`status`	Le statut actuel du litige.	`enum{resolved, pending}`
`reason`	La raison indiquée par le développeur ou Facebook pour résoudre le litige, après qu’il a été résolu.	`enum{pending, refunded_in_cash, granted_replacement_item, denied_refund, banned_user, refunded_by_facebook}`
`test`	Paramètre facultatif qui s’affiche lorsqu’un paiement est effectué par un testeur de paiements répertorié dans le tableau de bord de l’application. Ceci représente une transaction qui n’a pas été facturée à l’instrument de paiement du consommateur.	`boolean`

Publication

Vous pouvez créer des paiements à l’aide des paiements Facebook.

Suppression

Vous ne pouvez pas supprimer des paiements à l’aide de cette API.

Mise à jour

Vous ne pouvez pas mettre à jour des paiements à l’aide de cette arête.

Arêtes

Nom	Description
/dispute	Met à jour le statut de litige d’un paiement.
/refunds	Rembourse un paiement.

Paiement /{payment-id}