Method: remittanceStatementDetails

Menampilkan informasi detail transaksi tentang laporan mutasi pembayaran.

Ini adalah API dengan penomoran halaman. Jumlah peristiwa transaksi per halaman dapat ditentukan dengan numberOfEvents. Jika tidak ditentukan, jumlah maksimum 1.000 peristiwa akan ditampilkan per halaman. Setiap permintaan ke API ini akan menampilkan nextEventOffset yang mengarah ke peristiwa transaksi berikutnya dalam pernyataan, serta totalEvents yang menentukan jumlah total transaksi dalam pernyataan. Jika halaman yang diambil saat ini berisi transaksi terakhir dari pernyataan, nextEventOffset tidak akan ada dalam respons.

Nilai statementId adalah requestId dari remittanceStatementNotificationRequest

Jika endpoint mengalami error saat memproses permintaan, respons dari endpoint ini akan berjenis ErrorResponse.

Respons terhadap kueri ini mungkin kosong jika metode ini tidak menampilkan HTTP 200. Isi respons kosong jika ErrorResponse dengan deskripsi yang jelas dapat digunakan untuk membantu penyerang memahami ID akun integrator pembayaran dari integrator lainnya. Dalam situasi ini, jika kunci penandatanganan tidak cocok, ID integrator pembayaran tidak ditemukan, atau kunci enkripsi tidak diketahui, metode ini akan menampilkan HTTP 404 dengan isi kosong. Jika tanda tangan permintaan dapat diverifikasi, informasi tambahan terkait error akan ditampilkan dalam isi respons.

Contoh permintaan terlihat seperti ini:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "statement_detail_request_139932019",
    "requestTimestamp": "1502551332087"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "numberOfEvents": 4
}

Contoh respons terlihat seperti ini:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "eventOffset": 0,
  "nextEventOffset": 4,
  "totalEvents": 15,
  "remittanceStatementSummary": {
    "statementDate": "1502521200000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502434800000"
    },
    "dateDue": "1502348400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  },
  "captureEvents": [
    {
      "eventRequestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
      "paymentIntegratorEventId": "ioj32SOIjf23oijSDfoij",
      "eventCharge": "700000000",
      "eventFee": "-28000000"
    },
    {
      "eventRequestId": "Ggghvh78200PQ3Yrpb",
      "paymentIntegratorEventId": "iasdf23dSdfijSDfoij",
      "eventCharge": "800000000",
      "eventFee": "-32000000"
    }
  ],
  "refundEvents": [
    {
      "eventRequestId": "liUrreQY233839dfFFb24gaQM",
      "paymentIntegratorEventId": "asd3SDf3f3oijSDfoij",
      "eventCharge": "-200000000",
      "eventFee": "8000000"
    },
    {
      "eventRequestId": "IIghhhUrreQY233839II9qM==",
      "paymentIntegratorEventId": "DFjidoso12FSDFSDE",
      "eventCharge": "-150000000",
      "eventFee": "6000000"
    }
  ]
}

Permintaan HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/remittanceStatementDetails/:PIAID

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string,
  "eventOffset": integer,
  "numberOfEvents": integer
}
Kolom
requestHeader

object (RequestHeader)

DIPERLUKAN: Header umum untuk semua permintaan.
paymentIntegratorAccountId

string

DIPERLUKAN: Ini adalah ID akun integrator pembayaran yang mengidentifikasi batasan kontrak terkait pernyataan ini.
statementId

string

DIPERLUKAN: ID permintaan notifikasi pernyataan.
eventOffset

integer

OPSIONAL: Menampilkan peristiwa yang dimulai pada offset ini. Parameter ini harus disetel ke nextEventOffset jika salah satunya ditampilkan atau tidak ditentukan jika ini adalah permintaan pertama. Jika eventOffset adalah nol, peristiwa akan ditampilkan mulai dari peristiwa pertama. Jika ini adalah dua, peristiwa akan ditampilkan mulai dengan peristiwa ketiga. Jika tidak ditentukan, eventOffset akan diasumsikan nol.

numberOfEvents

integer

OPSIONAL: Jumlah peristiwa yang akan ditampilkan per halaman. Jika tidak ditentukan atau lebih besar dari 1.000, jumlahnya menjadi 1.000.

Isi respons

Objek respons untuk metode detail laporan transfer dana.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  },
  "eventOffset": integer,
  "nextEventOffset": integer,
  "totalEvents": integer,
  "totalWithholdingTaxes": string,
  "captureEvents": [
    {
      object (Event)
    }
  ],
  "refundEvents": [
    {
      object (Event)
    }
  ],
  "reverseRefundEvents": [
    {
      object (Event)
    }
  ],
  "chargebackEvents": [
    {
      object (Event)
    }
  ],
  "reverseChargebackEvents": [
    {
      object (Event)
    }
  ],
  "adjustmentEvents": [
    {
      object (Event)
    }
  ]
}
Kolom
responseHeader

