Версия API Graph

`/{payment-id}` платежа

Сведения о платеже в приложении, использующем сервис "Платежи на Facebook".

Чтение

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

Разрешения

Обязательно должен быть указан маркер доступа приложения, в котором создан платеж.

Поля

Имя	Описание	Тип
`id`	ID платежа.	`string`
`user`	Имя и фамилия потребителя, а также его `id` пользователя. Могут опускаться в некоторых случаях.	`User`
`request_id`	Уникальные необязательные личные данные, которые созданы в приложении и передаются функции JavaScript (не более 255 символов).	`string`
`application`	Приложение, связанное с этим платежом.	`App`
`actions`	Список различных типов действий, совершенных в рамках этого платежа.	object[]
`type`	Тип действия. `type` может иметь следующие значения: `charge` — типом действия для платежа является списание средств. Если списание имеет статус "Завершено", необходимо выполнить заказ. `refund` — этот тип указывает на то, что платеж возвращен, а товар, проданный потребителю, нужно по возможности вернуть, так как вы больше не получите оплату в рамках этой транзакции. `chargeback` — потребитель инициировал возврат платежа, оспорив его через свой банк. Вам нужно по возможности забрать у потребителя внутриигровой товар, так как вы не получите оплату по этому заказу. `chargeback_reversal` — возврат платежа отменен задним числом. В таком случае следует по возможности снова предоставить потребителю внутриигровой товар, так как вы получите оплату по этому заказу. `decline` — этот тип означает, что источник финансирования, с помощью которого создана пакетная транзакция, отклонен в момент обработки платежа. Вам следует по возможности забрать у потребителя внутриигровой товар, так как вы не получите оплату по этому заказу. Подробнее о пакетных транзакциях и их отклонении см. в разделе о разрешении споров и возврате средств.	`string`
`status`	Статус действия. `status` может иметь следующие значения: `initiated` — транзакция начата, но платеж ещё не выполнен. Вам не следует выполнять заказ, пока транзакция не будет завершена. Информация о ходе выполнения платежа с таким статусом поступать не будет, но вы получите уведомление, когда транзакция будет завершена. Такой статус может быть указан для тех способов оплаты, осуществление которых требует времени. Например, при использовании некоторых способов оплаты потребитель должен заполнить онлайн-форму, распечатать квитанцию и оплатить ее в отделении банка. `completed` — статус "Завершено" указывает на то, что действие успешно выполнено. Если тип действия — charge (списание средств), вам нужно выполнить заказ потребителя. Если же тип действия — refund (возврат средств), то вам следует забрать у него товар. `failed` — указывает на то, что не удалось выполнить действие определенного типа. Это значение может использоваться как для списания средств, так и для возврата.	`string`
`amount`	Сумма средств, связанная с этим действием.	`string`
`currency`	Валюта, в которой указано значение `amount` для этого действия.	`string`
`time_created`	Время, когда произошло действие.	`datetime`
`time_updated`	Время, когда статус действия обновлялся последний раз.	`datetime`
`tax_amount`	Сумма, вычтенная из вашей выплаты в счет любых налогов, которые перечисляет Facebook. Если `tax` имеет значение `not_taxed` или `already_paid`, это поле опускается.	`string`
`items`	Товары, связанные с платежом.	object[]
`type`	Тип товара.	`enum{IN_APP_PURCHASE, SUBSCRIPTION}`
`product`	URL товара.	`string`
`quantity`	Число приобретенных товаров этого типа.	`integer`
`country`	ISO-код страны покупателя (необходим в целях налогообложения).	`string`
`tax`	Параметр tax (налог) указывает, облагается ли платеж налогом (НДС или налогом с продаж), и если да, то каким образом уплачен налог. Значения могут быть следующими: `not_taxed` — этот платеж не облагается НДС, поскольку он поступил из страны за пределами ЕС. `already_paid` — налог для этого платежа уже уплачен мобильным оператором пользователя или какой-либо другой вышестоящей стороной. `tax_remitted` — компания Facebook оплатила НДС для этого платежа от вашего имени. Сумма налога при этом вычитается из вашей выплаты. Подробнее об этом можно узнать здесь. `tax_remitted_USMPF` — компания Facebook собрала и оплатила налог с продаж для этого платежа от вашего имени. Сумма налога будет вычтена из вашей выплаты, однако это не повлияет на ваш чистый доход, так как сумма налога списывается в дополнение к стоимости товара. Подробнее об этом можно узнать здесь.	`string`
`tax_country`	Страна, определенная Facebook с целью расчета налога для этой покупки, в виде кода страны alpha-2 по стандарту ISO 3166-1. Примечание. Это поле предназначено только для информации и не должно использоваться с целью пересчета или сверки. Если `tax` имеет значение `not_taxed` или `already_paid`, это поле опускается.	`string`
`created_time`	Время изначального создания платежа.	`string`
`payout_foreign_exchange_rate`	Обменный курс, который использовался для расчета суммы выплаты, перечисленной в долларах США.	`float`
`disputes`	Содержит информацию, связанную со спором, в том числе `user_comment` (комментарий) и `user_email` (электронный адрес), указанные потребителем в момент инициирования спора. Здесь также указываются текущий статус спора, время его создания и причина разрешения (если она известна).	`object[]`
`user_comment`	Комментарий, указанный потребителем в момент инициирования спора.	`string`
`user_email`	Электронный адрес, указанный потребителем в момент инициирования спора.	`string`
`time_created`	Время создания спора.	`datetime`
`status`	Текущий статус спора.	`enum{resolved, pending}`
`reason`	Причина разрешения спора, указанная разработчиком или Facebook после его разрешения.	`enum{pending, refunded_in_cash, granted_replacement_item, denied_refund, banned_user, refunded_by_facebook}`
`test`	Необязательный параметр, который используется, если платеж совершен тестировщиком платежей, указанным в панели приложения. Он обозначает транзакцию, по которой с платежного средства потребителя не были списаны средства.	`boolean`

Публикация

Платежи можно создавать с помощью сервиса "Платежи на Facebook".

Удаление

Платежи нельзя удалять с помощью этого API.

Обновление

Платежи нельзя обновлять с помощью этой границы контекста.

Границы контекста

Имя	Описание
/dispute	Используется для обновления статуса спора, связанного с платежом.
/refunds	Используется для возврата платежа.

/{payment-id} платежа