> การปรับปรุงกระบวนการอย่างต่อเนื่อง > การประมวลผลการชำระเงิน > Adyen > เทมเพลตข้อมูล

เทมเพลตข้อมูลการประมวลผลการชำระเงินของคุณ

Adyen

แอตทริบิวต์การประมวลผลการชำระเงิน(19) กิจกรรมในการประมวลผลการชำระเงิน(16) คู่มือการดึงข้อมูล(2)

เทมเพลตข้อมูลการประมวลผลการชำระเงินของคุณ

เทมเพลตนี้แนะนำข้อมูลที่จำเป็นสำหรับวิเคราะห์กระบวนการประมวลผลการชำระเงินใน Adyen โดยระบุแอตทริบิวต์ข้อมูลและกิจกรรมในกระบวนการที่ควรติดตาม พร้อมคำแนะนำที่นำไปใช้ได้จริงในการดึงข้อมูล ใช้เทมเพลตนี้เพื่อเก็บข้อมูลสำคัญให้ครบสำหรับการทำ process mining อย่างมีประสิทธิภาพ.

แอตทริบิวต์ที่แนะนำให้รวบรวม
กิจกรรมสำคัญที่ควรติดตาม
คำแนะนำในการดึงข้อมูลจาก Adyen

เพิ่งเริ่มใช้บันทึกเหตุการณ์ใช่ไหม เรียนรู้ วิธีสร้าง event log สำหรับ process mining.

ดาวน์โหลดเทมเพลต

แอตทริบิวต์การประมวลผลการชำระเงิน

ฟิลด์ข้อมูลเหล่านี้เป็นรายการที่แนะนำให้ใส่ในบันทึกเหตุการณ์ เพื่อวิเคราะห์กระบวนการประมวลผลการชำระเงินใน Adyen ได้อย่างครบถ้วน.

5 จำเป็น 6 แนะนำ 8 ไม่บังคับ

	ชื่อ	คำอธิบาย
	Payment Transaction ID PspReference	รหัสอ้างอิงเฉพาะที่ Adyen กำหนดให้กับธุรกรรมการชำระเงินแต่ละรายการ.
คำอธิบาย แอตทริบิวต์นี้ทำหน้าที่เป็นคีย์หลักตลอดวงจรการชำระเงินในระบบ Adyen โดยเชื่อมคำขอชำระเงินเริ่มต้นกับเหตุการณ์ที่ตามมา เช่น การอนุมัติ การเรียกเก็บเงิน การชำระบัญชี และการคืนเงินหรือการเรียกคืนเงิน ในการวิเคราะห์ จะใช้ ID นี้จัดกลุ่มเหตุการณ์ที่แยกจากกันให้เป็นกรณีเดียว เพื่อสร้างกระบวนการตั้งแต่ต้นจนจบขึ้นใหม่ นักวิเคราะห์จึงติดตามเส้นทางของการชำระเงินแต่ละรายการได้ ตั้งแต่ผู้ซื้อเริ่มทำรายการจนถึงการชำระบัญชีทางการเงินขั้นสุดท้าย. เหตุผลที่สำคัญ เป็นตัวเชื่อมหลักที่ใช้รวมเหตุการณ์ที่แยกจากกันให้เป็นอินสแตนซ์กระบวนการเดียวสำหรับทำ process mining. แหล่งข้อมูล คอลัมน์ 'pspReference' ใน Adyen Payment Response หรือคอลัมน์ 'PSP Reference' ใน Settlement Detail Report. ตัวอย่าง 851564567890123479145612345678908825641234567890
	ชื่อกิจกรรม EventCode	ขั้นตอนหรือการดำเนินการที่เกิดขึ้นในวงจรการชำระเงิน.
คำอธิบาย แอตทริบิวต์นี้ระบุเหตุการณ์ที่เกิดขึ้น เช่น AUTHORISATION, CAPTURE หรือ REFUND ซึ่งกำหนดโหนดในแผนผังกระบวนการและลำดับการทำธุรกรรม ในการวิเคราะห์ รหัสเหล่านี้จะแปลงเป็นชื่อกิจกรรมที่อ่านเข้าใจได้เพื่อแสดงลำดับการทำงานของกระบวนการ ความแตกต่างของลำดับรหัสบ่งบอกเส้นทางกระบวนการที่ต่างกัน เช่น การประมวลผลอัตโนมัติตั้งแต่ต้นจนจบกับการจัดการกรณียกเว้น. เหตุผลที่สำคัญ ระบุว่าเกิดอะไรขึ้นในโมเดล process mining และช่วยแสดงลำดับการทำงานของกระบวนการ. แหล่งข้อมูล ฟิลด์ 'eventCode' ใน Adyen Notification Webhooks. ตัวอย่าง AUTHORISATIONCAPTUREREFUNDCANCELLATIONCHARGEBACK
	เวลาที่เกิดเหตุการณ์ EventDate	วันที่และเวลาที่กิจกรรมการชำระเงินนั้นเกิดขึ้น.
คำอธิบาย แอตทริบิวต์นี้บันทึกเวลาที่แน่นอนซึ่งระบบบันทึกเหตุการณ์ เช่น การอนุมัติหรือการชำระเงินเรียบร้อยแล้ว ช่วยจัดเรียงกิจกรรมภายในเคสตามลำดับเวลา ข้อมูลนี้จำเป็นต่อการคำนวณระยะเวลาดำเนินการ การระบุคอขวด และการวัดปริมาณงานที่ระบบประมวลผลได้ในแต่ละช่วงเวลา รวมถึง KPI ที่อิงกับเวลา เช่น 'ระยะเวลารวมของวงจรการชำระเงิน'. เหตุผลที่สำคัญ จำเป็นสำหรับการเรียงลำดับเหตุการณ์และคำนวณตัวชี้วัดด้านระยะเวลาทั้งหมด. แหล่งข้อมูล ฟิลด์ 'eventDate' ใน Adyen Notification Webhooks. ตัวอย่าง 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	ระบบต้นทาง SourceSystem	ชื่อระบบที่เป็นแหล่งที่มาของข้อมูล.
คำอธิบาย แอตทริบิวต์คงที่นี้ระบุว่าระเบียนมาจาก Adyen ซึ่งสำคัญต่อการติดตามที่มาของข้อมูลใน process mining ที่ใช้หลายระบบ เช่น การรวม Adyen กับ SAP ในการวิเคราะห์ ผู้ใช้สามารถกรองกิจกรรมที่เกิดขึ้นในระบบรับชำระเงินโดยเฉพาะ แยกจากกิจกรรมใน ERP หรือระบบจัดการคำสั่งซื้อได้. เหตุผลที่สำคัญ สำคัญต่อการติดตามที่มาของข้อมูลใน process mining ที่ใช้หลายระบบ. แหล่งข้อมูล ค่าไม่เปลี่ยนแปลงระหว่างการดึงข้อมูล. ตัวอย่าง AdyenAdyen_Production
	อัปเดตข้อมูลล่าสุด LastDataUpdate	เวลาที่ดึงหรือรีเฟรชระเบียนครั้งล่าสุด.
คำอธิบาย แอตทริบิวต์นี้บอกว่าข้อมูลในโมเดล process mining เป็นข้อมูลล่าสุดเพียงใด ช่วยให้ผู้ใช้ทราบว่ากำลังดูข้อมูลแบบเรียลไทม์หรือสแนปชอต ในการวิเคราะห์ ฟิลด์นี้ใช้เป็นหลักในงานด้านเทคนิค เช่น การกำกับดูแลข้อมูลและตรวจสอบว่ากระบวนการส่งข้อมูลทำงานถูกต้อง. เหตุผลที่สำคัญ ฟิลด์ทางเทคนิคสำหรับติดตามความใหม่ของข้อมูล. แหล่งข้อมูล เวลาของระบบขณะดึงข้อมูล. ตัวอย่าง 2023-10-30T12:00:00Z
	บัญชีผู้ค้า MerchantAccount	บัญชีผู้ค้าเฉพาะใน Adyen ที่ใช้ประมวลผลธุรกรรม.
