versión API Graph

Pago `/{payment-id}`

Detalles de un pago realizado en una aplicación mediante Pagos de Facebook.

Lectura

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

Permisos

Se requiere un identificador de acceso a la aplicación que ha creado el pago.

Campos

Nombre	Descripción	Tipo
`id`	Identificador del pago.	`string`
`user`	Nombre y apellidos del consumidor, junto con su `id` de usuario. Puede omitirse en algunos casos.	`User`
`request_id`	Identificador único y opcional creado por la aplicación transmitido a la función de JavaScript (máximo 255 caracteres).	`string`
`application`	Aplicación vinculada a este pago.	`App`
`actions`	Lista de diferentes tipos de acciones que han ocurrido en este pago.	objeto[]
`type`	Tipo de acción. `type` puede ser: `charge`: indica que el tipo de acción realizada en este pago ha sido un cobro. Si el estado del cobro es “completado”, debes proceder a completar el pedido. `refund`: indica que el pago se ha reembolsado y el artículo vendido al consumidor debe recuperarse si es posible, ya que no se te pagará por esta transacción. `chargeback`: indica que el consumidor ha rechazado el cobro del pago en cuestión a través de su banco. Cuando se produce un contracargo, debes recuperar el artículo del juego del consumidor siempre que sea posible, ya que no se te pagará por esta transacción. `chargeback_reversal`: ocurre cuando se revierte un contracargo con carácter retroactivo. En este caso, debes restablecer el artículo del juego del consumidor si es posible, ya que, finalmente, sí se te pagará por esta transacción. `decline`: ocurre cuando el método de pago utilizado para crear una transacción agrupada se rechaza en el momento de procesar el pago. Debes recuperar el artículo del juego del consumidor siempre que sea posible, ya que no se te pagará por esta transacción. Encontrarás más información sobre las transacciones agrupadas y los rechazos en Gestionar recursos y reembolsos.	`string`
`status`	Estado de esta acción. `status` puede ser: `initiated`: indica que el pago se ha iniciado, pero no se ha completado. No deberías completar el pedido de un consumidor en este estado. No recibirás una actualización en tiempo real de un pago con este estado. Sin embargo, recibirás una actualización en tiempo real cuando la transacción correspondiente se haya completado. Es posible que los desarrolladores vean este estado cuando se usan determinados métodos de pago que requieren un proceso largo, como los que implican rellenar un formulario en internet, imprimir un recibo y acudir personalmente al banco para realizar el pago. `completed`: indica que la acción se ha completado correctamente. Si se trata de un cobro, deberás completar el pedido del consumidor cuando veas este estado. De igual forma, si el tipo de acción es un reembolso, deberás recuperar el artículo del consumidor. `failed`: indica una acción fallida en el tipo subyacente. Este valor puede aparecer en los tipos de acción “cobro” y “reembolso”.	`string`
`amount`	Importe de la acción.	`string`
`currency`	Divisa del importe (`amount`) de esta acción, indicado anteriormente.	`string`
`time_created`	Fecha y hora en las que se ha producido esta acción.	`datetime`
`time_updated`	Fecha y hora en las que la acción se ha actualizado por última vez.	`datetime`
`tax_amount`	Importe deducido del pago en concepto de impuestos remitidos por Facebook. Este campo se omitirá si `tax` es igual a `not_taxed` o `already_paid`.	`string`
`items`	Artículos asociados al pago.	objeto[]
`type`	Tipo de artículo.	`enum{IN_APP_PURCHASE, SUBSCRIPTION}`
`product`	URL de producto de este artículo.	`string`
`quantity`	Número de unidades del artículo compradas.	`integer`
`country`	Código de país ISO del comprador, para fines fiscales.	`string`
`tax`	Especifica si un pago está sujeto a impuestos (IVA o sobre las ventas) y, en caso afirmativo, cómo se han pagado. Puede incluir los siguientes valores: `not_taxed`: este pago no incluye IVA porque procede de fuera de la Unión Europea. `already_paid`: los impuestos aplicados a este pago los ha pagado el operador de telefonía móvil del usuario u otro operador de subida. `tax_remitted`: Facebook ha pagado el IVA de este pago en tu nombre. El importe correspondiente se deducirá de tu pago. Aquí puedes obtener más información. `tax_remitted_USMPF`: Facebook ha recaudado y pagado los impuestos sobre las ventas de este pago en tu nombre. El importe correspondiente se deducirá de tu pago, pero no afectará al importe neto de tu pago, ya que se trata de impuestos añadidos al precio del artículo. Aquí puedes obtener más información.	`string`
`tax_country`	El país que Facebook toma como referencia para el cálculo de los impuestos de esta compra, indicado mediante un código de país ISO 3166-1 alfa-2. Nota: Este campo es solo informativo y no debe usarse con fines de recálculo o reconciliación. Este campo se omitirá si `tax` es igual a `not_taxed` o `already_paid`.	`string`
`created_time`	Fecha y hora en las que se creó el pago originalmente.	`string`
`payout_foreign_exchange_rate`	Tasa de cambio utilizada para calcular el importe del pago remitido en USD.	`float`
`disputes`	Contiene información relacionada con un recurso, incluidos los valores de `user_comment` y `user_email` proporcionados por el consumidor cuando inició el recurso. También incluye el estado actual del recurso, la fecha y hora de creación del recurso y un motivo de resolución, si lo hubiera.	`object[]`
`user_comment`	Comentario proporcionado por el consumidor cuando inició el recurso.	`string`
`user_email`	Correo electrónico proporcionado por el consumidor cuando inició el recurso.	`string`
`time_created`	Fecha y hora en las que se creó el recurso.	`datetime`
`status`	Estado actual del recurso.	`enum{resolved, pending}`
`reason`	Motivo que el desarrollador o Facebook han dado para resolver el recurso, una vez resuelto.	`enum{pending, refunded_in_cash, granted_replacement_item, denied_refund, banned_user, refunded_by_facebook}`
`test`	Parámetro opcional que aparece cuando un evaluador de pagos que figura en el panel de la aplicación realiza un pago. Representa una transacción que no se ha cobrado al instrumento de pago del consumidor.	`boolean`

Publicación

Puedes crear pagos mediante los pagos de Facebook.

Eliminación

No puedes eliminar pagos con esta API.

Actualización

No puedes actualizar pagos con este perímetro.

Perímetros

Nombre	Descripción
/dispute	Actualiza el estado del recurso de un pago.
/refunds	Reembolsa un pago.

Pago /{payment-id}