Laporan Pembayaran

Ringkasan

Dokumen ini memerinci konten laporan, menjelaskan API untuk meminta laporan, dan memaparkan format penyampaian laporan.

• Mengunduh laporan harian
• Isi laporan
• Kapan waktunya meminta laporan
• Mengunduh laporan harian melalui API
• Format laporan harian
• Header laporan
• Header bagian
• Header kolom
• Data bagian
• Footer bagian
• Footer laporan
• Contoh laporan

Mengunduh laporan harian

Untuk mengunduh laporan harian bagi aplikasi Anda, admin bisnis dapat membuka halaman pengaturan perusahaan mereka, pilih perusahaan yang Anda ingin dapatkan laporannya dan buka tab Laporan. Pada halaman ini, mereka dapat memilih Tanggal Laporan dengan fitur kalender dan Jenis Laporan dari menu pilihan untuk laporan yang ingin Anda unduh.

Sebagai alternatif, admin juga bisa masuk ke pengaturan perusahaan dengan membuka:

• Untuk Game Canvas: Pembayaran Web > Pembayaran Web > Perusahaan > Lihat/Edit
• Untuk Game Instan: Pembelian dalam aplikasi > Akun > Buka Pengaturan Perusahaan

Setelah memilih opsi ini, klik Unduh guna mulai mengunduh laporan harian untuk perusahaan Anda.

Isi laporan

Setiap laporan mencakup satu hari, dari pukul 00.00-23.59.59 Waktu Pasifik AS (UTC -8/-7), dan mencakup semua transaksi di semua aplikasi yang membayar ke perusahaan yang sama pada hari tersebut.

Untuk hari tertentu, ada 2 laporan terpisah yang bisa Anda minta.

• Laporan detail memiliki satu catatan untuk setiap transaksi individu—yaitu: untuk setiap penjualan, setiap pengembalian dana, dan sebagainya. Detail laporan adalah dibayar dari perspektif Meta.
• Laporan digest merangkum semua transaksi jenis tertentu untuk aplikasi tertentu.

Laporan Game Instan serupa tetapi memiliki nama yang berbeda:

• Laporan ig_detail memiliki satu catatan untuk setiap transaksi individu—yaitu: untuk setiap penjualan, setiap pengembalian dana, dan sebagainya.
• Laporan ig_digest merangkum semua transaksi jenis tertentu untuk Game Instan tertentu.

Saat ini, laporan pembayaran memiliki 2 bagian, meskipun Anda tidak boleh bergantung pada bagian ini ketika menulis parser, karena format laporan dirancang agar mudah dikembangkan.

• Satu bagian, credits_digest atau credits_detail bergantung pada laporan mana yang Anda baca, mencakup semua transaksi menggunakan fitur Kredit Facebook, dan mencakup semua pembelian dalam game yang dilakukan melalui tindakan buy_item dialog Bayar . Bagian ini telah dihentikan karena developer tidak bisa lagi menerima pembayaran di Kredit Facebook.

• Lainnya, payment_digest atau payment_detail, mencakup transaksi yang menggunakan fitur pembayaran Meta, yang disebut Langganan dan Pembayaran.

Kapan waktunya meminta laporan

Kami membuat laporan baru sekali sehari dan menyediakannya paling lambat tengah hari Waktu Pasifik AS (UTC -8/-7), jadi tanggal terbaru untuk laporan yang tersedia biasanya adalah hari sebelum permintaan. Untuk Game Instan, ada penundaan dua hari.

Mengunduh laporan harian melalui API

Laporan pembayaran tersedia melalui API berbasis web, yang memudahkan Anda meminta rangkuman atau laporan transaksi yang sangat mendetail selama hari yang dipilih.

Ada 3 langkah untuk mendapatkan laporan:

1. Dapatkan ID dan rahasia Perusahaan Anda
2. Dapatkan Company access_token
3. Unduh file laporan

Mendapatkan ID dan rahasia perusahaan Anda

Sebelum melanjutkan, Anda harus memastikan bahwa Anda telah mengaktifkan aplikasi untuk pembayaran, termasuk melakukan pengaturan pada perusahaan untuk menerima pembayaran.

Setelah melakukannya, Anda akan menemukan ID dan rahasia perusahaan di halaman Pengaturan Perusahaan, di tab Kredensial.