คำอธิบาย Adyen รองรับบัญชีผู้ค้าหลายบัญชีภายใต้บัญชีบริษัทเดียว แอตทริบิวต์นี้ระบุหน่วยธุรกิจ แบรนด์ หรือนิติบุคคลในแต่ละภูมิภาคที่ประมวลผลการชำระเงิน ในการวิเคราะห์ ใช้แอตทริบิวต์นี้เป็นมิติหลักในการแบ่งกลุ่ม ผู้เกี่ยวข้องสามารถเปรียบเทียบผลการดำเนินงาน อัตราความล้มเหลว และปริมาณธุรกรรมระหว่างหน่วยธุรกิจหรือแบรนด์ เพื่อหาจุดที่ควรปรับปรุงได้. เหตุผลที่สำคัญ ใช้แบ่งผลการดำเนินงานตามหน่วยธุรกิจหรือบริษัทในเครือ. แหล่งข้อมูล ฟิลด์ 'merchantAccount' ในคำขอ/การตอบกลับการชำระเงินของ Adyen. ตัวอย่าง MyStore_UKMyStore_USGlobalSales_Main
	มีการทำงานซ้ำหรือไม่ IsRework	ตัวบ่งชี้ว่าธุรกรรมมีการลองใหม่หรือแก้ไขข้อผิดพลาดหรือไม่.
คำอธิบาย ค่านี้เป็นจริงเมื่อเคสมีการพยายามอนุมัติหลายครั้ง หรือมีกิจกรรมอย่าง 'ปฏิเสธการชำระเงิน' ตามด้วยการลองใหม่ ข้อมูลนี้ใช้ขับเคลื่อนแดชบอร์ด 'จุดที่เกิดงานซ้ำและข้อยกเว้นในการชำระเงิน' นักวิเคราะห์สามารถกรองเคสที่มีปัญหาเพื่อหาสาเหตุที่ลำดับการทำงานไม่เป็นไปตามขั้นตอนปกติ. เหตุผลที่สำคัญ ระบุเคสที่ไม่มีประสิทธิภาพและต้องให้คนหรือระบบเข้ามาจัดการ. แหล่งข้อมูล คำนวณจากจำนวนเหตุการณ์ที่ล้มเหลวมากกว่า 0. ตัวอย่าง truefalse
	ยอดธุรกรรม PaymentAmount	มูลค่าเงินของธุรกรรมการชำระเงิน.
คำอธิบาย แอตทริบิวต์นี้แสดงมูลค่าทางการเงินของธุรกรรม โดยข้อมูลดิบมักจัดเก็บเป็นหน่วยย่อย เช่น เซนต์ แต่ควรแปลงหน่วยก่อนนำไปทำรายงาน ข้อมูลนี้ใช้สร้างแดชบอร์ด 'ปริมาณการชำระเงิน' และช่วยจัดลำดับความสำคัญของเคสที่ต้องทำงานซ้ำซึ่งมีมูลค่าสูง นอกจากนี้ยังใช้คำนวณยอดรวมที่ประมวลผลและผลกระทบทางการเงินจากธุรกรรมที่ล้มเหลว. เหตุผลที่สำคัญ จำเป็นต่อการวิเคราะห์ผลกระทบทางการเงินและติดตามปริมาณธุรกรรมที่ประมวลผล. แหล่งข้อมูล ฟิลด์ 'amount.value' ในคำขอชำระเงินของ Adyen. ตัวอย่าง 10005509900
	วิธีชำระเงิน PaymentMethod	วิธีที่ผู้ซื้อใช้ชำระเงิน เช่น Visa หรือ PayPal.
คำอธิบาย แอตทริบิวต์นี้บันทึกประเภทเครื่องมือที่ใช้ชำระเงิน เช่น บัตรเครดิต (Visa, MC) กระเป๋าเงินดิจิทัล (PayPal, Apple Pay) หรือวิธีชำระเงินในท้องถิ่น (iDEAL, Sofort) ข้อมูลนี้สำคัญต่อแดชบอร์ด 'ข้อมูลเชิงลึกด้านประสิทธิภาพของวิธีชำระเงิน' โดยช่วยให้เห็นความสัมพันธ์ระหว่างวิธีชำระเงินแต่ละแบบกับอัตราการอนุมัติ ความเร็วในการประมวลผล และปัญหาทางเทคนิค. เหตุผลที่สำคัญ จำเป็นต่อการวิเคราะห์อัตราความสำเร็จและต้นทุนของผู้ให้บริการชำระเงินแต่ละราย. แหล่งข้อมูล ฟิลด์ 'paymentMethod.brand' หรือ 'paymentMethod.type' ในการตอบกลับการชำระเงินของ Adyen. ตัวอย่าง visamcpaypalidealklarna
	สถานะการชำระเงิน PaymentStatus	สถานะปัจจุบันของการชำระเงิน เช่น อนุมัติแล้ว ชำระแล้ว หรือถูกปฏิเสธ.
คำอธิบาย แอตทริบิวต์นี้แสดงสถานะล่าสุดที่ทราบของธุรกรรมการชำระเงิน โดยมักได้มาจากกิจกรรมล่าสุดในเคส ผู้ใช้สามารถกรองเคสได้อย่างรวดเร็ว เช่น 'แสดงการชำระเงินที่ถูกปฏิเสธทั้งหมดในขณะนี้' และใช้ข้อมูลนี้กับแดชบอร์ด 'ติดตามปริมาณและสถานะการชำระเงิน'. เหตุผลที่สำคัญ แสดงภาพรวมสถานะปัจจุบันของธุรกรรม. แหล่งข้อมูล ได้จากรหัสเหตุการณ์ล่าสุดในเคส. ตัวอย่าง ชำระแล้วถูกปฏิเสธอนุมัติแล้ว
	เหตุผลที่ปฏิเสธ RefusalReason	ข้อความอธิบายสาเหตุที่ปฏิเสธหรือทำให้การชำระเงินล้มเหลว.
คำอธิบาย เมื่อธุรกรรมล้มเหลว Adyen จะแสดงรหัสหรือคำอธิบายเหตุผล เช่น 'ยอดเงินไม่เพียงพอ', 'CVC ไม่ผ่านการตรวจสอบ' หรือ 'บัตรหมดอายุ' ข้อมูลนี้เป็นปัจจัยหลักของแดชบอร์ด 'อัตราความล้มเหลวของธุรกรรมการชำระเงิน' การวิเคราะห์เหตุผลช่วยแยกได้ว่าความล้มเหลวเกิดจากปัญหาทางเทคนิค กฎป้องกันการฉ้อโกง หรือพฤติกรรมของผู้ซื้อ และช่วยกำหนดแนวทางแก้ไขได้ตรงจุด. เหตุผลที่สำคัญ แอตทริบิวต์หลักสำหรับวิเคราะห์สาเหตุที่แท้จริงของการชำระเงินที่ล้มเหลว. แหล่งข้อมูล ฟิลด์ 'refusalReason' ในการตอบกลับการชำระเงินของ Adyen. ตัวอย่าง ถูกปฏิเสธยอดเงินไม่เพียงพอบัตรหมดอายุข้อผิดพลาดจากธนาคารผู้รับบัตรการฉ้อโกง
	คะแนนความเสี่ยงการฉ้อโกง RiskScore	คะแนนความเสี่ยงที่ระบบตรวจจับการฉ้อโกงกำหนดให้ธุรกรรม.