object (ResponseHeader)

DIPERLUKAN: Header umum untuk semua respons.
remittanceStatementSummary

object (RemittanceStatementSummary)

DIPERLUKAN: Ringkasan laporan transfer dana ini.
eventOffset

integer

DIPERLUKAN: Offset peristiwa dari respons ini.
nextEventOffset

integer

OPSIONAL: Offset peristiwa berikutnya yang akan ditampilkan. Jika tidak ditentukan, tidak ada peristiwa lain yang akan diambil untuk pernyataan ini.
totalEvents

integer

DIPERLUKAN: Jumlah total peristiwa dalam pernyataan ini.
totalWithholdingTaxes

string (Int64Value format)

DIPERLUKAN: Jumlah semua pajak yang dipotong/dipungut untuk pernyataan ini.

Nilai ini dinyatakan dalam mikro.
captureEvents[]

object (Event)

DIPERLUKAN: Kumpulan peristiwa pengambilan gambar.
refundEvents[]

object (Event)

DIPERLUKAN: Kumpulan peristiwa pengembalian dana.
reverseRefundEvents[]

object (Event)

OPSIONAL: Kumpulan peristiwa pengembalian dana terbalik.
chargebackEvents[]

object (Event)

OPSIONAL: Kumpulan peristiwa penagihan balik.
reverseChargebackEvents[]

object (Event)

OPSIONAL: Kumpulan peristiwa penagihan balik terbalik.
adjustmentEvents[]

object (Event)

OPSIONAL: Kumpulan peristiwa penyesuaian. Peristiwa penyesuaian dapat ditambahkan sesuai kebijaksanaan Google untuk merekonsiliasi perbedaan penagihan, misalnya jika biaya dihitung rendah untuk serangkaian transaksi sebelumnya, penyesuaian dapat digunakan untuk membuat seluruh integrator.

Ringkasan Transfer Dana

Objek ringkasan tentang pernyataan transfer dana.

Representasi JSON 
{
  "statementDate": string,
  "billingPeriod": {
    object (BillingPeriod)
  },
  "dateDue": string,
  "currencyCode": string,
  "totalDueByIntegrator": string,
  "remittanceInstructions": {
    object (RemittanceInstructions)
  }
}
Kolom
statementDate

string (int64 format)

DIPERLUKAN: Tanggal (di Amerika/Los Angeles) pernyataan ini dibuat.
billingPeriod

object (BillingPeriod)

DIPERLUKAN: Periode penagihan yang dijelaskan dalam laporan ini.
dateDue

string (int64 format)

OPSIONAL: Tanggal jatuh tempo transfer. Hal ini direpresentasikan sebagai milidetik dari epoch. Ini adalah tanggal (sehingga akan selalu dimulai pada milidetik pertama dalam zona waktu penagihan).

Ini ditetapkan selama totalDueByIntegrator lebih besar dari 0.
currencyCode

string

DIPERLUKAN: Kode mata uang 3 huruf ISO 4217.
totalDueByIntegrator

string (Int64Value format)

DIPERLUKAN: Nilai ini dalam mikro dalam mata uang currencyCode. Nilai ini selalu positif.
remittanceInstructions

object (RemittanceInstructions)

DIPERLUKAN: Detail tentang cara mengirimkan pembayaran

Periode Penagihan

Periode penagihan laporan mutasi ini.

Representasi JSON 
{
  "startDate": string,
  "endDate": string
}
Kolom
startDate

string (int64 format)

DIPERLUKAN: Tanggal mulai periode penagihan. Hal ini direpresentasikan sebagai milidetik dari epoch. Ini adalah tanggal (sehingga akan selalu dimulai pada milidetik pertama dalam zona waktu penagihan).

Ini adalah milidetik pertama pada hari periode penagihan, 00:00:00.000
endDate

string (int64 format)

DIPERLUKAN: Tanggal akhir periode penagihan. Hal ini direpresentasikan sebagai milidetik dari epoch.

Ini adalah milidetik terakhir pada hari terakhir periode penagihan, 23:59:59.999

Petunjuk Transfer Dana

Struktur menyimpan informasi tentang cara membayar notifikasi transfer dana ini.

Representasi JSON 
{
  "memoLineId": string
}
Kolom
memoLineId

string

DIPERLUKAN: ID yang wajib ditempatkan di baris memo untuk pembayaran atas identifikasi transfer dana.

Peristiwa

Struktur yang mewakili satu peristiwa yang disertakan dalam laporan transfer uang.

Representasi JSON 
{
  "eventRequestId": string,
  "paymentIntegratorEventId": string,
  "eventCharge": string,
  "eventFee": string,
  "presentmentChargeAmount": string,
  "presentmentCurrencyCode": string,
  "exchangeRate": string,
  "nanoExchangeRate": string
}
Kolom
eventRequestId