Hanya satu pasangan ID/rahasia yang diperlukan untuk perusahaan tertentu; ID/rahasia yang sama akan digunakan di semua aplikasi perusahaan. Anda membutuhkan kredensial ini agar bisa mendapatkan access_token yang diperlukan untuk mengunduh laporan transaksi harian untuk aplikasi Anda.

Mendapatkan Company Access Token

Dengan Company Access Token, Anda bisa mengakses laporan untuk semua aplikasi yang terkait dengan perusahaan atas nama token tersebut dikeluarkan. Untuk mendapatkannya, keluarkan permintaan GET ke

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

dengan parameter kueri berikut:

Token ini tidak akan kedaluwarsa kecuali Anda mereset rahasia perusahaan, sehingga Anda harus menyimpan dan menggunakannya kembali, alih-alih membuat yang baru setiap kali meminta laporan.

Contoh permintaan access_token perusahaan

Contoh permintaan:

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

Contoh tanggapan dari Meta:

access_token=230001349987723|aBc_dEFaEUZberrtkrp8pbtwXyZ

Mengunduh file harian

Setelah memiliki access_token perusahaan, Anda bisa menggunakannya untuk meminta file laporan harian yang mencakup semua aplikasi perusahaan Anda. Seperti yang disebutkan di atas, kami membuat 2 jenis laporan:

• Laporan digest berisi baris data untuk setiap pasangan aplikasi-jenis transaksi, merangkum penjualan, pengembalian dan, dan peristiwa transaksi lainnya untuk setiap aplikasi
• Laporan detail, seperti namanya, memiliki baris untuk setiap transaksi individu

Untuk mengunduh file laporan untuk hari apa pun, keluarkan permintaan GET ke

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

Dengan parameter kueri berikut:

Juga seperti yang disebutkan di atas, date tidak bisa berupa tanggal hari ini. Laporan hari tertentu tersedia setelah pukul 08.00 Waktu Pasifik AS (UTC -8/-7) pada hari berikutnya.

Contoh permintaan laporan harian

Contoh permintaan developer untuk laporan detail harian:

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

Permintaan di atas akan mengembalikan file yang bernama 23459934998762_detail_2012-05-15.csv.zip.

Contoh permintaan developer untuk laporan digest:

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

Permintaan di atas akan memberi Anda file yang bernama 23459934998762_digest_2012-05-15.csv.zip.

Format laporan

Semua laporan memiliki struktur yang sama secara keseluruhan:

• Laporan berupa file teks yang dipisahkan koma (comma-separated-value/CSV).
• Pemisah baris adalah "\n" (baris baru) bergaya UNIX.
• Kolom yang berisi koma akan diapit dengan tanda kutip ganda untuk memudahkan impor Excel.
• Kolom pertama setiap baris adalah kode jenis baris, yang menentukan cara penafsiran kolom lainnya.
• Laporan menggunakan 6 jenis baris, yang disusun sebagai berikut:
• Satu header laporan (kode jenis RH)
• Satu atau beberapa bagian, setiap bagian terdiri dari
• Satu header bagian (SH)
• Satu header kolom (CH)
• Nol atau beberapa baris data bagian (SD)
• Satu footer bagian (SF)
• Satu footer laporan (RF)

Strukturnya bisa divisualisasikan seperti ini:

RH,     ...

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

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

  [Possibly more sections]

RF,     ...

Perhatikan bahwa lekukan dan jarak spasi di atas adalah alat bantu untuk membaca; laporan aktual tidak memiliki lekukan, dan hanya memiliki spasi jika data di kolom memiliki spasi.

Contoh yang menyertakan kolom yang diisi sepenuhnya bisa ditemukan di bagian contoh file di akhir dokumen ini.

Header laporan (RH)

Baris pertama adalah header laporan, yang berisi data yang berlaku untuk semua baris di bawahnya, hingga footer laporan berikutnya, yang menandai akhir laporan. Baris RH berisi kolom-kolom ini:

Contoh header laporan

Contoh baris:

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

Cara membaca contoh baris:

Header bagian (SH)

Setiap baris antara header dan footer laporan adalah penggalan bagian. Setiap bagian laporan diperkenalkan oleh header bagian; bagian berjalan dari header ke footer bagian berikutnya. Baris SH berisi kolom-kolom berikut:

