Method: remittanceStatementNotification

Memberi tahu integrator laporan mutasi transfer dana baru.

Notifikasi pernyataan muncul setiap kali pernyataan baru diajukan yang menunjukkan uang yang akan dibayarkan Google kepada integrator atau uang yang harus dibayarkan oleh integrator kepada Google.

Jika integrator mengembalikan kesuksesan, maka diasumsikan bahwa pernyataan telah diterima dan akan dibayar.

requestId juga merupakan ID pernyataan (digunakan di tempat lain). Kombinasi requestId dalam header dan paymentIntegratorAccountId adalah kunci idempotency 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:


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

WAJIB: Header umum untuk semua permintaan.
paymentIntegratorAccountId

string

WAJIB: Ini adalah ID akun integrator pembayaran yang mengidentifikasi batasan kontraktual terkait laporan ini.
remittanceStatementSummary

object (RemittanceStatementSummary)

WAJIB: Ringkasan laporan mutasi transfer dana ini.

Isi respons

Objek respons untuk metode notifikasi laporan 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)

WAJIB: Header umum untuk semua respons.
paymentIntegratorStatementId

string

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

enum (StatementNotificationResultCode)

WAJIB: Hasil dari notifikasi laporan ini.

RemittanceStatementSummary

Objek ringkasan tentang laporan mutasi transfer dana.

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/Los Angeles) pernyataan ini dibuat.
billingPeriod

object (BillingPeriod)

WAJIB: Periode penagihan yang dicakup dalam laporan ini.
dateDue

string (int64 format)

OPSIONAL: Tanggal jatuh tempo transfer dana. Ini direpresentasikan sebagai milidetik dari epoch. Ini adalah tanggal (sehingga akan selalu dimulai pada milidetik pertama hari 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 laporan ini.

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

string (int64 format)

WAJIB: Tanggal mulai periode penagihan. Ini direpresentasikan sebagai milidetik dari epoch. Ini adalah tanggal (sehingga akan selalu dimulai pada milidetik pertama hari 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. Ini direpresentasikan sebagai 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 transfer dana ini.

Representasi JSON 
{
  "memoLineId": string
}
Kolom
memoLineId

string

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

StatementNotificationResultCode

Kode hasil untuk notifikasi pernyataan.

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