Method: acceptRemittanceStatementWithModifications

Memberi tahu Google bahwa pernyataan yang disebutkan dalam permintaan ini akan dibayar setelah perubahan dilakukan pada pernyataan tersebut, seperti biaya klasifikasi ulang PPN.

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

Respons untuk kueri ini boleh 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 dari integrator lain. Dalam situasi ini, saat 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 dikirimkan dalam isi respons.

Contoh permintaan terlihat seperti:


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

WAJIB: Header umum untuk semua permintaan.
paymentIntegratorAccountId

string

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

string

WAJIB: ID permintaan notifikasi laporan yang diubah oleh permintaan ini.

Kolom union modification_type.

modification_type hanya dapat berupa salah satu dari yang berikut:
feeToVatModification

object (FeeToVATModification)

WAJIB: Modifikasi yang diminta 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)

WAJIB: Header umum untuk semua respons.
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

WAJIB: Hasil panggilan v1.acceptRemittanceStatement.

FeeToVATModification

Objek ini menyediakan perubahan pajak yang akan diterapkan ke laporan transfer dana.

Representasi JSON 
{
  "vatToFeeRatioInMicros": string
}
Kolom
vatToFeeRatioInMicros

string (Int64Value format)

WAJIB: Rasio PPN terhadap jumlah Biaya dalam mikro. Ini adalah persentase biaya yang akan diatribusikan kembali ke PPN dan harus lebih besar atau sama dengan nol. Pembulatan harus "setengah genap" atau "bank" pembulatan, artinya membulatkan ke tetangga genap jika kedua angka sama (misalnya 2,5 -> 2, 5,5 -> 6).

Contoh penghitungan pajak adalah sebagai berikut:

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

AcceptRemittanceStatementWithModificationsResultCode

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