คำอธิบาย ระบบ RevenueProtect ของ Adyen ให้คะแนนตั้งแต่ 0 ถึง 100 เพื่อบ่งชี้โอกาสเกิดการฉ้อโกง คะแนนที่สูงขึ้นมักทำให้ต้องตรวจสอบด้วยตนเองหรือถูกบล็อกโดยอัตโนมัติ ข้อมูลนี้ใช้ใน 'ภาพรวมความเสี่ยงด้านการปฏิบัติตามข้อกำหนดทางการเงิน' เมื่อนำคะแนนความเสี่ยงสูงมาเทียบกับรายการ chargeback จะช่วยปรับกฎป้องกันการฉ้อโกงได้ หากคะแนนสูงแต่ธุรกรรมยังสำเร็จ อาจหมายถึงโมเดลความเสี่ยงแจ้งเตือนผิดพลาด. เหตุผลที่สำคัญ จำเป็นต่อการวิเคราะห์ประสิทธิภาพของกฎป้องกันการฉ้อโกง. แหล่งข้อมูล การตอบกลับจาก Adyen Risk API หรือฟิลด์ 'fraudResult.accountScore' ในรายงาน. ตัวอย่าง 025100
	ประเทศของผู้ซื้อ ShopperCountry	รหัสประเทศสองตัวอักษรของผู้ซื้อ.
คำอธิบาย แอตทริบิวต์นี้ระบุตำแหน่งของผู้ซื้อ โดยทั่วไปได้มาจากประเทศที่ออกบัตรหรือที่อยู่สำหรับเรียกเก็บเงิน ในการวิเคราะห์ ใช้เปรียบเทียบผลการดำเนินงานตามภูมิภาค และช่วยตรวจสอบว่าบางประเทศมีอัตราการปฏิเสธสูงหรือใช้เวลาประมวลผลนานกว่า เนื่องจากโครงสร้างพื้นฐานของธนาคารในพื้นที่. เหตุผลที่สำคัญ ใช้แบ่งผลการดำเนินงานด้านการชำระเงินตามพื้นที่ทางภูมิศาสตร์. แหล่งข้อมูล ฟิลด์ 'countryCode' หรือ 'billingAddress.country' ในคำขอชำระเงินของ Adyen. ตัวอย่าง NLUSDE
	ประเภทการโต้ตอบของผู้ซื้อ ShopperInteraction	ระบุว่าการชำระเงินเป็น Ecommerce, POS หรือการสมัครสมาชิก (ContAuth).
คำอธิบาย แอตทริบิวต์นี้จัดประเภทลักษณะการโต้ตอบระหว่างผู้ซื้อกับผู้ค้า ค่าที่พบบ่อย ได้แก่ `Ecommerce` (ออนไลน์), `POS` (หน้าร้าน) และ `ContAuth` (ชำระเงินประจำ/สมัครสมาชิก) ข้อมูลนี้ช่วยแยกโมเดลธุรกิจและช่องทางการขาย ลำดับการทำงานของ POS กับ Ecommerce มักแตกต่างกันมาก จึงใช้เป็นตัวกรองสำคัญเพื่อค้นหากระบวนการได้ชัดเจน. เหตุผลที่สำคัญ แยกลำดับการทำงานของการชำระเงินออนไลน์ หน้าร้าน และแบบประจำ. แหล่งข้อมูล ฟิลด์ 'shopperInteraction' ในคำขอชำระเงินของ Adyen. ตัวอย่าง EcommerceContAuthPOSMoto
	รหัสลูกค้า ShopperReference	รหัสอ้างอิงเฉพาะที่ใช้ระบุผู้ซื้อในหลายธุรกรรม.
คำอธิบาย รหัสนี้เชื่อมโยงธุรกรรมต่างๆ กับลูกค้ารายเดียวกัน โดยผู้ค้าจะส่งรหัสนี้ไปพร้อมคำขอชำระเงิน ในการวิเคราะห์ ช่วยให้วิเคราะห์ข้อมูลโดยยึดลูกค้าเป็นหลัก เช่น ตรวจหาผู้กระทำผิดซ้ำในกรณีฉ้อโกง หรือระบุลูกค้าประจำจากธุรกรรมที่สำเร็จ และใช้จับคู่กับข้อมูลลูกค้าทั่วไปได้. เหตุผลที่สำคัญ ช่วยรวมข้อมูลและวิเคราะห์พฤติกรรมในระดับลูกค้า. แหล่งข้อมูล ฟิลด์ 'shopperReference' ในคำขอชำระเงินของ Adyen. ตัวอย่าง CUST-001user_12345email@example.com
	รหัสอนุมัติ AuthorisationCode	รหัสอนุมัติที่ธนาคารผู้ออกบัตรส่งกลับเมื่ออนุมัติรายการ.
คำอธิบาย รหัสที่ยืนยันว่ามีการกันวงเงินไว้ในบัตรของผู้ซื้อ เป็นหลักฐานว่าการอนุมัติสำเร็จ ในการวิเคราะห์ ใช้เป็นหลักฐานสำหรับการตรวจสอบและติดตามย้อนหลัง เพื่อยืนยันว่ากิจกรรม 'อนุมัติการชำระเงิน' เกิดขึ้นจริง. เหตุผลที่สำคัญ หลักฐานการอนุมัติสำเร็จสำหรับใช้ตรวจสอบย้อนหลัง. แหล่งข้อมูล ฟิลด์ 'authCode' ในการตอบกลับการชำระเงินของ Adyen. ตัวอย่าง 123456098712
	เลขอ้างอิงธนาคารผู้รับบัตร AcquirerReference	หมายเลขอ้างอิงที่ธนาคารผู้รับบัตรกำหนดให้.
คำอธิบาย เลขอ้างอิงภายนอกที่สถาบันการเงินผู้ประมวลผลธุรกรรมบัตร (ธนาคารผู้รับบัตร) กำหนดให้ ซึ่งแตกต่างจาก PSP reference ของ Adyen ฟิลด์นี้สำคัญต่อ 'การวิเคราะห์ความล่าช้าในการกระทบยอดการชำระเงิน' โดยใช้จับคู่ระเบียนของ Adyen กับรายการเดินบัญชีในระบบบัญชีภายนอก. เหตุผลที่สำคัญ จำเป็นต่อการจับคู่ข้อมูลสามทางและการกระทบยอดกับข้อมูลภายนอก. แหล่งข้อมูล ฟิลด์ 'additionalData.acquirerReference' ในการตอบกลับการชำระเงินของ Adyen. ตัวอย่าง 1234567890987654321
	สกุลเงิน PaymentCurrency	รหัส ISO สามตัวอักษรที่ระบุสกุลเงินของธุรกรรม.
คำอธิบาย แอตทริบิวต์นี้ระบุสกุลเงินที่ใช้แสดงค่า `PaymentAmount` โดยค่าที่พบบ่อย ได้แก่ EUR, USD และ GBP ในการวิเคราะห์ ใช้จัดกลุ่มธุรกรรมตามตลาด และช่วยปรับมูลค่าทางการเงินให้อยู่ในมาตรฐานเดียวกันเมื่อนำข้อมูลจากหลายภูมิภาคมารวมกัน. เหตุผลที่สำคัญ ระบุสกุลเงินของยอดเงินสำหรับรายงานที่มีหลายสกุลเงิน. แหล่งข้อมูล ฟิลด์ 'amount.currency' ในคำขอชำระเงินของ Adyen. ตัวอย่าง EURUSDGBP
	หมายเลขชุดการจ่ายเงิน BatchNumber	หมายเลขชุดที่ใช้ระบุการจ่ายเงิน.
คำอธิบาย Adyen จัดกลุ่มการชำระเงินที่ชำระเสร็จแล้วเป็นชุดเพื่อจ่ายเงิน แอตทริบิวต์นี้ระบุว่าธุรกรรมแต่ละรายการอยู่ในชุดใด ในการวิเคราะห์ ใช้จัดกลุ่มการชำระเงินตามรอบการจ่ายเงิน ช่วยตรวจสอบว่าชุดใดล่าช้า และติดตามกิจกรรม 'ชำระเงินเรียบร้อยแล้ว'. เหตุผลที่สำคัญ เชื่อมโยงธุรกรรมแต่ละรายการกับการชำระเงินก้อนใหญ่. แหล่งข้อมูล ฟิลด์ 'Batch Number' ในรายงานรายละเอียดการชำระเงินของ Adyen. ตัวอย่าง 100255

