Graph API 版本

付款 /{payment-id}

在應用程式中使用 Facebook 付款進行的付款詳情。

讀取

Graph API 測試工具
GET /v19.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:指明此付款中所採取動作的類型為收費。如果收費處於已完成狀態,您就需要履行訂單。
  • refund:退款類型指明款項已退還,且應儘量收回已出售給消費者的項目,因為您已無法收到此交易的款項。
  • chargeback:消費者提出退款要求,且他們的銀行將相關款項列為有爭議。如有退款情況,您應儘量向消費者收回遊戲項目,因為您已無法收到此訂單的款項。
  • chargeback_reversal:chargeback_reversal 是指取消先前的退款。此時,您應儘量還原消費者的遊戲項目,因為您現在可以收到此付款。
  • decline:拒絕是指用於建立配套交易的支付方式在處理付款時被拒。您應儘量向消費者收回遊戲項目,因為您已無法收到此訂單的款項。如要進一步了解配套交易和拒絕,請參閱處理爭議和退款

string

status

此特定動作的狀態。 status 可以是:

  • initiated:已開始付款是指付款僅已開始,但尚未完成。您不應為消費者履行此類訂單;如果付款處於此狀態,您也不會收到即時更新。不過,您會在相應的交易完成時收到即時更新。開發人員可能會看到某些付款方式顯示為已開始狀態,但完成所需的時間也會較久,例如某些付款方式會要求消費者填寫網上表格、列印收據並前往實體銀行付款。
  • completed:已完成狀態代表動作已順利完成。如果動作類型是收費,此時請履行消費者的訂單。同理,如果動作類型是退款,請向消費者收回項目。
  • failed:這是指基本類型的動作失敗。這個值會出現於收費動作類型和退款動作類型。

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

此稅項參數會指定付款是否必須含稅(增值稅或銷售稅),以及稅項的付款方式(如果必須含稅)。此參數可能會採用以下值:

  • not_taxed:本次付款來自歐盟境外,因此不含增值稅。
  • already_paid:本次付款的稅項已由用戶的流動網絡供應商或其他上遊方支付
  • tax_remitted:Facebook 已代替您支付本次付款的增值稅。稅項金額將從您的支付款項中扣除。詳情請見此處。

  • tax_remitted_USMPF:Facebook 已代替您收取並支付本次付款的銷售稅。稅金將從您的支付款項中扣除,但不會影響淨支付款項,因為所收稅金不包含在商品價格內。詳情請見此處。

string

tax_country

由 Facebook 判定根據哪個國家/地區來計算此筆交易稅項,此參數將以 ISO 3166-1 alpha-2 國碼/區碼顯示。請注意:此欄位僅供參考,不可作為重新計算或收支對帳之用。如果 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

退還付款款項。