Method: acceptRemittanceStatementWithModifications

บอก Google ว่าเราจะชําระเงินตามข้อความที่ระบุไว้ในคําขอนี้หลังจากที่ดําเนินการแก้ไขกับข้อความ เช่น ค่าธรรมเนียมสําหรับการแยกประเภท VAT

หากปลายทางพบข้อผิดพลาดขณะประมวลผลคําขอ การตอบสนองจากปลายทางนี้จะเป็นประเภท ErrorResponse

การตอบกลับการค้นหานี้อาจว่างเปล่าหากวิธีนี้ไม่แสดงผล HTTP 200 เนื้อหาการตอบกลับว่างเปล่าในกรณีที่มีการใช้ ErrorResponse พร้อมคําอธิบายที่ชัดเจนเพื่อช่วยให้ผู้โจมตีเข้าใจตัวระบุบัญชีของผู้รวมระบบการชําระเงินของผู้ผสานรวมรายอื่นๆ ในสถานการณ์เช่นนี้ หากคีย์การลงนามไม่ตรงกัน ไม่พบตัวระบุผู้ผสานรวมการชําระเงิน หรือไม่ทราบคีย์การเข้ารหัส เมธอดนี้จะแสดง HTTP 404 พร้อมเนื้อหาว่างเปล่า หากสามารถยืนยันลายเซ็นของคําขอได้ ระบบจะส่งข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาดนั้นมาไว้ในเนื้อหาตอบกลับ

ตัวอย่างคําขอมีลักษณะดังนี้


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-abc",
    "requestTimestamp": "1502545413098"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "feeToVatModification": {
    "vatToFeeRatioInMicros": "150000"
  }
}

ตัวอย่างคําตอบจะมีลักษณะดังนี้


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

คำขอ HTTP

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

เนื้อหาของคำขอ

เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง 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.
}
ช่อง
requestHeader

object (RequestHeader)

ต้องระบุ: ส่วนหัวร่วมสําหรับคําขอทั้งหมด
paymentIntegratorAccountId

string

ต้องระบุ: นี่คือตัวระบุบัญชีของผู้ผสานรวมการชําระเงินที่ระบุข้อจํากัดทางสัญญาเกี่ยวกับใบแจ้งยอดนี้
statementId

string

ต้องระบุ: รหัสคําขอการแจ้งเตือนใบแจ้งยอดที่แก้ไข

ช่อง Union modification_type

modification_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
feeToVatModification

object (FeeToVATModification)

ต้องระบุ: ขอสิทธิ์แก้ไขเพื่อรวมค่าธรรมเนียมส่วนหนึ่งไว้ในภาษีมูลค่าเพิ่ม (VAT)

เนื้อหาการตอบกลับ

ออบเจ็กต์การตอบกลับสําหรับเมธอด acceptRemittanceStatementWithModifications

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementWithModificationsResultCode": enum (AcceptRemittanceStatementWithModificationsResultCode)
}
ช่อง
responseHeader

object (ResponseHeader)

ต้องระบุ: ส่วนหัวทั่วไปสําหรับคําตอบทั้งหมด
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

ต้องระบุ: ผลลัพธ์ของการเรียก v1.acceptRemittanceStatement

ค่าธรรมเนียม VAT การแก้ไข

ออบเจ็กต์นี้มีการแก้ไขภาษีที่จะใช้กับใบแจ้งยอดการส่งเงิน

การแสดง JSON 
{
  "vatToFeeRatioInMicros": string
}
ช่อง
vatToFeeRatioInMicros

string (Int64Value format)

ต้องระบุ: อัตราส่วน VAT ต่อจํานวนไมโคร นี่คือเปอร์เซ็นต์ของค่าธรรมเนียมที่ต้องชําระคืนให้กับ VAT และต้องมากกว่าหรือเท่ากับศูนย์ การปัดเศษควรเป็นการ "ตัดเลขคู่" หรือ "การเรียงต่อกัน" ซึ่งหมายถึงการปัดเศษให้ใกล้เคียงคู่กัน ในกรณีที่เลขคู่เท่ากัน (เช่น 2.5 -> 2, 5.5 -> 6)

ตัวอย่างสําหรับการคํานวณภาษีมีดังนี้:

  • ค่าธรรมเนียมการดําเนินการรวมภาษีที่เรียกเก็บโดยผู้รวมการชําระเงิน: 1,000 USD
  • อัตราภาษี: 10%
  • ดังนั้น 1, 000 USD = (ค่าธรรมเนียมการประมวลผล) + (10% * ค่าธรรมเนียมการดําเนินการ)
  • ค่าธรรมเนียมการดําเนินการ (ภาษี San) = 1000 / 1.1 = 909.090909 USD
  • ภาษีที่ผู้ผสานรวมการชําระเงินชําระ = 1,000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • ปัดเศษครึ่งบนของ 90909.091 = 90909

ยอมรับข้อตกลงสถานะเมื่อปรับเปลี่ยนรหัสผลลัพธ์

Enum
UNKNOWN_RESULT อย่าตั้งค่าเริ่มต้นนี้!
SUCCESS ยอมรับใบแจ้งยอดการส่งที่มีการแก้ไขสําเร็จแล้ว
INVALID_VAT_MODIFICATION ระบบไม่ยอมรับการแก้ไข VAT เนื่องจากมีคําขอที่ไม่ถูกต้อง