จำเป็น แนะนำ ไม่บังคับ

กิจกรรมในการประมวลผลการชำระเงิน

ขั้นตอนและจุดสำคัญของกระบวนการที่ควรบันทึกไว้ในบันทึกเหตุการณ์ เพื่อค้นพบกระบวนการชำระเงินใน Adyen ได้อย่างแม่นยำ.

5 แนะนำ 11 ไม่บังคับ

	กิจกรรม	คำอธิบาย
	ชำระบัญชีการชำระเงินแล้ว	เคลียร์เงินและนำเข้าบัญชี Adyen ของร้านค้าสำเร็จ โดยข้อมูลนี้ปรากฏใน Settlement Detail Report.
เหตุผลที่สำคัญ เป็นจุดสิ้นสุดทางการเงินของกระบวนการที่สำเร็จ จำเป็นต่อการวัด 'Overall Payment Cycle Time' และ 'Payment Reconciliation Delay Analysis'. แหล่งข้อมูล Adyen Settlement Detail Report (SDR), record type 'Settled'. บันทึก บันทึกเมื่อธุรกรรมปรากฏใน Settlement Report ประเภทเหตุการณ์ explicit
	ได้รับคำขอชำระเงิน	แพลตฟอร์มชำระเงิน Adyen ได้รับคำขอธุรกรรมเป็นครั้งแรก โดยบันทึกจากเวลาที่ส่งคำขอ API ครั้งแรกหรือเวลาที่สร้าง pspReference.
เหตุผลที่สำคัญ ระบุจุดเริ่มต้นที่แท้จริงของแต่ละอินสแตนซ์กระบวนการ ซึ่งจำเป็นต่อการคำนวณเวลาตั้งแต่ต้นจนจบทั้งหมด. แหล่งข้อมูล บันทึก API การชำระเงินของ Adyen หรือเวลาที่บันทึกไว้เมื่อสร้าง pspReference. บันทึก บันทึกเมื่อสร้าง pspReference ผ่าน API ประเภทเหตุการณ์ explicit
	ปฏิเสธการชำระเงิน	ธนาคารผู้ออกบัตรหรือกฎประเมินความเสี่ยงของ Adyen ปฏิเสธธุรกรรม โดยบันทึกผ่าน webhook การอนุมัติที่มีสถานะไม่สำเร็จ.
เหตุผลที่สำคัญ ส่งผลโดยตรงต่อ KPI 'Payment Transaction Failure Rate' การวิเคราะห์เหตุผลที่ถูกปฏิเสธช่วยปรับอัตราการอนุมัติให้ดีขึ้น. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'AUTHORISATION' และ success='false'. บันทึก บันทึกเมื่อ webhook AUTHORISATION ไม่สำเร็จ ประเภทเหตุการณ์ explicit
	เรียกเก็บเงินแล้ว	คำสั่งโอนเงินจากผู้ซื้อไปยังร้านค้าดำเนินการสำเร็จ อาจเกิดขึ้นทันที (เรียกเก็บเงินอัตโนมัติ) หรือภายหลัง (เรียกเก็บเงินด้วยตนเอง).
เหตุผลที่สำคัญ ยืนยันการรับรู้รายได้ ระยะเวลาระหว่างการอนุมัติกับการเรียกเก็บเงินเป็นข้อมูลสำคัญสำหรับ KPI 'Payment Authorization Lead Time'. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'CAPTURE' และ success='true'. บันทึก บันทึกเมื่อ webhook CAPTURE สำเร็จ ประเภทเหตุการณ์ explicit
	อนุมัติการชำระเงินแล้ว	ธนาคารผู้ออกบัตรหรือวิธีชำระเงินอนุมัติธุรกรรมและกันวงเงินไว้ โดยบันทึกผ่าน webhook แจ้งเตือนมาตรฐานของ Adyen.
เหตุผลที่สำคัญ เป็นจุดสำคัญที่ยืนยันว่าธุรกรรมถูกต้องและมีเงินพร้อมใช้ อีกทั้งเป็นเงื่อนไขก่อนการเรียกเก็บเงิน. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'AUTHORISATION' และ success='true'. บันทึก บันทึกเมื่อ webhook AUTHORISATION สำเร็จ ประเภทเหตุการณ์ explicit
	กลับรายการเรียกคืนเงิน	ชนะข้อโต้แย้งและได้รับเงินคืนกลับเข้าบัญชีร้านค้า เป็นการแก้ไขกรณียกเว้นได้สำเร็จ.
เหตุผลที่สำคัญ ผลลัพธ์ที่ดีต่อการบริหารความเสี่ยง และช่วยชดเชยผลกระทบทางการเงินจากการเรียกคืนเงินครั้งแรก. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'CHARGEBACK_REVERSED'. บันทึก บันทึกเมื่อ webhook CHARGEBACK_REVERSED ทำงาน ประเภทเหตุการณ์ explicit
	คืนเงินและชำระบัญชีแล้ว	ดำเนินการคืนเงินทางการเงินแล้วและหักเงินจากบัญชีร้านค้า โดยยืนยันได้จาก Settlement Detail Report.
เหตุผลที่สำคัญ ปิดกระบวนการคืนเงินให้เสร็จสมบูรณ์ หากคืนเงินเนื่องจากข้อผิดพลาด ข้อมูลนี้สำคัญต่อ 'Average Error Resolution Time'. แหล่งข้อมูล Adyen Settlement Detail Report, record type 'Refunded' หรือ 'RefundedReversed'. บันทึก บันทึกเมื่อรายการคืนเงินปรากฏใน Settlement Report ประเภทเหตุการณ์ explicit
	ได้รับการแจ้งเตือนการเรียกคืนเงิน	Adyen ได้รับการแจ้งเตือนการโต้แย้งรายการจากเครือข่ายบัตร ซึ่งจะเริ่มเวิร์กโฟลว์การจัดการข้อโต้แย้ง.
เหตุผลที่สำคัญ เป็นตัวชี้วัดสำคัญด้านการปฏิบัติตามข้อกำหนดและความเสี่ยง ส่งผลต่อ 'Compliance Incident Rate' และต้องให้เจ้าหน้าที่ดำเนินการทันที. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'CHARGEBACK' หรือ 'NOTIFICATION_OF_CHARGEBACK'. บันทึก บันทึกเมื่อ webhook CHARGEBACK ทำงาน ประเภทเหตุการณ์ explicit
	ตรวจสอบความเสี่ยงแล้ว	ระบบ RevenueProtect ของ Adyen วิเคราะห์ธุรกรรมเพื่อค้นหาสัญญาณการฉ้อโกง โดยอนุมานจากการมีคะแนนการฉ้อโกงหรือผลการประเมินความเสี่ยงในผลตอบกลับการอนุมัติ.
เหตุผลที่สำคัญ คะแนนความเสี่ยงสูงอาจทำให้ต้องตรวจสอบด้วยตนเองหรือปฏิเสธโดยอัตโนมัติ ซึ่งอาจทำให้เกิดคอขวดหรือทำให้กระบวนการสิ้นสุด. แหล่งข้อมูล ผลตอบกลับการชำระเงินของ Adyen (ฟิลด์ fraudResult) หรือบันทึก Case Management. บันทึก อนุมานจากการมี fraudResult object ประเภทเหตุการณ์ inferred
	บันทึกข้อผิดพลาดทางเทคนิค	เกิดข้อผิดพลาดของระบบระหว่างประมวลผล เช่น webhook ไม่ทำงานหรือ API หมดเวลารอ ตรวจพบได้จากรหัสข้อผิดพลาดเฉพาะในอินเทอร์เฟซ.
