ภาพรวม
Card FOP (รูปแบบการชำระเงิน) API สนับสนุนการชำระเงินที่ดำเนินการโดยใช้ บัตรมาตรฐาน ซึ่งอาจเป็นบัตรเครดิตและบัตรเดบิต มีทั้งโปรไฟล์ แสดงขั้นตอนแบบข้อความคู่สำหรับการชำระเงิน
แนวคิดสำคัญ
สัญลักษณ์และการประชุม
คำสำคัญที่ว่า "ต้อง" "ต้องไม่" "จำเป็น" "จะ" "จะไม่" "ควร" "ไม่ควร" "แนะนำ" "อาจ" และ "ไม่บังคับ" ในเอกสารเหล่านี้มีการตีความตามที่อธิบายไว้ใน RFC 2119
การประทับเวลา
การประทับเวลาทั้งหมดจะแสดงเป็นมิลลิวินาทีนับตั้งแต่ Unix Epoch ตามเวลา UTC
เช่น
- 14 สิงหาคม 2010 เวลา 16:30:00.00 น. GMT = 1281803400000
- 6 พฤศจิกายน 2007 เวลา 21:37:00 น. MST = 1194410220000
จำนวนเงิน
มูลค่าทางการเงินใน API นี้จะแสดงโดยใช้รูปแบบที่เรียกว่า "micros" ซึ่งเป็นมาตรฐานที่ Google ไมโครคือรูปแบบความแม่นยำคงที่ที่เป็นจำนวนเต็ม หากต้องการแทนมูลค่าเงินในระดับไมโคร ให้คูณค่าสกุลเงินมาตรฐานด้วย 1,000,000
เช่น
- USD$1.23 = 1230000 ไมโคร USD
- USD$0.01 = 10,000 ไมโคร USD
การแสดงถึงตัวตน
การเรียกเมธอดทั้งหมดภายใน API นี้ต้องมีลักษณะการทำงานแบบเป็นนิรันดร์ พูดง่ายๆ ผู้ผสานการทำงานไม่ควรพยายามประมวลผลคำขอที่ประมวลผลไปแล้วซ้ำอีก การตอบกลับสำหรับการประมวลผลที่สำเร็จ ควรรายงานแทน วิธีการทั้งหมดมี RequestHeader ทั่วไปซึ่งมี requestId requestId นี้เป็นคีย์ประจำตัวสำหรับการเรียกทั้งหมด
ส่วนคำตอบที่ไม่ใช่เทอร์มินัล (ไม่ใช่ HTTP 200) จะต้องประมวลผลคำตอบเองไม่ได้ ดังนั้น คำขอที่ก่อนหน้านี้ได้รับ 400 เมื่อเรียกใช้เป็นครั้งที่ 2 ต้องไม่แสดงผล 400 โดยไม่ตั้งใจ คำขอต้องได้รับการประเมินซ้ำ ขณะประเมินซ้ำ อาจแสดงคะแนน 400 หรือได้รับการประมวลผลสำเร็จ
ดูข้อมูลเพิ่มเติมเกี่ยวกับความพร้อมได้ ในคำแนะนำโดยละเอียดนี้
ขั้นตอนการจับภาพของการจอง
ขั้นตอนการบันทึกการจองคือขั้นตอนข้อความ 2 ขั้นตอนใน ที่มีการจองเงินไว้ก่อนแล้วจึงจับจ่ายภายหลัง ระหว่างการจอง ไม่มีการเคลื่อนไหวของเงินเกิดขึ้น จากนั้นจะสามารถยกเลิกหรือบันทึกการจองได้ ผลลัพธ์สุดท้ายของการบันทึกหรือยกเลิกจะแสดงไปยัง Google แบบไม่พร้อมกัน ผ่านการแจ้งเตือน
ผู้ผสานรวมการชำระเงินจะใช้
Google ติดตั้งใช้งาน
captureFundsReservationResultNotification
cancelFundsReservationResultNotification
setAcquirerReferenceNumberForCaptureNotification
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการสงวนการจับภาพ โปรดดู คำแนะนำโดยละเอียด
ขั้นตอนการโอนเงิน
ขั้นตอนการโอนเงินเป็นข้อความเดียวใน
จำนวนเงินที่ได้รับโดยตรง ขั้นตอนนี้ประกอบด้วยเมธอดเดียวที่
ดำเนินการโดยผู้ผสานรวมการชำระเงินชื่อ Capture
วิธีนี้
ตรวจสอบหาเงินที่มีอยู่ได้พร้อมกันและรับเงินหากสำเร็จ
ผู้ผสานรวมการชำระเงินจะใช้
Google ติดตั้งใช้งาน
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการโอนเงิน โปรดดูที่ คำแนะนำโดยละเอียด
ขั้นตอนการคืนเงิน
ขั้นตอนการคืนเงินใช้เพื่อคืนเงินที่ได้ก่อนหน้านี้ ที่บันทึกไว้ผ่านขั้นตอนการเก็บข้อมูลสำรองหรือ ขั้นตอนการโอนเงิน
ผู้ผสานรวมการชำระเงินจะใช้
Google ติดตั้งใช้งาน
ดูข้อมูลเพิ่มเติมเกี่ยวกับการคืนเงินได้ที่คู่มือโดยละเอียดนี้
ขั้นตอนการโต้แย้ง
ขั้นตอนการโต้แย้ง ใช้เพื่อแจ้ง Google เกี่ยวกับข้อพิพาทและ การปฏิเสธการชำระเงินที่ลูกค้าต้องการรับเงินคืน การโทรออกทุกครั้ง กล่าวเป็นนัยถึงการเคลื่อนไหวของเงิน แต่กระบวนการนี้สามารถใช้ในการคืนเงินให้ลูกค้าได้ หรือเพื่อคืนค่าและส่งคืนให้ Google ขั้นตอนนี้ใช้ได้ใน นอกเหนือจากขั้นตอนการรายงานการฉ้อโกง แต่ไม่ได้ จะต้องมีการฉ้อโกงด้วย
Google ติดตั้งใช้งาน
ดูข้อมูลเพิ่มเติมเกี่ยวกับการโต้แย้งได้ในคำแนะนำโดยละเอียดนี้
ขั้นตอนการรายงานการประพฤติมิชอบ
ขั้นตอนการรายงานการประพฤติมิชอบมีไว้เพื่อแจ้งให้ Google ทราบ การฉ้อโกงที่อาจเกิดขึ้น ข้อมูลนี้ไม่ได้กล่าวเป็นนัยว่ามีการเคลื่อนไหวทางเงินใดๆ และ เพียงแค่ใช้เพื่อแจ้งให้เครื่องมือความเสี่ยงของ Google ทราบเกี่ยวกับเหตุการณ์ดังกล่าว เพื่อให้การทุจริตโดยรวม สามารถลดขนาดลงได้ กรณีนี้อาจมาพร้อมกับการโต้แย้งหรือการปฏิเสธการชำระเงินผ่านทาง ขั้นตอนการโต้แย้ง
Google ติดตั้งใช้งาน
ดูข้อมูลเพิ่มเติมเกี่ยวกับการรายงานการประพฤติมิชอบได้ที่ คำแนะนำโดยละเอียด