- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- FeeToVATModification
- AcceptRemittanceStatementWithModificationsResultCode
แจ้งให้ Google ทราบว่าข้อความที่ระบุไว้ในคำขอนี้จะได้รับการชำระหลังจากมีการแก้ไขในใบแจ้งยอด เช่น ค่าธรรมเนียมในการจัดประเภท VAT ใหม่
การตอบกลับการค้นหานี้อาจว่างเปล่าหากเมธอดนี้ไม่ได้แสดงผล 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 |
ต้องระบุ: นี่คือตัวระบุบัญชีของผู้รวมการชำระเงินที่ระบุข้อจำกัดทางสัญญาเกี่ยวกับใบแจ้งยอดนี้ |
statementId |
ต้องระบุ: รหัสคำขอของการแจ้งเตือนเกี่ยวกับใบแจ้งยอดนี้มีการแก้ไข |
ฟิลด์การรวม
|
|
feeToVatModification |
ต้องระบุ: การแก้ไขที่ขอเพื่อระบุค่าธรรมเนียมส่วนหนึ่งเป็นภาษีมูลค่าเพิ่ม (VAT) อีกครั้ง |
เนื้อหาการตอบกลับ
ออบเจ็กต์การตอบกลับสำหรับเมธอด acceptRemittanceStatementWithModifications
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "responseHeader": { object ( |
ช่อง | |
---|---|
responseHeader |
ต้องระบุ: ส่วนหัวทั่วไปสำหรับคำตอบทั้งหมด |
acceptRemittanceStatementWithModificationsResultCode |
ต้องระบุ: ผลของการเรียก v1.acceptRemittanceStatement |
FeeToVATModification
ออบเจ็กต์นี้ระบุการแก้ไขภาษีที่จะนำไปใช้กับใบแจ้งยอดการส่งเงิน
การแสดง JSON |
---|
{ "vatToFeeRatioInMicros": string } |
ช่อง | |
---|---|
vatToFeeRatioInMicros |
ต้องระบุ: อัตราส่วนของ VAT ต่อค่าธรรมเนียมในหน่วยไมโคร ค่านี้คือเปอร์เซ็นต์ของค่าธรรมเนียมที่จะพิจารณา VAT ใหม่ และต้องมากกว่าหรือเท่ากับ 0 การปัดเศษควรเป็น "เลขคู่" หรือ "ธนาคารของ" การปัดเศษ ซึ่งหมายถึงการปัดเศษให้เป็นตำแหน่งเท่าๆ กันในกรณีที่ทั้ง 2 จำนวนมีระยะห่างเท่ากัน (เช่น 2.5 -> 2, 5.5 -> 6) ตัวอย่างสำหรับการคำนวณภาษีมีดังนี้
|
AcceptRemittanceStatementWithModificationsResultCode
Enum | |
---|---|
UNKNOWN_RESULT |
ห้ามตั้งค่าเริ่มต้นนี้เป็นอันขาด |
SUCCESS |
ยอมรับใบแจ้งยอดการโอนเงินโดยแก้ไขเรียบร้อยแล้ว |
INVALID_VAT_MODIFICATION |
ระบบไม่ยอมรับการแก้ไข VAT เนื่องจากคำขอไม่ถูกต้อง |