API Graph versión

Pago `/{payment-id}`

Detalles de un pago realizado en una app por medio de los 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 necesita un token de acceso a la app que creó que el pago.

Campos

Nombre	Descripción	Tipo
`id`	Identificador del pago.	`string`
`user`	Nombre y apellido del consumidor junto con su `id` de usuario. En algunos casos, se puede omitir esta información.	`User`
`request_id`	Identificador único opcional creado por la app que se pasa a la función JS (cantidad máxima de caracteres: 255).	`string`
`application`	App asociada a este pago.	`App`
`actions`	Lista de los diferentes tipos de acciones que se realizaron en relación con este pago.	object[]
`type`	Tipo de esta acción específica. `type` puede ser `charge`: indica que el tipo de acción realizada en relación con este pago fue un cobro. Si el cobro figura con el estado "Completado", debes procesar el pedido. `refund`: indica que se reembolsó el pago y que se debe pedir al consumidor que entregue el artículo que se le vendió, si es posible, porque esta transacción ya no redundará en beneficios para ti. `chargeback`: el consumidor inicia un contracargo por medio del banco, que reclama el pago en cuestión. Si se presenta un contracargo, debes pedir al consumidor que entregue el artículo en el juego, si es posible, porque este pedido ya no redundará en beneficios para ti. `chargeback_reversal`: un contracargo se anula cuando se revierte de manera retroactiva. En este caso, debes reintegrar al consumidor el artículo en el juego, si es posible, porque ahora este pago redundará en beneficios para ti. `decline`: ocurre cuando se rechaza el método de pago utilizado para crear una transacción combinada en el momento de procesar el pago. Debes pedir al consumidor que entregue el artículo en el juego, si es posible, porque este pedido ya no redundará en beneficios para ti. Para obtener más información sobre rechazos y transacciones combinadas, consulta Gestión de disputas y reembolsos.	`string`
`status`	Estado de esta acción específica. `status` puede ser `initiated`: indica que solo se inició un pago, pero todavía no se completó. No debes procesar un pedido de este tipo con el consumidor ni recibir una actualización en tiempo real sobre un pago que tenga este estado. Sin embargo, recibirás la actualización una vez que se complete la transacción correspondiente. Los desarrolladores verán el estado "Iniciado" de algunos métodos de pago en que los pagos demoran mucho en liquidarse, por ejemplo, los que requieren que el consumidor complete un formulario online, imprima un recibo y acuda personalmente al banco para realizar el pago. `completed`: este estado indica que la acción se realizó correctamente. Si el tipo de acción era "cobro", te recomendamos que proceses el pedido del consumidor en este momento. De manera similar, si el tipo de acción era "reembolso", pide al consumidor que devuelva el artículo. `failed`: indica que la acción no se realizó correctamente según el tipo subyacente. Este valor puede aparecer en los tipos de acción "cobro" y "reembolso".	`string`
`amount`	Importe correspondiente a esta acción.	`string`
`currency`	Divisa del importe `amount` correspondiente a esta acción que se mencionó antes.	`string`
`time_created`	Fecha y hora en que se realizó esta acción.	`datetime`
`time_updated`	Fecha y hora de la última actualización de esta acción.	`datetime`
`tax_amount`	Importe deducido de tu pago correspondiente a los impuestos que remite Facebook. Si `tax` es igual a `not_taxed` o `already_paid` , se omitirá este campo.	`string`
`items`	Artículos asociados al pago.	object[]
`type`	Tipo de artículo.	`enum{IN_APP_PURCHASE, SUBSCRIPTION}`
`product`	URL de producto de este artículo.	`string`
`quantity`	Número del artículo comprado.	`integer`
`country`	Código de país ISO del comprador, para fines impositivos.	`string`
`tax`	Este parámetro especifica si un pago está sujeto a impuestos (IVA o impuesto sobre las ventas). En ese caso, indica cómo se pagó el impuesto. Puede presentar los siguientes valores: `not_taxed`: este pago no está sujeto al IVA porque proviene de un país que no pertenece a la Unión Europea. `already_paid`: el operador de telefonía celular del usuario u otra parte ya pagó el impuesto de este pago. `tax_remitted`: Facebook pagó el IVA de este pago en tu nombre. El importe del impuesto se deducirá de tu pago. Consulta aquí para obtener más información. `tax_remitted_USMPF`: Facebook recaudó y pagó los impuestos sobre las ventas de este pago en tu nombre. El importe del impuesto se deducirá de tu pago, pero no afectará el pago neto, ya que se sumará al precio del artículo. Consulta aquí para obtener más información.	`string`
`tax_country`	País que Facebook determina para el cálculo de los impuestos de esta compra, que se expresa como un código de país ISO 3166-1 alfa-2. Nota: Este campo es solo informativo y no se debe usar con fines de cálculos ni conciliaciones. Si `tax` es igual a `not_taxed` o `already_paid` , se omitirá este campo.	`string`
`created_time`	Hora en que se creó el pago originalmente.	`string`
`payout_foreign_exchange_rate`	Tipo de cambio que se usa para calcular el importe del pago, que se remite en dólares estadounidenses.	`float`
`disputes`	Contiene la información relacionada con una disputa, incluidos el `user_comment` y el `user_email` que proporciona el consumidor cuando se inicia la disputa. Además, incluye el estado actual de la disputa, la hora en que se creó y un motivo de resolución, si está disponible.	`object[]`
`user_comment`	Comentario que proporciona el consumidor cuando se inicia la disputa.	`string`
`user_email`	Correo electrónico que proporciona el consumidor cuando se inicia la disputa.	`string`
`time_created`	Hora en la que se creó la disputa.	`datetime`
`status`	Estado actual de la disputa.	`enum{resolved, pending}`
`reason`	Motivo de resolución de la disputa, según lo indiquen Facebook o el desarrollador una vez que se la resolvió.	`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 se muestra en el panel de la app realiza un pago. Representa una transacción que no se cobró al instrumento de pago del consumidor.	`boolean`

Publicación

Puedes usar los pagos de Facebook para crear pagos.

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 de la disputa de un pago.
/refunds	Reembolsa un pago.

Pago /{payment-id}