Method: remittanceStatementNotification

Memberi tahu integrator dari pernyataan transfer dana yang baru.

Notifikasi pernyataan terjadi setiap kali pernyataan baru muncul yang mewakili uang yang akan dibayarkan Google kepada integrator atau uang yang dimiliki integrator kepada Google.

Jika integrator menampilkan keberhasilan, dianggap bahwa laporan telah diterima dan akan dibayar.

requestId juga merupakan ID pernyataan (digunakan di tempat lain). Kombinasi requestId dalam header dan paymentIntegratorAccountId adalah kunci idempotensi dan mengidentifikasi pernyataan ini secara unik.

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

Contoh permintaan terlihat seperti ini:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-statement-abc",
    "requestTimestamp": "1502632800000"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "remittanceStatementSummary": {
    "statementDate": "1502607600000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502521199000"
    },
    "dateDue": "1503212400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  }
}

Contoh respons terlihat seperti ini:


{
  "responseHeader": {
    "responseTimestamp": "1502632802000"
  },
  "paymentIntegratorStatementId": "334a",
  "result": "ACCEPTED"
}

Permintaan HTTP

POST https://www.integratorhost.example.com/v1/remittanceStatementNotification

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  }
}
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.
remittanceStatementSummary

object (RemittanceStatementSummary)

DIPERLUKAN: Ringkasan laporan transfer dana ini.

Isi respons

Objek respons untuk metode notifikasi pernyataan transfer dana.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorStatementId": string,
  "result": enum (StatementNotificationResultCode)
}
Kolom
responseHeader

object (ResponseHeader)

DIPERLUKAN: Header umum untuk semua respons.
paymentIntegratorStatementId

string

DIPERLUKAN: ID integrator mengetahui pernyataan ini. Ini adalah integrator yang dihasilkan.
result

enum (StatementNotificationResultCode)

DIPERLUKAN: Hasil dari notifikasi pernyataan ini.

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.

StatementNotificationResultCode

Kode hasil untuk notifikasi pernyataan.

Enumerasi
UNKNOWN_RESULT Jangan pernah menetapkan nilai default ini.
ACCEPTED Integrator telah menerima pernyataan ini.