Báo cáo thanh toán

Nếu đã phát triển các ứng dụng có dùng tính năng thanh toán và đăng ký trên Facebook, bạn có thể sử dụng tính năng báo cáo của dịch vụ thanh toán trên Facebook để yêu cầu chúng tôi gửi báo cáo phân tích chi tiết hoạt động thanh toán trong ứng dụng của bạn vào một ngày cụ thể.

Tổng quan

Tài liệu này nêu chi tiết nội dung của báo cáo, mô tả API dùng để yêu cầu báo cáo và trình bày về định dạng báo cáo.

Tải báo cáo hàng ngày xuống
Nội dung trong báo cáo
Thời điểm yêu cầu báo cáo
Tải báo cáo hàng ngày xuống qua API
Định dạng của báo cáo hàng ngày
Tiêu đề báo cáo
Tiêu đề phần
Tiêu đề cột
Dữ liệu phần
Chân trang phần
Chân trang báo cáo
Báo cáo mẫu

Báo cáo thanh toán chỉ hiển thị giao dịch mua hàng trong ứng dụng, chứ không hiển thị doanh thu trên Facebook Audience Network. Để tạo báo cáo thanh toán cho các ứng dụng trên Audience Network, vui lòng xem tài liệu tham khảo API Báo cáo trên Audience Network.

Tải báo cáo hàng ngày xuống

Để tải báo cáo hàng ngày xuống cho ứng dụng của bạn, quản trị viên của doanh nghiệp có thể truy cập vào trang cài đặt cho công ty, chọn công ty mà họ muốn nhận báo cáo rồi chuyển đến tab Báo cáo. Trên trang này, họ có thể chọn Ngày báo cáo bằng công cụ lịch và Loại báo cáo trong menu thả xuống cho báo cáo mà bạn muốn tải xuống.

Ngoài ra, quản trị viên cũng có thể truy cập vào trang cài đặt cho công ty bằng cách chuyển đến:

Đối với Game trên Canvas: Thanh toán trên web > Thanh toán trên web > Công ty > Xem/Chỉnh sửa
Đối với Trò chơi tức thì: Mua hàng trong ứng dụng > Tài khoản > Chuyển đến trang Cài đặt cho công ty

Sau khi bạn chọn các tùy chọn nêu trên, hãy nhấp vào Tải xuống để bắt đầu tải báo cáo hàng ngày xuống cho công ty của bạn.

Báo cáo cho Trò chơi tức thì sẽ hiển thị riêng biệt dưới dạng Báo cáo tóm tắt về Trò chơi tức thì và Chi tiết về Trò chơi tức thì.

Báo cáo cho Trò chơi tức thì cũng được dùng cho Game trên đám mây.

Nội dung trong báo cáo

Mỗi báo cáo trình bày về mọi giao dịch thanh toán cho cùng một công ty diễn ra trên tất cả ứng dụng trong khoảng thời gian 1 ngày, từ 00:00 đến 23:59:59 theo giờ Thái Bình Dương của Hoa Kỳ (UTC -8/-7).

Bạn có thể yêu cầu 2 báo cáo riêng biệt cho một ngày cụ thể bất kỳ.

Báo cáo detail có một phần ghi chép cho từng giao dịch riêng lẻ - tức là cho từng giao dịch bán hàng, từng giao dịch hoàn tiền, v.v. Báo cáo chi tiết ghi chép giao dịch thanh toán dưới góc nhìn của Facebook.
Báo cáo digest tóm tắt mọi giao dịch thuộc một loại nhất định của một ứng dụng cụ thể.

Báo cáo về Trò chơi tức thì cũng tương tự nhưng có tên gọi khác:

Báo cáo ig_detail có một phần ghi chép cho từng loại giao dịch riêng lẻ - tức là cho từng giao dịch bán hàng, từng giao dịch hoàn tiền, v.v.
Báo cáo ig_digest tóm tắt mọi giao dịch thuộc một loại nhất định của một Trò chơi tức thì cụ thể.

Hiện tại, báo cáo thanh toán có 2 phần. Tuy nhiên, bạn không nên chỉ áp dụng cách trình bày này khi viết trình phân tích cú pháp, vì định dạng báo cáo được thiết kế để dễ dàng mở rộng.

