- Permintaan HTTP
- Isi permintaan
- Isi respons
- RemittanceStatementSummary
- BillingPeriod
- RemittanceInstructions
- Peristiwa
Menampilkan informasi detail transaksi tentang laporan mutasi pembayaran.
Ini adalah API yang telah dipaginasi. Jumlah peristiwa transaksi per halaman dapat ditentukan dengan numberOfEvents
. Jika tidak ditentukan, maksimum 1.000 peristiwa akan ditampilkan per halaman. Setiap permintaan ke API ini akan menampilkan nextEventOffset
yang mengarah ke peristiwa transaksi berikutnya dalam laporan, serta totalEvents
yang menentukan jumlah total transaksi dalam laporan. 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 kueri ini mungkin kosong jika metode ini tidak menampilkan HTTP 200. Isi respons akan kosong jika
dengan deskripsi yang jelas dapat digunakan untuk membantu penyerang memahami ID akun integrator pembayaran dari integrator lain. 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 tersebut akan ditampilkan dalam isi respons.ErrorResponse
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 ( |
Kolom | |
---|---|
requestHeader |
WAJIB: Header umum untuk semua permintaan. |
paymentIntegratorAccountId |
WAJIB: Ini adalah ID akun integrator pembayaran yang mengidentifikasi batasan kontraktual terkait pernyataan ini. |
statementId |
WAJIB: ID permintaan notifikasi pernyataan. |
eventOffset |
OPSIONAL: Menampilkan peristiwa yang dimulai dari offset ini. Nilai ini harus disetel ke |
numberOfEvents |
OPSIONAL: Jumlah peristiwa yang ditampilkan per halaman. Jika tidak ditentukan atau lebih besar dari 1.000, nilainya adalah 1.000. |
Isi respons
Objek respons untuk metode detail laporan mutasi pembayaran.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "responseHeader": { object ( |
Kolom | |
---|---|
responseHeader |
WAJIB: Header umum untuk semua respons. |
remittanceStatementSummary |
WAJIB: Ringkasan laporan mutasi pembayaran ini. |
eventOffset |
WAJIB: Offset peristiwa respons ini. |
nextEventOffset |
OPSIONAL: Offset peristiwa berikutnya yang akan ditampilkan. Jika tidak ditentukan, tidak ada lagi peristiwa yang akan diambil untuk pernyataan ini. |
totalEvents |
WAJIB: Jumlah total peristiwa dalam pernyataan ini. |
totalWithholdingTaxes |
WAJIB: Jumlah semua pajak yang dipotong/dipungut untuk laporan ini. Nilai ini dalam micros. |
captureEvents[] |
WAJIB: Kumpulan peristiwa pengambilan gambar. |
refundEvents[] |
WAJIB: Kumpulan peristiwa pengembalian dana. |
reverseRefundEvents[] |
OPSIONAL: Kumpulan peristiwa pengembalian dana terbalik. |
chargebackEvents[] |
OPSIONAL: Kumpulan peristiwa penagihan balik. |
reverseChargebackEvents[] |
OPSIONAL: Kumpulan peristiwa penagihan balik terbalik. |
adjustmentEvents[] |
OPSIONAL: Kumpulan peristiwa penyesuaian. Peristiwa penyesuaian dapat ditambahkan atas diskresi Google untuk merekonsiliasi perbedaan penagihan, misalnya jika biaya kurang dihitung untuk serangkaian transaksi sebelumnya, penyesuaian dapat digunakan untuk membuat integrator utuh. |
RemittanceStatementSummary
Objek ringkasan tentang laporan mutasi pembayaran.
Representasi JSON |
---|
{ "statementDate": string, "billingPeriod": { object ( |
Kolom | |
---|---|
statementDate |
WAJIB: Tanggal (di Amerika/Los Angeles) pernyataan ini dibuat. |
billingPeriod |
WAJIB: Periode penagihan yang dicakup dalam laporan mutasi ini. |
dateDue |
OPSIONAL: Tanggal jatuh tempo transfer dana. Waktu ini direpresentasikan dalam milidetik dari epoch. Ini adalah tanggal (sehingga akan selalu dimulai pada milidetik pertama dalam hari tersebut dalam zona waktu penagihan). Nilai ini disetel selama |
currencyCode |
WAJIB: Kode mata uang 3 huruf ISO 4217. |
totalDueByIntegrator |
WAJIB: Nilai ini dalam mikro mata uang |
remittanceInstructions |
WAJIB: Detail cara mengirim pembayaran |
BillingPeriod
Periode penagihan laporan mutasi ini.
Representasi JSON |
---|
{ "startDate": string, "endDate": string } |
Kolom | |
---|---|
startDate |
WAJIB: Tanggal mulai periode penagihan. Waktu ini direpresentasikan dalam milidetik dari epoch. Ini adalah tanggal (sehingga akan selalu dimulai pada milidetik pertama dalam hari tersebut dalam zona waktu penagihan). Ini adalah milidetik pertama dalam hari periode penagihan, yaitu 00:00:00.000 |
endDate |
WAJIB: Tanggal akhir periode penagihan. Waktu ini direpresentasikan dalam milidetik dari epoch. Ini adalah milidetik terakhir dari hari terakhir periode penagihan, 23:59:59.999 |
RemittanceInstructions
Struktur yang menyimpan informasi tentang cara membayar notifikasi pembayaran ini.
Representasi JSON |
---|
{ "memoLineId": string } |
Kolom | |
---|---|
memoLineId |
WAJIB: Tanda pengenal yang wajib dicantumkan dalam nota untuk pembayaran identifikasi transfer dana. |
Event
Struktur yang mewakili satu peristiwa yang termasuk dalam laporan transfer dana.
Representasi JSON |
---|
{ "eventRequestId": string, "paymentIntegratorEventId": string, "eventCharge": string, "eventFee": string, "presentmentChargeAmount": string, "presentmentCurrencyCode": string, "exchangeRate": string, "nanoExchangeRate": string } |
Kolom | |
---|---|
eventRequestId |
WAJIB: Untuk peristiwa penangkapan atau pengembalian dana, peristiwa ini akan berupa |
paymentIntegratorEventId |
WAJIB: Identifikasi integrator pembayaran yang ditampilkan untuk acara ini. Untuk rekaman, ini adalah Kolom ini memiliki panjang yang bervariasi. Sebagai integrator, ID apa pun yang Anda berikan untuk peristiwa ini akan ditampilkan di sini. Jika nilai tidak diberikan oleh integrator untuk peristiwa yang sesuai, kolom ini akan berisi nilai yang sama dengan kolom Untuk pengembalian dana balik, penagihan balik, dan peristiwa penagihan balik terbalik, ini akan menjadi 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 integrator. |
eventCharge |
WAJIB: Dalam kode mata uang yang ditentukan oleh pernyataan. Jika nilai ini negatif, berarti nilai uang yang berpindah dari Google ke integrator pembayaran. Jika hasilnya positif, uang tersebut berasal dari integrator pembayaran yang ditujukan ke Google. Misalnya, transaksi yang ditangkap akan selalu positif, dan transaksi pengembalian dana akan selalu negatif. Peristiwa pengembalian dana dan penagihan balik terbalik akan selalu positif. Peristiwa penagihan balik akan selalu negatif. Nilai ini dalam micros. |
eventFee |
WAJIB: Dalam kode mata uang yang ditentukan oleh pernyataan. Jika nilai ini negatif, berarti nilai uang yang berpindah dari Google ke integrator pembayaran. Jika hasilnya positif, uang tersebut berasal dari integrator pembayaran yang ditujukan ke Google. Misalnya, jika perjanjian menyatakan bahwa Google akan membayar 1% dari Nilai ini dalam micros. |
presentmentChargeAmount |
OPSIONAL: Jumlah transaksi dalam mata uang saat ini (disebut juga transaksi) sebelum mata uang asing. Kolom ini mengikuti konvensi tanda yang sama dengan kolom Nilai ini dalam micros. |
presentmentCurrencyCode |
OPSIONAL: Kode mata uang 3 huruf ISO 4217 yang menentukan mata uang presentasi (transaksi). |
exchangeRate |
OPSIONAL: Nilai tukar yang digunakan untuk mengonversi jumlah hadiah ke jumlah penyelesaian (invoice). Nilai ini dalam poin basis mikro (1 basis poin = 0,0001 = ,01%). Yaitu, untuk mendapatkan nilai tukar, bagi bidang ini dengan 10^10. |
nanoExchangeRate |
OPSIONAL: Nilai tukar yang digunakan dalam mengonversi jumlah presentasi ke jumlah penyelesaian (invoice), yang dinyatakan dalam poin basis nano. Nilai ini dalam nano basis poin (1 basis poin = 0,0001 = ,01%). Yaitu, untuk mendapatkan nilai tukar, bagi bidang ini dengan 10^13. Kolom dan exchangeRate ini akan terisi. Nilai tukar tersebut setara dengan yang dinyatakan dengan presisi berbeda. Pada versi mendatang, exchangeRate akan dihapus untuk mengganti nanoExchangeRate. |