图谱 API 版

支付 /{payment-id}

在应用中使用 Facebook 支付进行的付款的详细信息。

读取

图谱 API 探索工具
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

交易号码

string

user

消费者的名字和姓氏以及其用户 id在某些情况下可能会省略。

User

request_id

由应用创建并传递到 JS 函数的唯一可选标识符(不得超过 255 个字符)

string

application

与此支付相关的应用

App

actions

此支付中发生的各操作类型的清单。

object[]

type

此特定操作的类型。type 可以为:

  • charge:这表明对这笔款项采取的操作类型为收费 (charge)。如果收费状态为已完成 (completed),您应该履行订单。
  • refund:退款 (refund) 类型表明支付的款项已退还。如果有可能,您应该收回出售给消费者的商品,因为您将不会获得此交易的款项。
  • chargeback:拒付 (chargeback) 由消费者向银行发起,会对相关支付提出争议。发生拒付后,如果有可能,您应该从消费者处收回游戏内商品,因为您将不会获得此订单的款项。
  • chargeback_reversal:撤销拒付 (chargeback_reversal) 是指撤销之前的拒付操作。在此情况下,如果有可能,您应恢复消费者的游戏内商品,因为现在您会获得此交易的款项。
  • decline:在处理支付时,如果用于创建捆绑交易的资金来源遭拒,支付便会遭拒 (decline)。如果有可能,您应该从消费者处收回游戏内商品,因为您将不会获得此订单的款项。有关捆绑交易和拒绝的更多信息,请参见处理异议和退款

string

status

此特定操作的状态。status 可以为:

  • initiated:如果支付为已发起 (initiated) 状态,则表明支付仅处于发起阶段,但尚未完全完成。您不应向消费者履行此类订单,并且不会收到支付处于此状态的实时更新。但是,当相应交易完成后,您便会收到实时更新。某些处理时间较长的支付方式会显示为已发起 (initiated) 状态,例如要求消费者填写在线表单、打印收据以及前往银行完成线下付款的支付方式。
  • completed:已完成 (completed) 状态表示已成功完成操作。如果类型是收费 (charge),您此时需要向消费者履行订单。同样,如果操作类型是退款 (refund),您需要从消费者处收回商品。
  • failed:这表明相应类型的操作失败。收费 (charge) 操作类型和退款 (refund) 操作类型都可能出现此值。

string

amount

此操作涉及的金额。

string

currency

此操作中上述 amount 的货币。

string

time_created

发生此操作的时间。

datetime

time_updated

此操作的最后更新时间。

datetime

tax_amount

Facebook 从您的进账中扣除并代缴的所有税费金额。如果 tax 的值为 not_taxedalready_paid,系统将略去此字段。

string

items

与支付相关的商品。

object[]

type

此商品的类型。

enum{IN_APP_PURCHASE, SUBSCRIPTION}

product

此商品的商品网址。

string

quantity

所购商品的数量。

integer

country

买家的 ISO 国家/地区代码(用于计税)。

string

tax

tax 参数指明一笔款项是否应纳税(增值税或销售税);如果是,应如何缴纳。此参数可能表示为以下值:

  • not_taxed:此付款发生在欧盟境外,因此不用缴纳增值税。
  • already_paid:此笔款项的税款已经由用户的移动运营商或其他上游方代付
  • tax_remitted:Facebook 已代您缴纳此笔款项的增值税。相关税费将从您的进账中扣除。点击此处了解详情

  • tax_remitted_USMPF:Facebook 已为您代收和代缴本笔款项的销售税。税费金额将从您的进账中扣除,但不会影响您的净进账,因为所收取的税费金额不包含在商品价格中。点击此处了解详情

string

tax_country

由 Facebook 确定的此交易收税国家/地区,以 2 位字母的 ISO 3166-1 国家/地区代码表示。注意:本字段仅供您参考,不得用于任何重新计算或对账用途。如果 tax 的值为 not_taxedalready_paid,系统将略去此字段。

string

created_time

支付的最初创建时间。

string

payout_foreign_exchange_rate

用于计算进账金额的汇率,以美元汇付。

float

disputes

包含与异议有关的信息,包括消费者在提出异议时提供的 user_commentuser_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

为支付退款。