Contoh header bagian

Contoh baris:

SH,213030545409781,payment_detail

Cara membaca contoh baris:

Header kolom (CH)

Setiap header bagian diikuti dengan header kolom, yang memberi nama kolom untuk baris data bagian di bagian tersebut. Setiap jenis bagian memiliki kolom yang berbeda. Penting bagi Anda untuk membaca baris CH untuk mendapatkan nama kolom di setiap bagian. Format laporan mudah diperluas dengan memperbarui deskripsi mandirinya, jadi urutan kolom atau spesifikasi bagian bisa berubah dengan cara yang akan membatalkan solusi penguraian hard-coding.

Contoh header kolom

Contoh baris CH dari bagian 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

Contoh baris CH dari bagian payment_digest:

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

Data bagian (SD)

Setelah header kolom bagian, ada nol atau beberapa baris section data yang mengambil nama kolomnya dari baris CH. Arti baris bergantung pada jenis bagian: di bagian detail, setiap baris adalah transaksi tunggal dan di bagian digest, setiap baris adalah jumlah semua transaksi dari jenis tertentu dalam aplikasi tertentu (misalnya: "semua penjualan di ID aplikasi 276999562313463", "semua pengembalian dana langganan dalam yen Jepang di ID aplikasi 276899562313544"). Saat ini, ada 4 jenis bagian, dijelaskan di bawah ini.

Contoh data bagian

baris payment_detailSD

Kolom:

Contoh baris Langganan:

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

Cara membaca contoh baris langganan:

Baris contoh pembayaran:

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

Cara membaca baris contoh pembayaran:

baris payment_digestSD

Kolom:

Contoh baris Langganan:

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

Cara membaca contoh baris langganan:

Baris contoh pembayaran:

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

Cara membaca contoh baris pembayaran:

Footer Bagian (SF)

Setiap bagian diakhiri dengan baris Footer Bagian, yang dengan sendirinya bisa diikuti dengan bagian baru, yang dimulai dengan baris SH, atau dengan baris Footer Laporan, yang menunjukkan akhir laporan. Kolom tunggal data yang mengikuti kolom jenis berisi:

Contoh Footer Bagian

Contoh baris:

SF,7

Cara membaca contoh baris:

Footer laporan (RF)

Laporan ini diakhiri dengan baris Footer Laporan, yang harus menjadi baris terakhir dalam file tersebut. Bagian ini memiliki 2 data ringkasan yang mengikuti kolom jenisnya:

Contoh footer bagian

Contoh baris:

RF,2,7

Cara membaca contoh baris:

Contoh laporan

Baca contoh ini sesuai dengan petunjuk di atas. Selain itu, harap perhatikan hal berikut:

• Baris di bagian atas setiap contoh laporan adalah header laporan umum.
• Blok teks berikutnya berisi bagian credits_detail atau _digest.
• Blok teks setelahnya (hanya di atas footer) berisi bagian payment_detail atau payment_digest.
• Baris di bagian bawah contoh adalah footer laporan umum.

Contoh laporan detail

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

Contoh laporan digest

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

Perhitungan

Untuk membantu menghitung pendapatan bersih developer, gunakan informasi berikut.

Pembelian dengan Meta Pay

Ini dilambangkan pada transaksi dengan platform sama dengan "F" dalam laporan ig_detail atau semua transaksi dalam laporan detail.

Asumsikan bahwa tax_state dari "US" berarti pembelian tersebut tidak termasuk pajak dan perhitungannya mengikuti rumus ini:
net_developer_revenue = (recv_amount - tax_amount) * fx_rate * rev_share

Jika tidak, asumsikan bahwa pembelian sudah termasuk pajak dan perhitungannya mengikuti rumus ini:
net_developer_revenue = (recv_amount * fx_rate) * rev_share - (tax_amount * fx_rate)

Pembelian dengan Google Play

Ini dilambangkan pada transaksi platform sama dengan "G" dalam laporan ig_detail.

Perhitungannya mengikuti rumus ini:
net_developer_revenue = recv_amount * fx_rate

Catatan: ini hanyalah estimasi berdasarkan data pembayaran; biaya tambahan mungkin berlaku sebelum pembayaran. Pembaruan laporan di masa mendatang akan membuat perhitungan ini lebih tepat dan lebih mudah.