Một phần - có tên là credits_digest hoặc credits_detail, tùy thuộc vào báo cáo bạn đang đọc - trình bày về mọi giao dịch sử dụng tính năng Tín dụng Facebook và bao gồm tất cả giao dịch mua hàng trong game diễn ra thông qua hành động buy_item trong hộp thoại Thanh toán. Phần này đã ngừng hoạt động do nhà phát triển không thể nhận khoản thanh toán bằng Tín dụng Facebook nữa.
Phần còn lại - payment_digest hoặc payment_detail - trình bày về các giao dịch sử dụng tính năng thanh toán trên Facebook, cụ thể là Gói đăng ký và Thanh toán.

Thời điểm yêu cầu báo cáo

Chúng tôi tạo báo cáo mới một lần mỗi ngày và cung cấp báo cáo vào buổi trưa theo giờ Thái Bình Dương của Hoa Kỳ (UTC -8/-7). Do đó, ngày gần đây nhất có báo cáo thường là ngày trước ngày có yêu cầu. Đối với Trò chơi tức thì, độ trễ là 2 ngày.

Bạn có thể tải báo cáo thanh toán xuống trong vòng 45 ngày.

Tải báo cáo hàng ngày xuống qua API

Báo cáo thanh toán được cung cấp thông qua API dựa trên web. Với API này, bạn có thể yêu cầu báo cáo tóm tắt hoặc báo cáo có độ chi tiết cao về các giao dịch diễn ra trong một ngày đã chọn.

Hãy làm theo 3 bước sau đây để tải báo cáo:

Lấy ID và khóa bí mật của công ty
Lấy Company access_token
Tải file báo cáo xuống

Lấy ID và khóa bí mật của công ty

Trước khi thực hiện, bạn sẽ cần đảm bảo rằng mình đã bật tính năng thanh toán cho ứng dụng, bao gồm cả việc thiết lập một công ty để nhận các khoản thanh toán.

Sau khi hoàn tất việc đó, bạn sẽ tìm thấy ID và khóa bí mật của công ty mình ở tab Thông tin đăng nhập trên trang Cài đặt cho công ty.

Mỗi công ty chỉ cần có một cặp ID/khóa bí mật. Cặp ID/khóa bí mật này được dùng chung cho mọi ứng dụng của công ty đó. Bạn sẽ cần những thông tin đăng nhập này để có thể lấy access_token cần thiết cho việc tải xuống báo cáo giao dịch hàng ngày của ứng dụng.

Lấy `Company Access Token`

Với Company Access Token, bạn có thể truy cập vào báo cáo của mọi ứng dụng được liên kết với công ty mà mã truy cập được cấp thay mặt họ. Để lấy mã truy cập, hãy gửi yêu cầu GET đến

https://graph.facebook.com/oauth/access_token?

với các thông số truy vấn sau đây:

