Method: remittanceStatementDetails

Menampilkan informasi detail transaksi tentang laporan transfer dana.

Ini adalah API yang di-paging. 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 saat ini diambil berisi transaksi terakhir dalam 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 bertipe ErrorResponse.

Respons terhadap kueri ini mungkin kosong jika metode ini tidak menampilkan HTTP 200. Isi respons kosong dalam situasi saat ErrorResponse dengan deskripsi yang jelas dapat digunakan untuk membantu penyerang memahami ID akun integrator pembayaran 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 akan ditampilkan di isi respons.

Contoh permintaan terlihat seperti:


{
  "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 responsnya akan terlihat seperti:


{
  "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)

WAJIB: Header umum untuk semua permintaan.
paymentIntegratorAccountId

string

WAJIB: Ini adalah ID akun integrator pembayaran yang mengidentifikasi batasan kontraktual seputar pernyataan ini.
statementId

string

WAJIB: ID permintaan notifikasi laporan mutasi rekening.
eventOffset

integer

OPSIONAL: Mengembalikan peristiwa yang dimulai pada offset ini. Parameter ini harus disetel ke nextEventOffset jika ada yang ditampilkan atau dibiarkan tidak ditentukan jika ini adalah permintaan pertama. Jika eventOffset adalah nol, peristiwa akan ditampilkan mulai dari peristiwa pertama. Jika nilainya dua, peristiwa akan ditampilkan mulai dari peristiwa ketiga. Jika tidak ditentukan, eventOffset akan dianggap nol.

numberOfEvents

integer

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

Isi respons

Objek respons untuk metode detail laporan pengiriman uang.

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)

WAJIB: Header umum untuk semua respons.
remittanceStatementSummary

object (RemittanceStatementSummary)

WAJIB: Ringkasan laporan transfer dana ini.
eventOffset

integer

WAJIB: Offset acara respons ini.
nextEventOffset

integer

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

integer

WAJIB: Total jumlah peristiwa dalam pernyataan ini.
totalWithholdingTaxes

string (Int64Value format)

WAJIB: Jumlah semua pajak yang dipotong untuk pernyataan ini.

Nilai ini dalam mikrodetik.
captureEvents[]

object (Event)

WAJIB: Kumpulan peristiwa pengambilan.
refundEvents[]

object (Event)

WAJIB: 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 pembatalan penagihan balik.
adjustmentEvents[]

object (Event)

OPSIONAL: Kumpulan peristiwa penyesuaian. Peristiwa penyesuaian dapat ditambahkan atas pertimbangan Google untuk menyelaraskan perbedaan penagihan, misalnya jika biaya kurang dihitung untuk serangkaian transaksi sebelumnya, penyesuaian dapat digunakan untuk mengembalikan dana integrator.

RemittanceStatementSummary

Objek ringkasan tentang laporan pengiriman uang.

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

string (int64 format)

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

object (BillingPeriod)

WAJIB: Periode penagihan yang tercakup dalam pernyataan ini.
dateDue

string (int64 format)

OPSIONAL: Tanggal jatuh tempo pengiriman uang. Nilai ini direpresentasikan sebagai milidetik dari epoch. Ini adalah tanggal (dan oleh karena itu akan selalu dimulai pada milidetik pertama hari itu dalam zona waktu penagihan).

Ini ditetapkan selama totalDueByIntegrator lebih besar dari 0.
currencyCode

string

WAJIB: Kode mata uang 3 huruf ISO 4217.
totalDueByIntegrator

string (Int64Value format)

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

object (RemittanceInstructions)

WAJIB: Detail tentang cara melakukan pembayaran

BillingPeriod

Periode penagihan untuk pernyataan ini.

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

string (int64 format)

WAJIB: Tanggal mulai periode penagihan. Nilai ini direpresentasikan sebagai milidetik dari epoch. Ini adalah tanggal (dan oleh karena itu akan selalu dimulai pada milidetik pertama hari itu dalam zona waktu penagihan).

Ini adalah milidetik pertama pada hari periode penagihan, 00.00.00.000
endDate

string (int64 format)

WAJIB: Tanggal akhir periode penagihan. Nilai ini direpresentasikan sebagai milidetik dari epoch.

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

RemittanceInstructions

Struktur yang menyimpan informasi tentang cara membayar pemberitahuan pengiriman dana ini.

Representasi JSON 
{
  "memoLineId": string
}
Kolom
memoLineId

string

WAJIB: ID yang wajib dicantumkan di baris memo untuk pembayaran guna identifikasi transfer dana.

Acara

Struktur yang merepresentasikan satu peristiwa yang disertakan dalam laporan pengiriman uang.

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

string

WAJIB: Untuk peristiwa pengambilan atau pengembalian dana, ini akan menjadi requestId yang dikirim Google dengan permintaan. Untuk peristiwa pengembalian dana terbalik, penagihan balik, dan pembatalan penagihan balik, ini akan menjadi requestId yang dikirim oleh Integrator Pembayaran dengan notifikasi peristiwa tersebut. Untuk penyesuaian, ini akan menjadi ID unik yang ditetapkan oleh Google ke peristiwa penyesuaian.
paymentIntegratorEventId

string

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

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

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

Panjang dan format kolom ini bergantung pada kolom sumber untuk setiap ID. Lihat dokumentasi untuk setiap kolom sumber guna mengetahui detail tentang persyaratan panjang dan set karakter. Khususnya, perhatikan bahwa kolom ini terkadang dapat berisi ID yang dibuat Google yang mungkin memiliki persyaratan panjang maksimum yang berbeda dengan ID yang dibuat integrator.
eventCharge

string (Int64Value format)

WAJIB: Dalam kode mata uang yang ditentukan oleh laporan mutasi. Jika nilai ini negatif, maka ini mewakili nilai uang yang berpindah dari Google ke integrator pembayaran. Jika nilainya positif, berarti ada uang dari integrator pembayaran yang harus dibayarkan kepada Google.

Misalnya, transaksi pengambilan dana akan selalu positif, dan transaksi pengembalian dana akan selalu negatif. Peristiwa pengembalian dana terbalik dan pembatalan penagihan balik akan selalu positif. Peristiwa penagihan balik akan selalu negatif.

Nilai ini dalam mikrodetik.
eventFee

string (Int64Value format)

WAJIB: Dalam kode mata uang yang ditentukan oleh laporan mutasi. Jika nilai ini negatif, maka ini mewakili nilai uang yang berpindah dari Google ke integrator pembayaran. Jika nilainya positif, berarti uang dari integrator pembayaran harus dibayarkan kepada Google.

Misalnya, jika perjanjian menyatakan bahwa Google akan membayar 1% dari transactionCharge kepada integrator pembayaran, dan akan membatalkan 1% tersebut setelah pengembalian dana transaksi tersebut, maka biaya akuisisi akan negatif dan setelah pengembalian dana, biaya pengembalian dana akan positif.

Nilai ini dalam mikrodetik.
presentmentChargeAmount

string (Int64Value format)

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

Nilai ini dalam mikrodetik.

presentmentCurrencyCode

string

OPSIONAL: Kode mata uang 3 huruf ISO 4217 yang menyatakan mata uang penawaran (transaksi).

exchangeRate
(deprecated)

string (Int64Value format)

TIDAK DIGUNAKAN LAGI: Nilai tukar yang digunakan dalam mengonversi jumlah penawaran ke jumlah penyelesaian (invoice).

Nilai ini dalam basis poin 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 penawaran ke jumlah penyelesaian (invoice), yang dinyatakan dalam poin basis nano.

Nilai ini dalam basis poin 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. Nilai tukar tersebut setara dan dinyatakan dengan presisi yang berbeda. Pada versi mendatang, exchangeRate akan dihapus dan digantikan dengan nanoExchangeRate.