เหตุผลที่สำคัญ ช่วยวิเคราะห์ 'Payment Transaction Failure Rate' โดยตรง ด้วยการแยกข้อผิดพลาดทางเทคนิคออกจากข้อผิดพลาดทางการเงิน. แหล่งข้อมูล บันทึก Adyen Interface หรือการตอบกลับที่ระบุความล้มเหลวในการเรียก API. บันทึก บันทึกเมื่อได้รับรหัสตอบกลับข้อผิดพลาด 5xx หรือ 4xx ประเภทเหตุการณ์ explicit
	ยกเลิกการชำระเงิน	ยกเลิกการอนุมัติก่อนเรียกเก็บเงิน ทำให้วงเงินที่กันไว้ในบัตรของผู้ซื้อกลับมาใช้ได้.
เหตุผลที่สำคัญ แสดงวงจรที่คำสั่งซื้อซึ่งถูกต้องสิ้นสุดก่อนดำเนินการเสร็จ มักเกิดจากคำขอของลูกค้าหรือหมดเวลารอสินค้า. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'CANCELLATION'. บันทึก บันทึกเมื่อ webhook CANCELLATION ทำงาน ประเภทเหตุการณ์ explicit
	ยื่นโต้แย้งการเรียกคืนเงิน	ส่งหลักฐานให้ Adyen เพื่อโต้แย้งการเรียกคืนเงิน ขั้นตอนนี้เป็นการทำงานซ้ำหรือกิจกรรมที่ต้องดำเนินการด้วยตนเองในกระบวนการจัดการข้อโต้แย้ง.
เหตุผลที่สำคัญ ติดตามความพยายามในการปกป้องรายได้ ซึ่งสำคัญต่อ 'Payment Rework Rate'. แหล่งข้อมูล Adyen Disputes API หรือบันทึก Case Management ที่แสดงการส่งหลักฐาน. บันทึก อนุมานจากการเปลี่ยนสถานะเป็น 'Defense Supplied' ประเภทเหตุการณ์ inferred
	ยืนยันการจ่ายเงินให้ร้านค้า	จ่ายเงินจากธุรกรรมที่ชำระบัญชีแล้วในชุดหนึ่งเข้าบัญชีธนาคารของร้านค้า.
เหตุผลที่สำคัญ แสดงการโอนเงินจริงให้ธุรกิจ และเชื่อมโยงกับ 'Payment Reconciliation Cycle Time'. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'PAYOUT_THIRD_PARTY' หรืออนุมานจาก Payout Report. บันทึก เชื่อม batch ID ใน Payout Report กับ Transaction ID ประเภทเหตุการณ์ inferred
	เริ่มคืนเงิน	มีการส่งคำขอคืนเงินให้ผู้ซื้อ ซึ่งเป็นจุดเริ่มต้นของกระบวนการย้อนกลับ.
เหตุผลที่สำคัญ แสดงกรณียกเว้นที่เกิดหลังชำระบัญชี อัตราการคืนเงินที่สูงอาจบ่งชี้ถึงปัญหาคุณภาพในขั้นตอนก่อนหน้า. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'REFUND'. บันทึก บันทึกเมื่อ webhook REFUND เริ่มทำงาน ประเภทเหตุการณ์ explicit
	เรียกเก็บเงินไม่สำเร็จ	การเรียกเก็บเงินจากวงเงินที่อนุมัติไว้ไม่สำเร็จ มักเกิดจากหมดเวลารอของระบบหรือสถานะบัตรเปลี่ยนระหว่างการอนุมัติกับการเรียกเก็บเงิน.
เหตุผลที่สำคัญ เป็นจุดเกิดข้อผิดพลาดสำคัญที่ต้องทำงานซ้ำหรือลองใหม่ และส่งผลต่อ 'Payment Exception Rate'. แหล่งข้อมูล Adyen Notification Webhook: eventCode 'CAPTURE_FAILED'. บันทึก บันทึกเมื่อ webhook CAPTURE_FAILED ทำงาน ประเภทเหตุการณ์ explicit
	ส่งการชำระเงินเพื่อชำระบัญชี	Adyen ส่งธุรกรรมต่อไปยังธนาคารผู้รับบัตรหรือเครือข่ายเพื่อดำเนินการทางการเงิน โดยสถานะจะเปลี่ยนเป็น SentForSettlement.
เหตุผลที่สำคัญ เป็นจุดเปลี่ยนจากการประมวลผลการปฏิบัติงานไปสู่การหักบัญชีทางการเงิน หากล่าช้าในขั้นตอนนี้จะกระทบกระแสเงินสด. แหล่งข้อมูล Adyen Transaction Status API หรืออนุมานจากบันทึกประวัติการเปลี่ยนสถานะ. บันทึก เปรียบเทียบการเปลี่ยนแปลงของฟิลด์สถานะกับ SentForSettlement ประเภทเหตุการณ์ inferred

แนะนำ ไม่บังคับ

คู่มือการดึงข้อมูล

วิธีดึงข้อมูลจาก Adyen

ขั้นตอน

เข้าสู่ระบบ Adyen Customer Area ด้วยบัญชีผู้ใช้ที่มีบทบาท Merchant Report.
ไปที่ Reports แล้วเลือก Settlement details จากเมนู.
ค้นหาการตั้งค่า Automatic generation หรือเลือก Generate report เพื่อส่งออกรายงานครั้งเดียว.
ในแผงการตั้งค่า ตรวจสอบว่า Format ตั้งเป็น CSV (ค่าคั่นด้วยจุลภาค).
ในส่วน Include columns ให้เลือก All หรือเลือกฟิลด์ต่อไปนี้โดยเฉพาะ: Company Account, Merchant Account, Psp Reference, Merchant Reference, Payment Method, Creation Date, TimeZone, Type, Modification Reference, Gross Currency, Gross Debit, Gross Credit, Exchange Rate, Net Currency, Net Debit, Net Credit, Commission, Markup, Scheme Fees และ Interchange.
สำคัญ: ตรวจสอบว่าขอบเขตรายงานรวม Journal Types ทุกประเภท (Settled, Refunded, Chargeback, PaidOut ฯลฯ) เพื่อให้เห็นวงจรทางการเงินทั้งหมด.
สร้างรายงานสำหรับช่วงวันที่ต้องการ (เช่น 90 วันล่าสุด) โปรดทราบว่ารายงานการชำระบัญชีอ้างอิงวันที่ของชุดการชำระบัญชี ไม่ใช่วันที่ทำธุรกรรม.
ดาวน์โหลดไฟล์ CSV ที่สร้างแล้วไปยังสภาพแวดล้อมสำหรับดึงข้อมูลของคุณ.
เรียกใช้สคริปต์แปลงข้อมูล (ที่ให้ไว้ด้านล่าง) เพื่อแปลงข้อมูลบัญชี CSV แบบ 'Wide' เป็นรูปแบบบันทึกเหตุการณ์แบบ 'Long' ที่ ProcessMind ต้องใช้.
สคริปต์จะแปลงข้อมูลสำคัญ โดยแยก Creation Date เพื่อสร้างกิจกรรม 'ได้รับคำขอชำระเงิน' และจับคู่คอลัมน์ Type กับกิจกรรมทางการเงินที่เกี่ยวข้อง.
ตรวจสอบว่าไฟล์ CSV ผลลัพธ์มีส่วนหัวดังนี้: PspReference, EventCode, EventDate, SourceSystem.
อัปโหลดไฟล์ CSV ที่แปลงแล้วไปยัง ProcessMind.

การกำหนดค่า

ประเภทรายงาน: Settlement Detail Report (บัญชีรายการทางการเงิน)
รูปแบบไฟล์: CSV (คั่นข้อมูลด้วยเครื่องหมายจุลภาคตามมาตรฐาน)
ระดับรายละเอียด: ระดับธุรกรรม (หนึ่งแถวต่อรายการบัญชีทางการเงิน)
เขตเวลา: UTC (แนะนำอย่างยิ่งเพื่อให้ช่วงเวลาดึงข้อมูลตรงกับระบบอื่น)
ช่วงวันที่: อ้างอิงชุดการชำระบัญชี (วันที่ปิดชุด) ไม่ใช่วันที่สร้างธุรกรรม หากดึงข้อมูลเป็นรอบ ให้จัดการช่วงเวลาที่ทับซ้อนกัน
คอลัมน์ที่จำเป็น: Psp Reference (คีย์), ประเภท (กิจกรรม), Creation Date, Booking Date (เวลาของเหตุการณ์), Merchant Account
การตั้งค่าตัวกรอง: ตรวจสอบว่าไม่มีตัวกรองที่ตัดรายการประเภท 'Chargeback' หรือ 'Refund' ออก เพื่อให้ข้อมูลกระบวนการครบถ้วน.

