Method: acceptRemittanceStatementWithModifications

Memberi tahu Google bahwa pernyataan yang ditunjukkan dalam permintaan ini akan dibayarkan setelah perubahan dilakukan pada pernyataan seperti biaya untuk klasifikasi ulang PPN.

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": "0123434-abc",
    "requestTimestamp": "1502545413098"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "feeToVatModification": {
    "vatToFeeRatioInMicros": "150000"
  }
}

Contoh respons terlihat seperti ini:


{
  "responseHeader": {
    "responseTimestamp": "1519996752221"
  },
  "acceptRemittanceStatementWithModificationsResultCode": "SUCCESS"
}

Permintaan HTTP

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

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string,

  // Union field modification_type can be only one of the following:
  "feeToVatModification": {
    object (FeeToVATModification)
  }
  // End of list of possible types for union field modification_type.
}
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 dari notifikasi pernyataan yang diubah oleh permintaan ini.

Kolom union modification_type.

modification_type hanya dapat berupa salah satu dari berikut:
feeToVatModification

object (FeeToVATModification)

DIPERLUKAN: Meminta modifikasi untuk mengatribusikan kembali sebagian biaya ke pajak pertambahan nilai (PPN).

Isi respons

Objek respons untuk metode acceptRemittanceStatementWithModifications.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
Kolom
responseHeader

object (ResponseHeader)

DIPERLUKAN: Header umum untuk semua respons.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

REQUIRED: Hasil dari panggilan v1.acceptRemittanceStatement.

PerubahanBiayaToPPN

Objek ini memberikan perubahan pajak yang akan diterapkan pada laporan mutasi pembayaran.

Representasi JSON 
{
  "vatToFeeRatioInMicros": string
}
Kolom
vatToFeeRatioInMicros

string (Int64Value format)

DIPERLUKAN: Rasio jumlah PPN terhadap Biaya dalam mikro. Nilai ini adalah persentase biaya untuk diatribusikan ulang ke PPN dan harus lebih besar dari atau sama dengan nol. Pembulatan harus "pembulatan setengah" atau "bankir", yang berarti pembulatan ke tetangga genap jika kedua angka memiliki jarak yang sama (misalnya 2,5 -> 2, 5,5 -> 6).

Contoh penghitungan pajak adalah sebagai berikut:

  • Biaya pemrosesan termasuk pajak yang dikumpulkan oleh integrator pembayaran: 1000 USD
  • Tarif pajak: 10%
  • Dengan demikian, 1.000 USD = (biaya pemrosesan) + (10% * biaya pemrosesan)
  • Biaya pemrosesan (sans tax) = 1000 / 1,1 = 909,090909 USD
  • Pajak yang dibayar oleh integrator pembayaran = 1000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Pembulatan setengah genap pada 90909,091 = 90909

AcceptRemittanceStatementWithModifiedsResultCode

Enumerasi
UNKNOWN_RESULT Jangan pernah menetapkan nilai default ini.
SUCCESS Laporan transfer dana berhasil diterima dengan perubahan.
INVALID_VAT_MODIFICATION Perubahan PPN tidak diterima karena permintaan tidak valid.