เวอร์ชันของ API กราฟ

การชำระเงิน `/{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`	ตัวระบุที่แอพสร้างขึ้นแบบไม่ซ้ำกันซึ่งจะระบุหรือไม่ก็ได้ ซึ่งได้รับการส่งผ่านไปยังฟังก์ชั่น JS (สูงสุด 255 อักขระ)	`string`
`application`	แอพที่เชื่อมโยงกับการชำระเงินนี้	`App`
`actions`	รายการการดำเนินการประเภทต่างๆ ที่เกิดขึ้นในการชำระเงินนี้	อ็อบเจ็กต์[]
`type`	ประเภทของการดำเนินการที่เฉพาะเจาะจงนี้ โดย `type` อาจมีค่าได้ดังนี้ `charge`: รายการนี้จะกำหนดว่าประเภทของการดำเนินการที่เกิดขึ้นในการชำระเงินนี้คือการเก็บค่าบริการ หากการเก็บค่าบริการมีสถานะเป็น “completed” คุณก็ควรเริ่มดำเนินการตามคำสั่งซื้อ `refund`: ประเภท “refund” จะกำหนดว่าการชำระเงินดังกล่าวได้รับการคืนเงินแล้ว และควรมีการเรียกคืนสินค้าที่ขายให้กับผู้บริโภครายนั้นๆ หากเป็นไปได้ เนื่องจากคุณจะไม่ได้รับเงินสำหรับธุรกรรมในครั้งนี้แล้ว `chargeback`: การปฏิเสธการชำระเงินเริ่มต้นมาจากฝั่งของผู้บริโภค โดยธนาคารของผู้บริโภคได้โต้แย้งการชำระเงินดังกล่าว เมื่อเกิดการปฏิเสธการชำระเงินขึ้น คุณควรเรียกคืนสินค้าในเกมจากลูกค้าหากสามารถทำได้ เนื่องจากคุณจะไม่ได้รับเงินสำหรับคำสั่งซื้อนี้ `chargeback_reversal`: chargeback_reversal จะเกิดขึ้นเมื่อมีการยกเลิกการปฏิเสธการชำระเงินแบบย้อนหลัง ในกรณีนี้ คุณควรคืนสินค้าในเกมให้กับผู้บริโภคหากทำได้ เนื่องจากคุณจะได้รับเงินสำหรับการชำระเงินในครั้งนี้แล้ว `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_taxed` หรือ `already_paid` ช่องนี้จะถูกเว้นไว้	`string`
`items`	สินค้าที่เชื่อมโยงกับการชำระเงิน	อ็อบเจ็กต์[]
`type`	ประเภทของสินค้านี้	`enum{IN_APP_PURCHASE, SUBSCRIPTION}`
`product`	URL สินค้าของสินค้านี้	`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_taxed` หรือ `already_paid` ช่องนี้จะถูกเว้นไว้	`string`
`created_time`	เวลาที่สร้างการชำระเงินขึ้นเป็นครั้งแรก	`string`
`payout_foreign_exchange_rate`	อัตราแลกเปลี่ยนที่ใช้คำนวณมูลค่ายอดเงินที่ได้รับซึ่งมีการส่งมอบเป็น USD	`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}