ตัวอย่างคำค้น python

import pandas as pd
from datetime import datetime

class=class="hl-string">"hl-comment"># CONFIGURATION
INPUT_FILE = class="hl-string">'settlement_detail_report.csv'
OUTPUT_FILE = class="hl-string">'adyen_event_log.csv'
SOURCE_SYSTEM = class="hl-string">'Adyen'

class=class="hl-string">"hl-comment"># Load the Adyen Settlement Detail Report
class=class="hl-string">"hl-comment"># Skip standard Adyen header rows if present (often reports start on row 1 or have metadata on top)
df = pd.read_csv(INPUT_FILE, keep_default_na=False)

class=class="hl-string">"hl-comment"># Define the output list
event_log = []

class=class="hl-string">"hl-comment"># Helper function to append events
def add_event(psp_ref, activity, timestamp, attributes):
    if not timestamp or str(timestamp).strip() == class="hl-string">'':
        return
    base_event = {
        class="hl-string">'PspReference': psp_ref,
        class="hl-string">'EventCode': activity,
        class="hl-string">'EventDate': timestamp,
        class="hl-string">'SourceSystem': SOURCE_SYSTEM,
        class="hl-string">'LastDataUpdate': datetime.utcnow().isoformat(),
        class="hl-string">'MerchantAccount': attributes.get(class="hl-string">'Merchant Account', class="hl-string">''),
        class="hl-string">'PaymentMethod': attributes.get(class="hl-string">'Payment Method', class="hl-string">''),
        class="hl-string">'PaymentAmount': attributes.get(class="hl-string">'Gross Credit', 0) if attributes.get(class="hl-string">'Gross Credit') else attributes.get(class="hl-string">'Gross Debit', 0) * -1
    }
    class=class="hl-string">"hl-comment"># Merge optional attributes
    base_event.update(attributes)
    event_log.append(base_event)