Tên	Loại	Giá trị
`client_id`	Integer	ID công ty của bạn
`client_secret`	String	Khóa bí mật của công ty bạn
`grant_type`	String	`client_credentials

Mã này sẽ không hết hạn trừ khi bạn đặt lại khóa bí mật của công ty. Do đó, bạn phải lưu trữ và sử dụng lại mã này, thay vì tạo mã mới mỗi lần yêu cầu báo cáo.

Ví dụ về yêu cầu `access_token` của công ty

Yêu cầu mẫu:

https://graph.facebook.com/oauth/access_token?
                                 client_id=COMPANY_ID&amp;
                                 client_secret=COMPANY_SECRET&amp;
                                 grant_type=client_credentials

Phản hồi mẫu từ Facebook:

access_token=230001349987723|aBc_dEFaEUZberrtkrp8pbtwXyZ

Tải file hàng ngày xuống

Sau khi đã có access_token của công ty, bạn có thể dùng mã này để yêu cầu file báo cáo hàng ngày trình bày về mọi ứng dụng của công ty bạn. Như đã nói ở trên, chúng tôi tạo ra 2 loại báo cáo:

Báo cáo digest chứa một hàng dữ liệu cho từng cặp loại ứng dụng-giao dịch, tóm tắt về giao dịch bán hàng, giao dịch hoàn tiền và những sự kiện giao dịch khác của từng ứng dụng
Đúng như tên gọi, trong báo cáo detail, mỗi giao dịch riêng lẻ được trình bày chi tiết trong một hàng

Để tải file báo cáo xuống cho ngày bất kỳ, hãy gửi yêu cầu GET đến

https://paymentreports.facebook.com/COMPANY_ID/report?

Với các thông số truy vấn sau đây:

Tên	Loại	Giá trị
`date`	String	Ngày tải báo cáo xuống, ở định dạng YYYY-MM-DD
`type`	String	Một trong các báo cáo `detail`, `digest` (game trên web) hoặc `ig_detail`, `ig_digest` (Trò chơi tức thì)
`access_token`	String	Mã truy cập của công ty bạn

Như đã nói ở trên, bạn không thể đặt date là ngày hiện tại. Báo cáo của một ngày cụ thể sẽ có sau 8:00 theo giờ Thái Bình Dương của Hoa Kỳ (UTC -8/-7) vào ngày tiếp theo.

Ví dụ về yêu cầu báo cáo hàng ngày

Mẫu yêu cầu báo cáo detail hàng ngày của nhà phát triển:

wget "https://paymentreports.facebook.com/23459934998762/report?
                                          date=2012-05-15&amp;
                                          type=detail&amp;                                     access_token=234599349987627|aBc_dEFaEUZbqpatkrp8pbtwXyZ"

Yêu cầu ở trên sẽ trả về một file có tên là 23459934998762_detail_2012-05-15.csv.zip.

Mẫu yêu cầu báo cáo digest của nhà phát triển:

wget "https://paymentreports.facebook.com/23459934998762/report?
                                          date=2012-05-15&amp;
                                          type=digest&amp;
                                          access_token=23459934998762|aBc_dEFaEUZbqpatkrp8pbtwXyZ"

Yêu cầu ở trên sẽ trả về một file có tên là 23459934998762_digest_2012-05-15.csv.zip.

Định dạng báo cáo

Mọi báo cáo đều có chung cấu trúc tổng thể như sau:

Báo cáo là các file văn bản (CSV) có giá trị được phân tách bằng dấu phẩy.
Ký tự phân tách giữa các dòng là "\n" (dòng mới), theo kiểu Unix.
Các trường có dấu phẩy sẽ được đặt trong dấu ngoặc kép để dễ nhập vào Excel.
Cột đầu tiên của mỗi hàng là mã loại hàng. Mã này xác định cách diễn giải các cột còn lại.
Báo cáo có 6 loại hàng, theo cấu trúc như sau:
Một tiêu đề báo cáo (mã loại RH)
Một hoặc nhiều phần, mỗi phần bao gồm
Một tiêu đề phần (SH)
Một tiêu đề cột (CH)
Không hoặc nhiều hàng dữ liệu phần (SD)
Một chân trang phần (SF)
Một chân trang báo cáo (RF)

Cấu trúc có thể được minh họa như sau:

RH,     ...

  SH,   ...
    CH, ...
    SD, ...
    [More section data rows]
  SF,   ...

  SH,   ...
    CH, ...
    SD, ...
    [More section data rows]
  SF,   ...

  [Possibly more sections]

RF,     ...

Lưu ý rằng phần thụt lề và giãn dòng ở trên chỉ để dễ đọc hơn. Trên thực tế, báo cáo không thụt lề và chỉ giãn dòng nếu dữ liệu trong các trường có giãn dòng.

Bạn có thể xem các ví dụ có trường điền đầy đủ thông tin tại phần file mẫu ở cuối tài liệu này.

Tiêu đề báo cáo (`RH`)

Hàng đầu tiên là tiêu đề báo cáo, chứa dữ liệu áp dụng cho mọi hàng bên dưới hàng đó, kéo dài đến chân trang báo cáo tiếp theo (đánh dấu phần cuối của báo cáo). Hàng RH chứa các trường sau đây:

Tên	Mô tả
company_id	ID công ty của nhà phát triển
report_type	Loại báo cáo, hiện tại là `daily_detail` hoặc `daily_digest`
start_time	Thời gian bắt đầu giai đoạn báo cáo, có định dạng là YYYY-MM-DD, MÚI GIỜ `00:00:00`
end_time	Thời gian kết thúc giai đoạn báo cáo, có định dạng là YYYY-MM-DD, MÚI GIỜ `23:59:59`
format_version	`1`

Ví dụ về tiêu đề báo cáo

Hàng mẫu:

RH,213030545409781,daily_detail,2011-11-21 00:00:00 PST,2011-11-21 23:59:59 PST,1

Cách đọc hàng mẫu:

Cột	Giá trị	Mô tả
1	`RH`	loại hàng: tiêu đề báo cáo
2	`213030545409781`	ID công ty
3	`daily_detail`	cho biết đây là báo cáo `detail`
4	`2011-11-21 00:00:00 PST`	thời gian bắt đầu của báo cáo này
5	`2011-11-21 23:59:59 PST`	thời gian kết thúc
6	`1`	phiên bản sơ đồ báo cáo

Tiêu đề phần (`SH`)

Mọi hàng giữa tiêu đề và chân trang báo cáo đều nằm trong một phần. Mỗi phần trong báo cáo được giới thiệu bằng một tiêu đề phần; nội dung phần bắt đầu từ tiêu đề cho đến chân trang phần tiếp theo. Hàng SH chứa các trường sau đây:

Tên	Giá trị
company_id	ID công ty của nhà phát triển
section_type	Hiện tại là `credits_detail`, `credits_digest`, `payment_detail` hoặc `payment_digest`

Ví dụ về tiêu đề phần

Hàng mẫu:

SH,213030545409781,payment_detail

Cách đọc hàng mẫu:

Cột	Giá trị	Mô tả
1	`SH`	loại hàng: tiêu đề phần
2	`213030545409781`	ID công ty
3	`payment_detail`	đây là tiêu đề của phần `payment_detail`

Tiêu đề cột (`CH`)

Theo sau mỗi tiêu đề phần là một tiêu đề cột cung cấp tên trường cho các hàng dữ liệu phần của phần đó. Mỗi loại phần đều có các trường khác nhau. Bạn phải đọc hàng CH để biết tên các trường trong mỗi phần. Bạn có thể dễ dàng mở rộng định dạng báo cáo bằng cách cập nhật nội dung tự mô tả của định dạng. Do đó, thứ tự cột hoặc quy cách của phần có thể thay đổi theo cách khiến mọi giải pháp phân tích cú pháp mã hóa cứng bị mất hiệu lực.

Ví dụ về tiêu đề cột

Ví dụ về một hàng CH trong phần payment_detail:

CH,app_id,payment_type,product_type,payment_id,time_completed,recv_currency,recv_amount,fx_batch_id,fx_rate,settle_currency,reference_id,tax_country

Ví dụ về một hàng CH trong phần payment_digest:

CH,app_id,app_name,payment_type,product_type,recv_currency,
,fx_batch_id,fx_rate,settle_currency,settle_amount

Dữ liệu phần (`SD`)

Theo sau tiêu đề cột của một phần là không hoặc nhiều hàng section data lấy tên trường từ hàng CH. Ý nghĩa của những hàng này phụ thuộc vào loại phần: trong các phần detail, mỗi hàng là một giao dịch và trong các phần digest, mỗi hàng là tổng của tất cả giao dịch thuộc một loại nhất định trong một ứng dụng cụ thể (ví dụ: "tất cả giao dịch bán hàng trong ứng dụng có ID 276999562313463", "tất cả giao dịch hoàn tiền đăng ký tính bằng đồng yên Nhật trong ứng dụng có ID 276899562313544"). Hiện có 4 loại phần, như giải thích bên dưới.

Ví dụ về dữ liệu phần

Phần credits_detail và credits_digest hiện đã ngừng hoạt động do các ứng dụng không còn khả năng tạo giao dịch thanh toán bằng Tín dụng Facebook.

Hàng `SD` trong phần `payment_detail`

Trường:

Tên	Mô tả
`app_id`	ID của ứng dụng diễn ra giao dịch.
`payment_type`	một trong các mã bên dưới: S: Bán hàng R: Hoàn tiền C: Yêu cầu hoàn tiền D: Yêu cầu hoàn tiền ngoài thời hạn cho phép K: Hủy bỏ yêu cầu hoàn tiền J: Hủy bỏ yêu cầu hoàn tiền ngoài thời hạn cho phép N: Từ chối Khi tính toán doanh thu, mã này tương ứng với các hệ số sau đây: S => 1, R => -1, C => -1, D => 0, K => 1, J => 0, N => -1
`product_type`	"S" biểu thị gói đăng ký, còn "P" biểu thị Khoản thanh toán.
`payment_id`	ID duy nhất của khoản thanh toán, tương tự như `txn_id` trong trường hợp `credits_detail`.
`time_completed`	nhãn thời gian giao dịch hoàn tất, có định dạng là YYYY-MM-DD, múi giờ HH:MM:SS.
`recv_currency`	đơn vị tiền tệ mà người mua hàng thanh toán, được biểu thị dưới dạng mã gồm 3 chữ cái theo tiêu chuẩn ISO 4217.
`recv_amount`	Số tiền ròng tính theo đơn vị tiền tệ đó, bao gồm cả tiền thuế. Đây có thể không phải là số tiền mà nhà phát triển nhận được vì còn phải trừ đi phần chia sẻ doanh thu của Facebook. Để biết số tiền thanh toán cuối cùng, hãy xem báo cáo thanh toán của bạn.
`fx_batch_id`	ID duy nhất của loạt tỷ giá hối đoái dùng để xử lý giao dịch này.
`fx_rate`	tỷ giá hối đoái mà một đơn vị `recv_currency` mua `settle_currency` theo `fx_batch_id` đó.
`settle_currency`	đơn vị tiền tệ mà nhà phát triển nhận thanh toán, được biểu thị dưới dạng mã gồm 3 chữ cái theo tiêu chuẩn ISO 4217. Hiện tại, trường này luôn hiển thị là USD.
`reference_id`	ID thỏa thuận lập hóa đơn cho gói đăng ký và request_id cho khoản thanh toán.
`tax_country`	quốc gia nơi khách hàng thực hiện giao dịch mua hàng, được cung cấp dưới dạng mã quốc gia theo tiêu chuẩn ISO 3166-1 alpha-2.
`tax_amount`	số tiền thuế VAT hoặc Thuế bán hàng thực tế mà Facebook nộp thay mặt bạn bằng đơn vị tiền tệ được sử dụng trong giao dịch.
`platform`	Chỉ dành cho báo cáo `ig_detail`. `'F'` tương ứng với giao dịch mua hàng qua Facebook Pay, còn `'G'` tương ứng với giao dịch mua hàng qua Google Play.
`platform_fee`	Chỉ dành cho báo cáo `ig_detail`. Đây là phí nền tảng do các nền tảng không phải là Facebook thu. Đối với Facebook, thỏa thuận chia sẻ doanh thu vẫn được áp dụng và sẽ không được bao gồm trong khoản phí này.

Hàng mẫu cho gói đăng ký:

SD,266989143414,S,S,267668373345994,2012-07-22 00:07:23 PDT,USD,19.99,123456789ABCDEF00123456789ABCDEF,1.0000000000,USD,20000000007,US,0.99

Cách đọc hàng mẫu cho gói đăng ký:

Cột	Giá trị	Mô tả
1	`SD`	loại hàng: dữ liệu phần
2	`266989143414`	`app_id` nơi diễn ra giao dịch thanh toán
3	`S`	giao dịch là bán hàng
4	`S`	sản phẩm bán ra là gói đăng ký
5	`267668373345994`	ID của giao dịch bán hàng
6	`2012-07-22 00:07:23 PDT`	thời gian hoàn tất quá trình xử lý thanh toán
7	`USD`	người mua hàng thanh toán bằng đô la Mỹ
8	`19.99`	người mua hàng thanh toán 19,99 USD
9	`123456789ABCDEF00123456789ABCDEF`	ID của loạt tỷ giá hối đoái
10	`1.0000000000`	tỷ giá hối đoái khi đổi từ USD sang USD
11	`USD`	nhà phát triển nhận thanh toán bằng đô la Mỹ
12	`20000000007`	khoản thanh toán này nằm trong `history` của thỏa thuận lập hóa đơn cho gói đăng ký 20000000007
13	`US`	người mua hàng sống tại Hoa Kỳ
14	`0.99`	số tiền thuế VAT thực tế được nộp thay mặt bạn

Hàng mẫu cho khoản thanh toán:

SD,480369938658210,S,P,362736900505327,2013-06-12 16:33:52 PDT,USD,1,6E5D989082A04A68AA801DB17A30721A,1,USD,QQ6C7XaxeMyCW4RdZXFGwKTQM1IkMBIOpeWtFFJelHUdSC9NaeYlBXEMJd3LO17k,US,0.09

Cách đọc hàng mẫu cho khoản thanh toán:

Cột	Giá trị	Mô tả
1	`SD`	loại hàng: dữ liệu phần
2	`480369938658210`	`app_id` nơi diễn ra giao dịch thanh toán
3	`S`	giao dịch là bán hàng
4	`P`	giao dịch là từ hoạt động thanh toán
5	`362736900505327`	ID thanh toán của giao dịch bán hàng
6	`2013-06-12 16:33:52 PDT`	thời gian hoàn tất quá trình xử lý thanh toán
7	`USD`	người mua hàng thanh toán bằng đô la Mỹ
8	`1`	người mua hàng thanh toán 1 USD
9	`6E5D989082A04A68AA801DB17A30721A`	ID của loạt tỷ giá hối đoái
10	`1.0000000000`	tỷ giá hối đoái khi đổi từ USD sang USD
11	`USD`	nhà phát triển nhận thanh toán bằng đô la Mỹ
12	`QQ6C7XaxeMyCW4RdZXFGwKTQM1IkMBIO-peWtFFJelHUdSC9NaeYlBXEMJd3LO17k`	`request_id` của ứng dụng thực hiện giao dịch thanh toán này
13	`US`	người mua hàng sống tại Hoa Kỳ
14	`0.09`	số tiền thuế VAT thực tế được nộp thay mặt bạn

Hàng `SD` trong phần `payment_digest`

Trường:

Tên	Mô tả
`app_id`	`app_id` có các khoản thanh toán đang được tóm tắt
`app_name`	tên của ứng dụng đó
`payment_type`	một trong các mã bên dưới: S: Bán hàng R: Hoàn tiền C: Yêu cầu hoàn tiền D: yêu cầu hoàn tiền ngoài thời hạn cho phép K: hủy bỏ yêu cầu hoàn tiền J: hủy bỏ yêu cầu hoàn tiền ngoài thời hạn cho phép N: Từ chối
`product_type`	"S" biểu thị gói đăng ký, còn "P" biểu thị Khoản thanh toán
`recv_currency`	đơn vị tiền tệ được tóm tắt của bên thanh toán, được biểu thị dưới dạng mã gồm 3 chữ cái theo tiêu chuẩn ISO 4217
`recv_amount`	tổng số tiền tính theo đơn vị tiền tệ đó liên quan đến các khoản thanh toán thuộc loại hiện tại trong một loạt tỷ giá hối đoái cụ thể
`fx_batch_id`	ID của loạt tỷ giá hối đoái đó
`fx_rate`	tỷ giá hối đoái mà một `recv_currency` mua `settle_currency` theo `fx_batch_id` đó
`settle_currency`	đơn vị tiền tệ mà nhà phát triển nhận thanh toán, được biểu thị dưới dạng mã gồm 3 chữ cái theo tiêu chuẩn ISO 4217
`settle_amount`	tổng số tiền tính theo đơn vị tiền tệ đó khớp với ứng dụng, loại thanh toán, loại sản phẩm, đơn vị tiền tệ và loạt tỷ giá hối đoái trong giai đoạn báo cáo
`tax_amount`	số tiền thuế VAT hoặc Thuế bán hàng thực tế mà Facebook nộp thay mặt bạn

Hàng mẫu cho gói đăng ký:

SD,200000000000002,Game2,S,S,CNY,5000.0,FXBATCHID1,0.2,USD,1000.0,9.99

Cách đọc hàng mẫu cho gói đăng ký:

Cột	Giá trị	Mô tả
1	`SD`	loại hàng: dữ liệu phần
2	`200000000000002`	xem xét ứng dụng có ID 200000000000002
3	`Game2`	...có tên "Game2"
4	`S`	...xem xét mọi giao dịch bán hàng
5	`S`	...của gói đăng ký
6	`CNY`	...được thanh toán bằng đồng Nhân dân tệ Trung Quốc (nhân dân tệ)
7	`5000.0`	...và có tổng giá trị là 5.000 CNY
8	`FXBATCHID1`	...được quy đổi theo FXBATCHID1
9	`0.2`	...theo tỷ giá 1 CNY = 0,2 USD
10	`USD`	nhà phát triển nhận thanh toán bằng USD
11	`1000.0`	tổng: "Game2 đạt doanh thu 1.000 USD trong giai đoạn báo cáo, từ tất cả những người đã mua gói đăng ký bằng đồng Nhân dân tệ Trung Quốc (nhân dân tệ) trong FXBATCHID1"
12	`9.99`	số tiền thuế VAT thực tế được nộp thay mặt bạn là 9,99

Hàng mẫu cho khoản thanh toán:

SD,900000000000009,Game9,S,P,CNY,5000.0,FXBATCHID1,0.2,USD,1000.0,9.99

Cách đọc hàng mẫu cho khoản thanh toán:

Cột	Giá trị	Mô tả
1	`SD`	loại hàng: dữ liệu phần
2	`200000000000002`	xem xét ứng dụng có ID 900000000000009
3	`Game9`	...có tên "Game9"
4	`S`	...xem xét mọi giao dịch bán hàng
5	`P`	...của khoản thanh toán
6	`CNY`	...được yêu cầu bằng đồng Nhân dân tệ Trung Quốc (nhân dân tệ)
7	`5000.0`	...và có tổng giá trị là 5.000 CNY
8	`FXBATCHID1`	...được quy đổi theo FXBATCHID1
9	`0.2`	...theo tỷ giá 1 CNY = 0,2 USD
10	`USD`	nhà phát triển nhận thanh toán bằng USD
11	`1000.0`	tổng: "Game2 đạt doanh thu 1.000 USD trong giai đoạn báo cáo, từ tất cả những người đã mua vật phẩm trong ứng dụng và thanh toán bằng đồng Nhân dân tệ Trung Quốc (nhân dân tệ) trong FXBATCHID1"
12	`9.99`	số tiền thuế VAT thực tế được nộp thay mặt bạn là 9,99

Chân trang phần (`SF`)

Mỗi phần kết thúc bằng một hàng Chân trang phần. Theo sau hàng này có thể là một phần mới (bắt đầu bằng hàng SH) hoặc hàng Chân trang báo cáo (cho biết phần cuối của báo cáo). Một cột dữ liệu theo sau trường loại gồm có:

Tên	Mô tả
`number_of_total_data_rows`	Tổng số hàng dữ liệu phần có trong phần này của báo cáo

Ví dụ về Chân trang phần

Hàng mẫu:

SF,7

Cách đọc hàng mẫu:

Cột	Giá trị	Mô tả
1	`SF`	loại hàng: chân trang phần
2	`7`	phần này bao gồm 7 hàng `SD`

Chân trang báo cáo (`RF`)

Báo cáo sẽ kết thúc bằng hàng Chân trang báo cáo. Đây sẽ là hàng cuối cùng trong file. Theo sau cột loại là 2 loại dữ liệu tóm tắt:

Tên	Mô tả
`number_of_sections`	tổng số hàng tiêu đề phần trong báo cáo này
`number_of_total_data_rows`	Tổng số hàng dữ liệu phần có trong tất cả các phần của báo cáo này

Ví dụ về Chân trang báo cáo

Hàng mẫu:

RF,2,7

Cách đọc hàng mẫu:

Cột	Giá trị	Mô tả
1	`RF`	loại hàng: chân trang báo cáo
2	`2`	báo cáo này có 2 hàng `SH`
3	`7`	báo cáo này có 7 hàng `SD` của tất cả các phần

Báo cáo mẫu

Hãy đọc các mẫu dưới đây theo hướng dẫn ở trên. Ngoài ra, vui lòng lưu ý những điểm sau:

Các dòng ở đầu mỗi báo cáo mẫu là tiêu đề chung của báo cáo.
Khối văn bản tiếp theo chứa phần credits_detail hoặc _digest.
Khối văn bản sau đó (ở ngay phía trên chân trang) chứa phần payment_detail hoặc payment_digest.
Các dòng ở cuối mẫu là chân trang chung của báo cáo.

Báo cáo `detail` mẫu

RH,10808080808080808,daily_detail,2012-04-24 00:00:00 PDT,2012-04-24 23:59:59 PDT,1

SH,10808080808080808,credits_detail
CH,app_id,txn_type,txn_id,order_id,txn_time,value,credits

SH,10808080808080808,payment_detail
CH,app_id,payment_type,product_type,payment_id,time_completed,recv_currency,recv_amount,fx_batch_id,fx_rate,settle_currency,reference_id,tax_country
SD,266989143414,S,S,267668373345994,2012-07-22 00:07:23 PDT,USD,19.99,123456789ABCDEF00123456789ABCDEF,1.0000000000,USD,20000000007,US
SD,266989143414,S,S,272014936246430,2012-07-22 00:08:18 PDT,USD,21.09,123456789ABCDEF00123456789ABCDEF,1.0000000000,USD,20000000008,US
SD,266989143414,S,S,272990136150221,2012-07-22 00:09:18  PDT,USD,22.99,123456789ABCDEF00123456789ABCDEF,1.0000000000,USD,20000000009,CY
SD,266989143414,S,S,278092248972451,2012-07-22 00:08:34 PDT,USD,19.99,123456789ABCDEF00123456789ABCDEF,1.0000000000,USD,20000000010,US 
SD,266989143414,S,P,376727629107629,2012-07-22 00:08:34 PDT,USD,19.99,123456789ABCDEF00123456789ABCDEF,1.0000000000,USD,20000000010,US 
SF,4 

RF,2,13

Báo cáo `digest` mẫu

RH,108080808080808,daily_digest,2012-04-25 00:00:00 PDT,2012-04-25 23:59:59 PDT,1

SH,108080808080808,credits_digest
CH,app_id,app_name,txn_type,value,credits

SH,108080808080808,payment_digest
CH,app_id,app_name,payment_type,product_type,recv_currency,recv_amount,fx_batch_id,fx_rate,settle_currency,settle_amount
SD,200000000000002,Game2,S,S,CNY,5000.0,FXBATCHID1,0.2,USD,1000.0
SD,200000000000002,Game2,R,S,CNY,2000.0,FXBATCHID1,0.2,USD,400.0
SD,200000000000002,Game2,S,P,CNY,1000.0,FXBATCHID1,0.2,USD,200.0
SF,2

RF,2,5

Tính toán

Để giúp tính toán doanh thu ròng cho nhà phát triển, vui lòng tham khảo thông tin sau đây.

Giao dịch mua hàng qua Facebook Pay

Loại giao dịch mua hàng này được biểu thị bằng giao dịch có platform bằng "F" trong báo cáo ig_detail hoặc tất cả giao dịch trong báo cáo detail.

Giả sử tax_country là "US" (Hoa Kỳ) thì giao dịch mua hàng sẽ không bao gồm thuế và công thức tính toán như sau:
net_developer_revenue = (recv_amount - tax_amount) * fx_rate * rev_share

Nếu không, giả sử giao dịch mua hàng đã bao gồm thuế và công thức tính toán như sau:
net_developer_revenue = (recv_amount * fx_rate) * rev_share - (tax_amount * fx_rate)

Giao dịch mua hàng qua Google Play

Loại giao dịch mua hàng này được biểu thị bằng giao dịch có platform bằng "G" trong báo cáo ig_detail.

Công thức tính toán như sau:
net_developer_revenue = recv_amount * fx_rate

Lưu ý: đây chỉ là ước tính dựa trên dữ liệu thanh toán; phí bổ sung có thể được áp dụng trước khi thanh toán. Nội dung cập nhật báo cáo trong tương lai sẽ giúp tính toán chính xác và dễ dàng hơn.

Báo cáo thanh toán

Tổng quan

Tải báo cáo hàng ngày xuống

Nội dung trong báo cáo

Thời điểm yêu cầu báo cáo

Tải báo cáo hàng ngày xuống qua API

Lấy ID và khóa bí mật của công ty

Lấy Company Access Token

Ví dụ về yêu cầu access_token của công ty

Tải file hàng ngày xuống

Ví dụ về yêu cầu báo cáo hàng ngày

Định dạng báo cáo

Tiêu đề báo cáo (RH)

Ví dụ về tiêu đề báo cáo

Tiêu đề phần (SH)

Ví dụ về tiêu đề phần

Tiêu đề cột (CH)

Ví dụ về tiêu đề cột

Dữ liệu phần (SD)

Ví dụ về dữ liệu phần

Hàng SD trong phần payment_detail

Hàng SD trong phần payment_digest

Chân trang phần (SF)

Ví dụ về Chân trang phần

Chân trang báo cáo (RF)

Ví dụ về Chân trang báo cáo

Báo cáo mẫu

Báo cáo detail mẫu

Báo cáo digest mẫu

Tính toán

Giao dịch mua hàng qua Facebook Pay

Giao dịch mua hàng qua Google Play

Lấy `Company Access Token`

Ví dụ về yêu cầu `access_token` của công ty

Tiêu đề báo cáo (`RH`)

Tiêu đề phần (`SH`)

Tiêu đề cột (`CH`)

Dữ liệu phần (`SD`)

Hàng `SD` trong phần `payment_detail`

Hàng `SD` trong phần `payment_digest`

Chân trang phần (`SF`)

Chân trang báo cáo (`RF`)

Báo cáo `detail` mẫu

Báo cáo `digest` mẫu