string

DIPERLUKAN: Untuk peristiwa pengambilan atau pengembalian dana, ini akan menjadi requestId yang dikirim Google dengan permintaan tersebut. Untuk peristiwa pengembalian dana balik, penagihan balik, dan penagihan balik, ini akan menjadi requestId yang dikirimkan Integrator Pembayaran dengan notifikasi peristiwa tersebut. Untuk penyesuaian, ID ini akan berupa ID unik yang ditetapkan Google untuk peristiwa penyesuaian.
paymentIntegratorEventId

string

DIPERLUKAN: ID integrator pembayaran yang ditampilkan untuk peristiwa ini. Untuk perekaman, ini adalah paymentIntegratorTransactionId dari respons terhadap panggilan capture, untuk pengembalian dana, ini adalah paymentIntegratorRefundId dari respons terhadap panggilan refund.

Kolom ini memiliki panjang variabel, sebagai integrator, ID apa pun yang Anda berikan untuk peristiwa ini akan tercermin di sini. Jika nilai tidak diberikan oleh integrator untuk peristiwa yang sesuai, kolom ini akan berisi nilai yang sama dengan kolom eventRequestId.

Untuk pengembalian dana balik, peristiwa penagihan balik dan penagihan balik akan menjadi requestId yang dikirim Integrator Pembayaran dengan notifikasi peristiwa.

Panjang dan format kolom ini bergantung pada kolom sumber untuk setiap ID. Lihat dokumentasi untuk setiap kolom sumber untuk mengetahui detail tentang persyaratan panjang dan himpunan karakter. Secara khusus, perhatikan bahwa kolom ini terkadang dapat berisi ID yang dibuat Google, yang mungkin memiliki persyaratan panjang maksimum yang berbeda dari ID yang dibuat oleh integrator.
eventCharge

string (Int64Value format)

DIPERLUKAN: Dalam kode mata uang yang ditentukan oleh pernyataan. Jika nilai ini negatif, berarti nilai uang dari Google berubah menjadi integrator pembayaran. Jika positif, permintaan tersebut adalah uang dari integrator pembayaran karena Google.

Misalnya, transaksi tangkapan akan selalu positif, dan transaksi pengembalian dana akan selalu negatif. Pengembalian dana dan peristiwa penagihan balik terbalik akan selalu positif. Peristiwa penagihan balik akan selalu negatif.

Nilai ini dinyatakan dalam mikro.
eventFee

string (Int64Value format)

DIPERLUKAN: Dalam kode mata uang yang ditentukan oleh pernyataan. Jika nilai ini negatif, berarti nilai uang dari Google berubah menjadi integrator pembayaran. Jika positif, permintaan tersebut adalah uang dari integrator pembayaran karena Google.

Misalnya, jika perjanjian menyatakan bahwa Google akan membayarkan 1% dari transactionCharge ke integrator pembayaran, dan akan mengembalikan 1% tersebut setelah pengembalian dana atas transaksi tersebut, maka biaya pengambilan akan menjadi negatif dan setelah pengembalian dana, biaya pengembalian dana akan positif.

Nilai ini dinyatakan dalam mikro.
presentmentChargeAmount

string (Int64Value format)

OPSIONAL: Jumlah transaksi dalam mata uang presentasi (alias transaksi) sebelum valuta asing. Kolom ini mengikuti konvensi tanda sama dengan kolom eventCharge.

Nilai ini dinyatakan dalam mikro.

presentmentCurrencyCode

string

OPSIONAL: Kode mata uang 3 huruf ISO 4217 yang menunjukkan mata uang (transaksi) presentasi.

exchangeRate

string (Int64Value format)

OPSIONAL: Nilai tukar yang digunakan dalam mengonversi jumlah penyajian menjadi jumlah penyelesaian (invoice).

Nilai ini dalam poin dasar mikro (1 basis poin = 0,0001 = 0,01%). Artinya, untuk mendapatkan nilai tukar, bagi kolom ini dengan 10^10.
nanoExchangeRate

string (Int64Value format)

OPSIONAL: Nilai tukar yang digunakan dalam mengonversi jumlah penyajian menjadi jumlah penyelesaian (invoice), dinyatakan dalam poin dasar nano.

Nilai ini dalam poin basis nano (1 basis poin = 0,0001 = 0,01%). Artinya, untuk mendapatkan nilai tukar, bagi kolom ini dengan 10^13.

Kolom ini dan exchangeRate akan diisi. Keduanya adalah nilai tukar yang setara yang dinyatakan dengan presisi berbeda. Di versi mendatang, exchangeRate akan dihapus dan diganti dengan nanoExchangeRate.