class=class="hl-string">"hl-comment"># Iterate through the ledger rows
for index, row in df.iterrows():
    psp_ref = row.get(class="hl-string">'Psp Reference')
    journal_type = row.get(class="hl-string">'Type')
    creation_date = row.get(class="hl-string">'Creation Date') class=class="hl-string">"hl-comment"># Used for Auth/Request
    booking_date = row.get(class="hl-string">'Booking Date')   class=class="hl-string">"hl-comment"># Used for Settlement/Financials
    
    class=class="hl-string">"hl-comment"># Common attributes for this row
    row_attrs = {
        class="hl-string">'MerchantAccount': row.get(class="hl-string">'Merchant Account'),
        class="hl-string">'PaymentMethod': row.get(class="hl-string">'Payment Method'),
        class="hl-string">'RefusalReason': row.get(class="hl-string">'Refusal Reason', class="hl-string">''),
        class="hl-string">'PaymentStatus': journal_type
    }

    class=class="hl-string">"hl-comment"># --- 1. DERIVED UPSTREAM ACTIVITIES ---
    class=class="hl-string">"hl-comment"># Since this is a settlement report, we infer the Request/Auth from the Creation Date
    class=class="hl-string">"hl-comment"># of the first record we see for this PSP Reference. 
    class=class="hl-string">"hl-comment"># Logic: If Creation Date exists, implies Request and Auth occurred.
    
    if creation_date:
        class=class="hl-string">"hl-comment"># Activity: Payment Request Received
        add_event(psp_ref, class="hl-string">'Payment Request Received', creation_date, row_attrs)
        
        class=class="hl-string">"hl-comment"># Activity: Risk Screening Performed (Inferred from existence of transaction)
        class=class="hl-string">"hl-comment"># Note: True risk score requires class="hl-string">'Payments Accounting Report', inferred here for process continuity
        add_event(psp_ref, class="hl-string">'Risk Screening Performed', creation_date, row_attrs)
        
        class=class="hl-string">"hl-comment"># Activity: Payment Authorised
        class=class="hl-string">"hl-comment"># Typically happens immediately after request for successful settled items
        add_event(psp_ref, class="hl-string">'Payment Authorised', creation_date, row_attrs)

    class=class="hl-string">"hl-comment"># --- 2. MAPPED FINANCIAL ACTIVITIES ---
    class=class="hl-string">"hl-comment"># Map Adyen Ledger Types to Process Activities using Booking Date
    
    if journal_type == class="hl-string">'Settled':
        add_event(psp_ref, class="hl-string">'Payment Settled', booking_date, row_attrs)
        
        class=class="hl-string">"hl-comment"># Activity: Payment Sent for Settlement
        class=class="hl-string">"hl-comment"># Inferred: Occurs shortly before settlement. 
        class=class="hl-string">"hl-comment"># Using Creation Date if Booking Date is distinct, or defaulting to Booking Date.
        sent_date = creation_date if creation_date else booking_date
        add_event(psp_ref, class="hl-string">'Payment Sent for Settlement', sent_date, row_attrs)

    elif journal_type == class="hl-string">'Refunded':
        add_event(psp_ref, class="hl-string">'Refund Initiated', creation_date, row_attrs)
        add_event(psp_ref, class="hl-string">'Refund Settled', booking_date, row_attrs)

    elif journal_type == class="hl-string">'Chargeback':
        add_event(psp_ref, class="hl-string">'Chargeback Notification Received', booking_date, row_attrs)

    elif journal_type == class="hl-string">'ChargebackRetried':
        add_event(psp_ref, class="hl-string">'Chargeback Defended', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

    elif journal_type == class="hl-string">'ChargebackReversed':
        add_event(psp_ref, class="hl-string">'Chargeback Reversed', booking_date, row_attrs)

    elif journal_type == class="hl-string">'PaidOut':
        class=class="hl-string">"hl-comment"># Payouts often group many transactions. 
        class=class="hl-string">"hl-comment"># If the report is at transaction level, this row represents the batch payout.
        add_event(psp_ref, class="hl-string">'Payout Confirmed', booking_date, row_attrs)

    elif journal_type == class="hl-string">'CaptureFailed':
        add_event(psp_ref, class="hl-string">'Capture Failed', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

    class=class="hl-string">"hl-comment"># --- 3. EXCEPTION HANDLING ---
    class=class="hl-string">"hl-comment"># These statuses often appear in class="hl-string">'Received payment details' reports but rarely in Settlement
    class=class="hl-string">"hl-comment"># unless fees were applied.
    
    elif journal_type == class="hl-string">'Refused': 
        add_event(psp_ref, class="hl-string">'Payment Refused', creation_date, row_attrs)
        
    elif journal_type == class="hl-string">'Cancelled':
        add_event(psp_ref, class="hl-string">'Payment Cancelled', creation_date, row_attrs)

    elif journal_type == class="hl-string">'Error':
        add_event(psp_ref, class="hl-string">'Technical Error Logged', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

class=class="hl-string">"hl-comment"># Convert to DataFrame
events_df = pd.DataFrame(event_log)

class=class="hl-string">"hl-comment"># Deduping: Adyen reports may have multiple lines for partial settlements.
class=class="hl-string">"hl-comment"># We sort by date and keep unique Activity per PSP Reference if timestamps match exactly.
events_df.drop_duplicates(subset=[class="hl-string">'PspReference', class="hl-string">'EventCode', class="hl-string">'EventDate'], inplace=True)

class=class="hl-string">"hl-comment"># Output
events_df.to_csv(OUTPUT_FILE, index=False)
print(fclass="hl-string">'Successfully extracted {len(events_df)} events to {OUTPUT_FILE}')

ขั้นตอน

ตั้งค่าข้อกำหนดเบื้องต้น: ตรวจสอบว่ามีผู้ใช้ Adyen Report ที่เปิดใช้บทบาท Merchant Report แล้ว รับ API Key จาก Customer Area โดยไปที่ Developers > API Credentials.
ระบุรายงานที่ต้องใช้: การดึงข้อมูลนี้ใช้รายงาน CSV หลักสองรายการที่ Adyen สร้าง ได้แก่ Settlement Detail Report (กิจกรรมทางการเงิน เช่น การชำระบัญชี การโต้แย้งรายการ และการคืนเงิน) และ Received Payment Detail Report (กิจกรรมการปฏิบัติงาน เช่น คำขอ การปฏิเสธ และการอนุมัติ).
ตั้งค่าสภาพแวดล้อม Python: ติดตั้งไลบรารีที่จำเป็นด้วย pip ได้แก่ pandas, requests และ numpy เพื่อใช้เชื่อมต่อ API และแปลงข้อมูล.
ตั้งค่าการเชื่อมต่อ API: กำหนดค่าสคริปต์ Python (ที่ให้ไว้ด้านล่าง) ให้ยืนยันตัวตนกับปลายทาง https://management-test.adyen.com หรือ https://management-live.adyen.com ใช้ Report API เพื่อแสดงรายงานที่มีในช่วงวันที่กำหนดและดาวน์โหลด URL ของรายงาน.
นำเข้าข้อมูล: สคริปต์จะอ่านข้อมูล CSV ดิบลงใน pandas DataFrames โดยทั่วไปรายงานของ Adyen จะอยู่ในรูปแบบ 'Wide' (หนึ่งแถวต่อธุรกรรมและมีหลายคอลัมน์สถานะ) จึงต้องแปลงข้อมูลก่อน.
จับคู่กิจกรรมด้านการปฏิบัติงาน: ประมวลผล Received Payment Detail Report โดยจับคู่ CreationDate กับ ได้รับคำขอชำระเงิน ตรวจสอบคอลัมน์ Status (เช่น Authorised, Refused, Error) เพื่อสร้างกิจกรรม อนุมัติการชำระเงิน, ปฏิเสธการชำระเงิน หรือ บันทึกข้อผิดพลาดทางเทคนิค.
จับคู่กิจกรรมทางการเงิน: ประมวลผล Settlement Detail Report ซึ่งมีคอลัมน์ JournalType จับคู่ค่าอย่าง Settled กับ ชำระบัญชีการชำระเงินแล้ว, Refunded กับ เริ่มคืนเงิน และ Chargeback กับ ได้รับการแจ้งเตือนการโต้แย้งรายการ.
อนุมานกิจกรรมที่ซับซ้อน:
- ดำเนินการตรวจสอบความเสี่ยงแล้ว: ตรวจสอบว่าคอลัมน์ FraudScore มีค่าและมากกว่า -1 หรือไม่
- ยืนยันการจ่ายเงินแล้ว: เชื่อมโยงธุรกรรมผ่าน BatchNumber กับรายการจ่ายเงินในรายงานการชำระบัญชี
- โต้แย้งการเรียกเก็บเงินสำเร็จ: ค้นหาประเภทรายการ SecondChargeback หรือ Defense
แปลงข้อมูล: ใช้การดำเนินการ 'melt' หรือ 'stack' ใน pandas เพื่อแปลงชุดข้อมูลแบบ Wide เป็นบันทึกเหตุการณ์แบบ Long โดยแยกแต่ละกิจกรรมเป็นหนึ่งแถว
ปรับมาตรฐานแอตทริบิวต์: เปลี่ยนชื่อคอลัมน์ให้ตรงกับสคีมาเป้าหมาย ได้แก่ PspReference, EventCode, EventDate, SourceSystem (กำหนดค่าเป็น 'Adyen') และ PaymentAmount ตรวจสอบว่าวันที่อยู่ในรูปแบบ ISO 8601
กรองข้อมูล: กรองแถวการกระทบยอดภายในที่ไม่ใช่ขั้นตอนของกระบวนการออก (เช่น แถวส่วนหัวหรือยอดยกมา) โดยใช้ตัวกรอง Type
ส่งออกขั้นสุดท้าย: สคริปต์จะส่งออก DataFrame ที่ประมวลผลแล้วเป็นไฟล์ CSV ชื่อ adyen_event_log.csv ซึ่งพร้อมอัปโหลดไปยัง ProcessMind.

การกำหนดค่า

สภาพแวดล้อม API: เลือกปลายทาง Adyen Test (management-test.adyen.com) หรือ Live (management-live.adyen.com) ตามขั้นตอนการนำไปใช้.
การยืนยันตัวตน: ใช้ x-api-key ในส่วนหัว ห้ามใช้ Basic Auth กับ Management API.
ประเภทรายงาน:
- settlement_detail_report: สำคัญสำหรับกิจกรรมตลอดวงจรการเงิน.
- received_payment_detail_report: สำคัญสำหรับคำขอเริ่มต้นและการอนุมัติ.
ช่วงวันที่: รายงาน Adyen สร้างตามเวลาปิดชุดข้อมูล ตรวจสอบว่าสคริปต์ขอรายงานที่ครอบคลุม CreationDate ที่ต้องการและต่อไปอีก 7 วัน เพื่อเก็บข้อมูลการชำระบัญชีที่ล่าช้า.
ขอบเขตบัญชีผู้ค้า: หากมีบัญชีผู้ค้าหลายบัญชี ให้ดึงข้อมูลจากแต่ละบัญชี หรือใช้รายงานระดับ Company Account หากมี.
การตั้งค่า pandas: หากมีธุรกรรมเกิน 100k แถว ให้ตั้ง low_memory=False ขณะอ่านไฟล์ CSV เพื่อป้องกันข้อผิดพลาดในการอนุมานชนิดข้อมูล.

ตัวอย่างคำค้น python

import pandas as pd
import requests
import io
import numpy as np
from datetime import datetime

class=class="hl-string">"hl-comment"># Configuration
API_KEY = class="hl-string">'YOUR_ADYEN_API_KEY'
MERCHANT_ACCOUNT = class="hl-string">'YOUR_MERCHANT_ACCOUNT'
BASE_URL = class="hl-string">'https://management-live.adyen.com/v1'
HEADERS = {class="hl-string">'x-api-key': API_KEY, class="hl-string">'Content-Type': class="hl-string">'application/json'}

class=class="hl-string">"hl-comment"># Placeholder for fetching report URLs via API
class=class="hl-string">"hl-comment"># In production, use GET /companies/{companyId}/reports or /merchants/{merchantId}/reports
class=class="hl-string">"hl-comment"># For this script, we assume the CSV content is loaded into DataFrames

def transform_adyen_data(received_payments_csv_path, settlement_details_csv_path):
    
    class=class="hl-string">"hl-comment"># 1. Load Data
    print(class="hl-string">'Loading reports...')
    df_received = pd.read_csv(received_payments_csv_path)
    df_settled = pd.read_csv(settlement_details_csv_path)

    events = []

    class=class="hl-string">"hl-comment"># 2. Process Received Payment Detail Report (Operational Events)
    class=class="hl-string">"hl-comment"># This report covers: Request, Auth, Refusal, Risk, Capture, Errors
    
    for _, row in df_received.iterrows():
        psp = str(row.get(class="hl-string">'PspReference', class="hl-string">''))
        created_date = pd.to_datetime(row.get(class="hl-string">'CreationDate'))
        amount = row.get(class="hl-string">'Amount', 0)
        status = row.get(class="hl-string">'Status', class="hl-string">'')
        fraud_score = row.get(class="hl-string">'FraudScore', None)
        refusal_reason = row.get(class="hl-string">'RefusalReason', class="hl-string">'')
        
        class=class="hl-string">"hl-comment"># Activity: Payment Request Received
        events.append({
            class="hl-string">'PspReference': psp,
            class="hl-string">'EventCode': class="hl-string">'Payment Request Received',
            class="hl-string">'EventDate': created_date,
            class="hl-string">'PaymentAmount': amount,
            class="hl-string">'PaymentMethod': row.get(class="hl-string">'PaymentMethod', class="hl-string">''),
            class="hl-string">'RefusalReason': None,
            class="hl-string">'SourceSystem': class="hl-string">'Adyen'
        })

        class=class="hl-string">"hl-comment"># Activity: Risk Screening Performed
        class=class="hl-string">"hl-comment"># Inferred if a fraud score was calculated
        if pd.notna(fraud_score):
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Risk Screening Performed',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=1), class=class="hl-string">"hl-comment"># Slight offset
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

        class=class="hl-string">"hl-comment"># Activity: Payment Authorised / Refused / Error
        if status == class="hl-string">'Authorised':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Authorised',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Refused':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Refused',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'RefusalReason': refusal_reason,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Error':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Technical Error Logged',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'RefusalReason': row.get(class="hl-string">'AcquirerResponse', class="hl-string">'Technical Error'),
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Cancelled':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Cancelled',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=5),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

    class=class="hl-string">"hl-comment"># 3. Process Settlement Detail Report (Financial Events)
    class=class="hl-string">"hl-comment"># This report covers: Capture, Settlement, Refunds, Chargebacks, Payouts
    
    for _, row in df_settled.iterrows():
        psp = str(row.get(class="hl-string">'PspReference', class="hl-string">''))
        journal_type = row.get(class="hl-string">'JournalType', class="hl-string">'')
        process_date = pd.to_datetime(row.get(class="hl-string">'CreationDate')) class=class="hl-string">"hl-comment"># Or ProcessingDate
        amount = row.get(class="hl-string">'NetCredit', 0) if pd.notna(row.get(class="hl-string">'NetCredit')) else row.get(class="hl-string">'GrossCredit', 0)
        
        class=class="hl-string">"hl-comment"># Map JournalType to Activities
        activity_name = None
        
        if journal_type == class="hl-string">'SentForSettlement':
            activity_name = class="hl-string">'Payment Sent for Settlement'
        elif journal_type == class="hl-string">'Settled':
            activity_name = class="hl-string">'Payment Settled'
        elif journal_type == class="hl-string">'SentForRefund' or journal_type == class="hl-string">'Refunded':
            activity_name = class="hl-string">'Refund Initiated'
        elif journal_type == class="hl-string">'SettledRefund':
            activity_name = class="hl-string">'Refund Settled'
        elif journal_type == class="hl-string">'Chargeback':
            activity_name = class="hl-string">'Chargeback Notification Received'
        elif journal_type == class="hl-string">'SecondChargeback' or journal_type == class="hl-string">'Defense':
            activity_name = class="hl-string">'Chargeback Defended'
        elif journal_type == class="hl-string">'ChargebackReversed':
            activity_name = class="hl-string">'Chargeback Reversed'
        elif journal_type == class="hl-string">'CaptureFailed':
            activity_name = class="hl-string">'Capture Failed'
        elif journal_type == class="hl-string">'PaidOut':
            class=class="hl-string">"hl-comment"># PaidOut is usually batch level, if psp is present, map it
            activity_name = class="hl-string">'Payout Confirmed'
        
        class=class="hl-string">"hl-comment"># Logic for class="hl-string">'Payment Captured' 
        class=class="hl-string">"hl-comment"># Adyen often auto-captures. If we see Settled, we assume Captured occurred prior if not explicitly logged.
        class=class="hl-string">"hl-comment"># Here we rely on class="hl-string">'SentForSettlement' as the trigger for Capture success in many flows.
        if journal_type == class="hl-string">'SentForSettlement':
             events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Captured',
                class="hl-string">'EventDate': process_date - pd.Timedelta(seconds=1),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

        if activity_name:
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': activity_name,
                class="hl-string">'EventDate': process_date,
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen',
                class="hl-string">'MerchantAccount': row.get(class="hl-string">'MerchantAccount', MERCHANT_ACCOUNT),
                class="hl-string">'PaymentMethod': row.get(class="hl-string">'PaymentMethod', class="hl-string">'')
            })

    class=class="hl-string">"hl-comment"># 4. Create DataFrame
    df_events = pd.DataFrame(events)
    
    class=class="hl-string">"hl-comment"># 5. Post-Processing & Cleanup
    if not df_events.empty:
        class=class="hl-string">"hl-comment"># Ensure standard columns
        df_events[class="hl-string">'LastDataUpdate'] = datetime.now().isoformat()
        df_events[class="hl-string">'TotalCycleTime'] = None class=class="hl-string">"hl-comment"># Calculated in ProcessMind
        df_events[class="hl-string">'IsRework'] = df_events[class="hl-string">'EventCode'].apply(lambda x: 1 if class="hl-string">'Chargeback' in x or class="hl-string">'Refused' in x else 0)
        df_events[class="hl-string">'PaymentStatus'] = df_events.sort_values(class="hl-string">'EventDate').groupby(class="hl-string">'PspReference')[class="hl-string">'EventCode'].transform(class="hl-string">'last')
        
        class=class="hl-string">"hl-comment"># Filter invalid rows (empty PspReference)
        df_events = df_events[df_events[class="hl-string">'PspReference'] != class="hl-string">'nan']
        df_events = df_events[df_events[class="hl-string">'PspReference'] != class="hl-string">'']

        class=class="hl-string">"hl-comment"># Sort
        df_events = df_events.sort_values([class="hl-string">'PspReference', class="hl-string">'EventDate'])
        
    return df_events

