Versi Graph API

Pembayaran /{payment-id}

Detail pembayaran yang dilakukan dalam aplikasi menggunakan Pembayaran Facebook.

Membaca

Graph API Explorer
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
}];

Izin

  • Diperlukan token akses aplikasi untuk aplikasi yang membuat pembayaran.

Kolom

Nama Deskripsi Jenis

id

ID pembayaran

string

user

Nama depan dan nama belakang konsumen bersama dengan penggunanya id. Bisa diabaikan dalam beberapa kasus.

Pengguna

request_id

Pengidentifikasi unik yang dibuat aplikasi dan bersifat opsional yang diteruskan ke fungsi JS (maksimal 255 karakter)

string

application

Aplikasi yang terkait dengan pembayaran ini

Aplikasi

actions

Daftar berbagai jenis tindakan yang telah terjadi dalam pembayaran ini.

object[]

type

Jenis tindakan khusus ini. type dapat berupa:

  • charge: Ini menunjukkan jenis tindakan yang diambil pada pembayaran ini adalah tagih. Jika tagihan memiliki status selesai, maka Anda harus memenuhi pesanan.
  • refund: Jenis pengembalian dana menyatakan pembayaran telah dikembalikan dan barang yang dijual ke konsumen harus ditarik jika memungkinkan karena Anda tidak akan lagi dibayar untuk transaksi ini.
  • chargebackPengembalian uang dimulai oleh konsumen dengan banknya yang mempersengketakan pembayaran yang bersangkutan. Jika pengembalian uang terjadi, Anda harus menarik item dalam game dari pelanggan jika memungkinkan karena Anda tidak akan dibayar untuk pesanan ini.
  • chargeback_reversal: Chargeback_reversal terjadi ketika pengembalian uang dibalik secara retroaktif. Dalam hal ini, Anda harus mengembalikan item dalam game milik konsumen jika memungkinkan karena Anda sekarang akan dibayar untuk pembayaran ini.
  • declinePenolakan terjadi ketika sumber dana yang digunakan untuk membuat transaksi gabungan ditolak saat pemrosesan pembayaran. Anda harus menarik item dalam game dari konsumen jika memungkinkan karena Anda tidak akan dibayar untuk pesanan ini. Informasi selengkapnya tentang transaksi gabungan dan penolakan bisa ditemukan di Menangani Sengketa dan Pengembalian Dana.

string

status

Status tindakan khusus ini. status dapat berupa:

  • initiated: Pembayaran berstatus dimulai menyatakan bahwa pembayaran hanya dimulai tetapi belum sepenuhnya selesai. Anda tidak seharusnya memenuhi pesanan jenis ini dengan konsumen dan Anda tidak akan menerima info terbaru secara realtime untuk pembayaran dengan status ini. Akan tetapi, Anda akan mendapatkan info terbaru secara realtime ketika transaksi terkait selesai. Developer dapat melihat status dimulai untuk metode pembayaran tertentu yang membutuhkan waktu lama untuk diselesaikan, contoh: metode tertentu mewajibkan konsumen untuk mengisi formulir online, mencetak tanda terima, dan pergi ke bank secara offline untuk membayar.
  • completed: Status selesai berarti tindakan telah berhasil diselesaikan. Jika jenisnya adalah tagihan, Anda mungkin ingin menyelesaikan pesanan untuk pelanggan pada saat ini. Demikian pula, jika jenis tindakan adalah pengembalian dana, Anda mungkin ingin menarik barang dari pelanggan.
  • failed: Ini menunjukkan tindakan gagal untuk jenis yang bawahnya. Nilai ini bisa ada untuk jenis tindakan tagihan serta jenis tindakan pengembalian dana.

string

amount

Jumlah uang yang dicakup oleh tindakan ini.

string

currency

Mata uang untuk hal di atas amount dalam tindakan ini.

string

time_created

Ketika tindakan ini terjadi.

datetime

time_updated

Ketika tindakan ini terakhir diperbarui.

datetime

tax_amount

Jumlah yang dikurangi dari pembayaran Anda untuk pajak apa pun yang dibayarkan oleh Facebook. Jika tax sama dengan not_taxed atau already_paid kolom ini akan diabaikan.

string

items

Item yang terkait dengan pembayaran.

object[]

type

Jenis item ini.

enum{IN_APP_PURCHASE, SUBSCRIPTION}

product

URL produk item ini.

string

quantity

Jumlah barang ini yang dibeli.

bilangan bulat

country

Kode Negara ISO pembeli, untuk tujuan pajak.

string

tax

Parameter pajak menetapkan apakah suatu pembayaran dikenakan pajak (PPN atau pajak penjualan) dan, jika demikian, bagaimana pajak dibayarkan. Ini bisa mengambil nilai berikut:

  • not_taxed: Tidak ada PPN untuk pembayaran ini karena berasal dari luar Uni Eropa.
  • already_paidPajak pada pembayaran ini sudah dibayarkan oleh operator seluler pengguna atau pihak hulu lainnya
  • tax_remitted: Facebook membayar PPN pada pembayaran ini atas nama Anda. Jumlah pajak akan dipotong dari pembayaran Anda. Lihat di sini untuk informasi selengkapnya.

  • tax_remitted_USMPFFacebook memungut dan membayar pajak penjualan pada pembayaran ini atas nama Anda. Jumlah pajak akan dipotong dari pembayaran Anda, tetapi tidak akan memengaruhi pembayaran bersih Anda karena jumlah pajak yang ditagih merupakan tambahan dari harga barang. Lihat di sini untuk informasi selengkapnya.

string

tax_country

Negara yang ditentukan oleh Facebook untuk kalkulasi pajak dari pembelian ini, diberi kode negara ISO 3166-1 alpha-2. Catatan: Kolom ini hanya untuk informasi Anda dan jangan digunakan untuk tujuan kalkulasi ulang atau rekonsiliasi. Jika tax sama dengan not_taxed atau already_paid kolom ini akan diabaikan.

string

created_time

Waktu pembayaran awalnya dibuat.

string

payout_foreign_exchange_rate

Nilai tukar yang digunakan untuk menghitung jumlah pembayaran yang dibayarkan dalam USD.

float

disputes

Berisi informasi yang terkait dengan sengketa, termasuk user_comment dan user_email yang diberikan oleh konsumen ketika sengketa diawali. Selain itu, berisi status sengketa saat ini, waktu sengketa dibuat, dan alasan penyelesaian, jika ada.

object[]

user_comment

Komentar yang diberikan oleh konsumen saat sengketa diawali.

string

user_email

Email yang diberikan oleh konsumen ketika sengketa diawali.

string

time_created

Waktu sengketa dibuat.

datetime

status

Status sengketa saat ini.

enum{resolved, pending}

reason

Alasan yang diberikan developer atau Facebook untuk menyelesaikan sengketa, setelah sengketa diselesaikan.

enum{pending, refunded_in_cash, granted_replacement_item, denied_refund, banned_user, refunded_by_facebook}

test

Parameter opsional yang muncul ketika pembayaran dilakukan oleh penguji pembayaran yang tercantum di dasbor aplikasi. Ini menunjukkan transaksi yang belum ditagih ke instrumen pembayaran konsumen

Boolean

Penerbitan

Anda bisa membuat pembayaran dengan menggunakan pembayaran Facebook.

Menghapus

Anda tidak bisa menghapus pembayaran menggunakan API ini.

Memperbarui

Anda tidak bisa memperbarui pembayaran menggunakan edge ini.

Edge

Nama Deskripsi

/dispute

Memperbarui status sengketa pembayaran.

/refunds

Mengembalikan dana pembayaran.