class=class="hl-string">"hl-comment"># Execution Entry Point
class=class="hl-string">"hl-comment"># Replace paths with actual file locations or API download streams
if __name__ == class="hl-string">'__main__':
    class=class="hl-string">"hl-comment"># Example usage
    df_log = transform_adyen_data(class="hl-string">'received_payment_detail_report.csv', class="hl-string">'settlement_detail_report.csv')
    
    class=class="hl-string">"hl-comment"># Export
    df_log.to_csv(class="hl-string">'ProcessMind_Adyen_Log.csv', index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">'Extraction Complete. Generated {len(df_log)} events.')

พร้อมเริ่มต้นหรือยัง?

ใช้เทมเพลตนี้เพื่อจัดระเบียบการเก็บข้อมูลและเริ่มปรับปรุงกระบวนการประมวลผลการชำระเงินใน Adyen ค้นหาโอกาสเพิ่มประสิทธิภาพและทำความเข้าใจการปฏิบัติการทางการเงินได้ลึกซึ้งยิ่งขึ้น.

กลับไปยังคู่มือการปรับปรุง

ดาวน์โหลดเทมเพลต

เริ่มปรับปรุงกระบวนการชำระเงินใน Adyen ให้ราบรื่นได้วันนี้.

ประมวลผลรายการโดยอัตโนมัติตั้งแต่ต้นจนจบได้ 98% และกำจัดข้อยกเว้นในการชำระเงิน.

เริ่มทดลองใช้ฟรี

ไม่ต้องใช้บัตรเครดิต เริ่มปรับปรุงได้ทันที.

เทมเพลตข้อมูลการประมวลผลการชำระเงินของคุณ

เทมเพลตข้อมูลการประมวลผลการชำระเงินของคุณ

แอตทริบิวต์การประมวลผลการชำระเงิน

กิจกรรมในการประมวลผลการชำระเงิน

คู่มือการดึงข้อมูล

ส่งออกรายงานรายละเอียดการชำระบัญชีของ Adyen

ขั้นตอน

การกำหนดค่า

ตัวอย่างคำค้น python

ดึงข้อมูลด้วย Python ผ่าน Reporting API

ขั้นตอน

การกำหนดค่า

ตัวอย่างคำค้น python

พร้อมเริ่มต้นหรือยัง?

เริ่มปรับปรุงกระบวนการชำระเงินใน Adyen ให้ราบรื่นได้วันนี้.