> Cải tiến quy trình liên tục > Quy trình xử lý thanh toán > Adyen > Mẫu dữ liệu

Mẫu dữ liệu xử lý thanh toán của bạn

Adyen

Thuộc tính xử lý thanh toán(19) Hoạt động xử lý thanh toán(16) Hướng dẫn trích xuất dữ liệu(2)

Mẫu dữ liệu xử lý thanh toán của bạn

Mẫu này hướng dẫn bạn thu thập dữ liệu cần thiết để phân tích quy trình xử lý thanh toán trên Adyen. Mẫu liệt kê các thuộc tính dữ liệu và hoạt động quy trình cần theo dõi, kèm hướng dẫn thực tế để trích xuất dữ liệu. Hãy dùng mẫu này để thu thập đủ thông tin quan trọng cho hoạt động process mining hiệu quả.

Các thuộc tính nên thu thập
Các hoạt động chính cần theo dõi
Hướng dẫn trích xuất dữ liệu từ Adyen

Chưa quen với nhật ký sự kiện? Tìm hiểu cách tạo nhật ký sự kiện cho process mining.

Tải mẫu xuống

Thuộc tính xử lý thanh toán

Đây là những trường dữ liệu nên có trong nhật ký sự kiện để phân tích quy trình xử lý thanh toán trên Adyen.

5 Bắt buộc 6 Nên có 8 Không bắt buộc

	Tên	Mô tả
	Payment Transaction ID PspReference	Mã tham chiếu duy nhất do Adyen cấp cho mỗi giao dịch thanh toán.
Mô tả Thuộc tính này là khóa chính cho toàn bộ vòng đời thanh toán trong hệ sinh thái Adyen. Mã này liên kết yêu cầu thanh toán ban đầu với các sự kiện tiếp theo như ủy quyền, thu tiền, quyết toán và các khoản hoàn tiền hoặc yêu cầu bồi hoàn giao dịch có thể phát sinh. Trong quá trình phân tích, mã này được dùng để nhóm các sự kiện riêng lẻ thành một trường hợp, giúp tái dựng quy trình từ đầu đến cuối. Nhờ đó, chuyên viên phân tích có thể theo dõi hành trình cụ thể của một khoản thanh toán, từ lúc người mua bắt đầu giao dịch đến khi hoàn tất quyết toán tài chính. Vì sao điều này quan trọng Đây là liên kết cốt lõi giúp nhóm các sự kiện rời rạc thành một phiên bản quy trình duy nhất để phân tích. Lấy dữ liệu ở đâu Adyen Payment Response, cột 'pspReference', hoặc cột 'PSP Reference' trong Settlement Detail Report. Ví dụ 851564567890123479145612345678908825641234567890
	Tên hoạt động EventCode	Giai đoạn hoặc hành động cụ thể diễn ra trong vòng đời thanh toán.
Mô tả Thuộc tính này xác định sự kiện đã xảy ra, chẳng hạn như AUTHORISATION, CAPTURE hoặc REFUND. Sự kiện này quyết định các nút trên sơ đồ quy trình và luồng giao dịch. Khi phân tích, các mã này được chuyển thành tên hoạt động dễ hiểu để trực quan hóa luồng quy trình. Trình tự mã khác nhau cho thấy các đường đi khác nhau, chẳng hạn như xử lý tự động từ đầu đến cuối hoặc xử lý ngoại lệ. Vì sao điều này quan trọng Xác định phần “việc gì” trong mô hình process mining, giúp trực quan hóa các luồng quy trình. Lấy dữ liệu ở đâu Trường 'eventCode' trong Adyen Notification Webhooks. Ví dụ AUTHORISATIONCAPTUREREFUNDCANCELLATIONCHARGEBACK
	Thời điểm sự kiện EventDate	Ngày và giờ hoạt động thanh toán cụ thể diễn ra.
Mô tả Thuộc tính này ghi lại chính xác thời điểm một sự kiện, chẳng hạn như ủy quyền hoặc quyết toán, được ghi nhận trong hệ thống. Nhờ đó, bạn có thể sắp xếp các hoạt động theo thứ tự thời gian trong một hồ sơ. Khi phân tích, thông tin này rất quan trọng để tính thời gian xử lý, xác định điểm nghẽn và đo lường thông lượng của hệ thống theo thời gian. Thuộc tính này hỗ trợ mọi KPI dựa trên thời gian, chẳng hạn như “Tổng thời gian xử lý thanh toán”. Vì sao điều này quan trọng Cần thiết để sắp xếp sự kiện và tính mọi chỉ số dựa trên thời lượng. Lấy dữ liệu ở đâu Trường 'eventDate' trong Adyen Notification Webhooks. Ví dụ 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	Hệ thống nguồn SourceSystem	Tên hệ thống nơi dữ liệu được tạo ra.
Mô tả Thuộc tính tĩnh này cho biết bản ghi đến từ Adyen. Khi process mining kết hợp nhiều hệ thống, chẳng hạn Adyen và SAP, thông tin này rất quan trọng để truy vết nguồn gốc dữ liệu. Khi phân tích, người dùng có thể lọc các hoạt động diễn ra cụ thể trong cổng thanh toán, thay vì trong ERP hoặc hệ thống quản lý đơn hàng. Vì sao điều này quan trọng Quan trọng để truy vết nguồn gốc dữ liệu khi process mining nhiều hệ thống. Lấy dữ liệu ở đâu Giá trị cố định trong quá trình trích xuất. Ví dụ AdyenAdyen_Production
	Lần cập nhật dữ liệu gần nhất LastDataUpdate	Thời điểm bản ghi được trích xuất hoặc làm mới lần gần nhất.
Mô tả Thuộc tính này cho biết dữ liệu trong mô hình process mining còn mới hay không. Nhờ đó, người dùng biết dữ liệu đang xem là dữ liệu gần thời gian thực hay ảnh chụp tại một thời điểm. Đây chủ yếu là trường kỹ thuật phục vụ quản trị dữ liệu và xác nhận quy trình xử lý dữ liệu đang chạy đúng. Vì sao điều này quan trọng Trường kỹ thuật dùng để theo dõi độ mới của dữ liệu. Lấy dữ liệu ở đâu Thời gian hệ thống tại lúc trích xuất. Ví dụ 2023-10-30T12:00:00Z
	Có xử lý lại IsRework	Cờ cho biết giao dịch có được thử lại hoặc sửa lỗi hay không.
Mô tả Cờ boolean có giá trị true nếu hồ sơ có nhiều lần thử ủy quyền hoặc có hoạt động như “Thanh toán bị từ chối” rồi thử lại. Cờ này là dữ liệu chính cho bảng điều khiển “Các điểm nóng về xử lý lại và ngoại lệ thanh toán”. Nhà phân tích có thể lọc riêng các hồ sơ có vấn đề để tìm hiểu vì sao luồng quy trình không đi theo đường xử lý thông thường. Vì sao điều này quan trọng Xác định các hồ sơ kém hiệu quả cần người dùng hoặc hệ thống can thiệp. Lấy dữ liệu ở đâu Được tính dựa trên số sự kiện thất bại lớn hơn 0. Ví dụ truefalse
	Lý do từ chối RefusalReason	Mô tả lý do khoản thanh toán bị từ chối hoặc thất bại.
Mô tả Khi giao dịch thất bại, Adyen cung cấp mã hoặc mô tả lý do, chẳng hạn như “Không đủ số dư”, “CVC bị từ chối” hoặc “Thẻ hết hạn”. Đây là dữ liệu chính cho bảng điều khiển “Tỷ lệ giao dịch thanh toán thất bại”. Phân tích các lý do này giúp xác định lỗi bắt nguồn từ sự cố kỹ thuật, quy tắc chống gian lận hay hành vi của người mua, từ đó đưa ra biện pháp xử lý phù hợp. Vì sao điều này quan trọng Thuộc tính then chốt để tìm nguyên nhân gốc rễ của các khoản thanh toán thất bại. Lấy dữ liệu ở đâu 'refusalReason' trong phản hồi thanh toán của Adyen. Ví dụ Bị từ chốiKhông đủ số dưThẻ hết hạnLỗi từ ngân hàng thanh toánGian lận
	Phương thức thanh toán PaymentMethod	Phương thức người mua dùng để thanh toán, chẳng hạn như Visa hoặc PayPal.
Mô tả Thuộc tính này ghi nhận loại phương tiện thanh toán được sử dụng, gồm thương hiệu thẻ tín dụng (Visa, MC), ví điện tử (PayPal, Apple Pay) hoặc phương thức thanh toán tại địa phương (iDEAL, Sofort). Thông tin này rất cần thiết cho bảng điều khiển “Thông tin chi tiết về hiệu suất phương thức thanh toán”. Thuộc tính giúp tìm mối liên hệ giữa từng phương thức thanh toán với tỷ lệ ủy quyền, tốc độ xử lý hoặc lỗi kỹ thuật. Vì sao điều này quan trọng Cần thiết để phân tích tỷ lệ thành công và chi phí của các nhà cung cấp dịch vụ thanh toán. Lấy dữ liệu ở đâu 'paymentMethod.brand' hoặc 'paymentMethod.type' trong phản hồi thanh toán của Adyen. Ví dụ visamcpaypalidealklarna
	Số tiền giao dịch PaymentAmount	Giá trị tiền tệ của giao dịch thanh toán.
Mô tả Thuộc tính này thể hiện giá trị tài chính của giao dịch. Trong dữ liệu thô, giá trị thường được lưu theo đơn vị nhỏ nhất, chẳng hạn như xu, nhưng cần được chuyển đổi khi lập báo cáo. Thông tin này hỗ trợ bảng điều khiển “Thông lượng thanh toán” và giúp ưu tiên xử lý lại các hồ sơ có giá trị cao. Thuộc tính cũng được dùng để tính tổng giá trị đã xử lý và tác động tài chính của các giao dịch thất bại. Vì sao điều này quan trọng Cần thiết để phân tích tác động tài chính và theo dõi thông lượng. Lấy dữ liệu ở đâu 'amount.value' trong yêu cầu thanh toán của Adyen. Ví dụ 10005509900
	Tài khoản đơn vị chấp nhận thanh toán MerchantAccount	Tài khoản đơn vị chấp nhận thanh toán cụ thể trong Adyen xử lý giao dịch.
Mô tả Adyen cho phép một tài khoản công ty có nhiều tài khoản đơn vị chấp nhận thanh toán. Thuộc tính này cho biết đơn vị kinh doanh, thương hiệu hoặc pháp nhân theo khu vực nào đã xử lý khoản thanh toán. Khi phân tích, đây là chiều dữ liệu chính để phân nhóm. Các bên liên quan có thể so sánh hiệu suất, tỷ lệ lỗi và số lượng giao dịch giữa các đơn vị kinh doanh hoặc thương hiệu, từ đó xác định nơi cần cải thiện. Vì sao điều này quan trọng Giúp phân tích hiệu suất theo đơn vị kinh doanh hoặc công ty con. Lấy dữ liệu ở đâu 'merchantAccount' trong yêu cầu/phản hồi thanh toán của Adyen. Ví dụ MyStore_UKMyStore_USGlobalSales_Main
	Trạng thái thanh toán PaymentStatus	Trạng thái hiện tại của khoản thanh toán, chẳng hạn như đã ủy quyền, đã quyết toán hoặc bị từ chối.
Mô tả Thuộc tính này thể hiện trạng thái mới nhất đã biết của giao dịch thanh toán. Trạng thái thường được xác định từ hoạt động gần nhất trong hồ sơ. Người dùng có thể nhanh chóng lọc hồ sơ, chẳng hạn như “Hiển thị tất cả khoản thanh toán hiện đang bị từ chối”. Thuộc tính này rất cần thiết cho bảng điều khiển “Theo dõi thông lượng và trạng thái thanh toán”. Vì sao điều này quan trọng Cho biết nhanh tình trạng hiện tại của giao dịch. Lấy dữ liệu ở đâu Được xác định từ mã sự kiện cuối cùng trong hồ sơ. Ví dụ Đã quyết toánBị từ chốiĐã ủy quyền
	Điểm rủi ro gian lận RiskScore	Điểm rủi ro mà hệ thống phát hiện gian lận gán cho giao dịch.
Mô tả Công cụ RevenueProtect của Adyen gán điểm từ 0 đến 100 để thể hiện khả năng giao dịch có gian lận. Điểm càng cao thường dẫn đến việc kiểm tra thủ công hoặc tự động chặn giao dịch. Thông tin này hỗ trợ “Tổng quan rủi ro tuân thủ tài chính”. Đối chiếu điểm rủi ro cao với các khoản chargeback giúp điều chỉnh quy tắc chống gian lận. Nếu giao dịch có điểm cao nhưng vẫn thành công, mô hình rủi ro có thể đang đánh dấu nhầm. Vì sao điều này quan trọng Cần thiết để phân tích hiệu quả của quy tắc ngăn chặn gian lận. Lấy dữ liệu ở đâu Phản hồi Adyen Risk API hoặc trường 'fraudResult.accountScore' trong báo cáo. Ví dụ 025100
	ID khách hàng ShopperReference	Mã tham chiếu duy nhất dùng để nhận diện người mua qua nhiều giao dịch.
Mô tả Mã định danh này liên kết các giao dịch khác nhau với cùng một khách hàng. Đơn vị bán hàng cung cấp mã này trong yêu cầu thanh toán. Thông tin này cho phép phân tích theo khách hàng, giúp phát hiện người thường xuyên gian lận hoặc khách hàng trung thành trong các giao dịch thành công. Thuộc tính cũng hỗ trợ ánh xạ chung “Khách hàng”. Vì sao điều này quan trọng Cho phép tổng hợp và phân tích hành vi ở cấp khách hàng. Lấy dữ liệu ở đâu 'shopperReference' trong yêu cầu thanh toán của Adyen. Ví dụ CUST-001user_12345email@example.com
	Loại tương tác của người mua ShopperInteraction	Cho biết khoản thanh toán được thực hiện qua thương mại điện tử, POS hay hình thức đăng ký định kỳ (ContAuth).
Mô tả Thuộc tính này phân loại hình thức tương tác giữa người mua và đơn vị bán hàng. Các giá trị thường gặp là `Ecommerce` (trực tuyến), `POS` (tại cửa hàng) hoặc `ContAuth` (thanh toán định kỳ/đăng ký). Thông tin này giúp phân biệt các mô hình kinh doanh và kênh bán hàng. Luồng quy trình tại POS thường khác đáng kể so với thương mại điện tử, vì vậy đây là bộ lọc quan trọng để khám phá quy trình chính xác. Vì sao điều này quan trọng Phân biệt luồng thanh toán trực tuyến, tại cửa hàng và định kỳ. Lấy dữ liệu ở đâu 'shopperInteraction' trong yêu cầu thanh toán của Adyen. Ví dụ Thương mại điện tửContAuthPOSMoto
	Mã tham chiếu ngân hàng thanh toán AcquirerReference	Mã tham chiếu do ngân hàng thanh toán cung cấp.
Mô tả Đây là mã tham chiếu bên ngoài do tổ chức tài chính xử lý giao dịch thẻ, tức ngân hàng thanh toán, cấp. Mã này khác với mã tham chiếu PSP của Adyen. Trường này rất quan trọng trong “Phân tích độ trễ đối soát thanh toán”. Đây là khóa dùng để đối chiếu bản ghi Adyen với sao kê ngân hàng trong sổ cái bên ngoài. Vì sao điều này quan trọng Cần thiết để đối chiếu ba bên và đối soát với dữ liệu bên ngoài. Lấy dữ liệu ở đâu 'additionalData.acquirerReference' trong phản hồi thanh toán của Adyen. Ví dụ 1234567890987654321
	Mã ủy quyền AuthorisationCode	Mã ủy quyền do ngân hàng phát hành trả về khi chấp thuận giao dịch.
Mô tả Mã cho biết tiền đã được giữ trên thẻ của người mua. Đây là bằng chứng giao dịch được ủy quyền thành công. Thuộc tính này chủ yếu phục vụ kiểm toán và truy vết. Nó xác nhận hoạt động “Thanh toán đã được ủy quyền” là hợp lệ. Vì sao điều này quan trọng Bằng chứng ủy quyền thành công phục vụ kiểm toán. Lấy dữ liệu ở đâu 'authCode' trong phản hồi thanh toán của Adyen. Ví dụ 123456098712
	Quốc gia của người mua ShopperCountry	Mã quốc gia gồm hai chữ cái của người mua.
Mô tả Thuộc tính này cho biết vị trí của người mua, thường được xác định từ quốc gia phát hành thẻ hoặc địa chỉ thanh toán. Khi phân tích, thuộc tính này dùng để đánh giá hiệu suất theo khu vực. Bạn có thể xác định quốc gia nào có tỷ lệ từ chối cao hơn hoặc thời gian xử lý lâu hơn do hạ tầng ngân hàng tại địa phương. Vì sao điều này quan trọng Cho phép phân nhóm hiệu suất thanh toán theo khu vực địa lý. Lấy dữ liệu ở đâu 'countryCode' hoặc 'billingAddress.country' trong yêu cầu thanh toán của Adyen. Ví dụ NLUSDE
	Số lô quyết toán BatchNumber	Số lô gắn với đợt quyết toán tiền.
Mô tả Adyen gom các khoản thanh toán đã quyết toán thành từng lô để chi trả. Thuộc tính này cho biết một giao dịch cụ thể thuộc lô nào. Khi phân tích, thuộc tính này dùng để nhóm khoản thanh toán theo chu kỳ chi trả. Nhờ đó, bạn có thể kiểm tra lô nào bị chậm và theo dõi hoạt động “Thanh toán đã quyết toán”. Vì sao điều này quan trọng Liên kết từng giao dịch với các đợt quyết toán tài chính theo lô. Lấy dữ liệu ở đâu 'Batch Number' trong báo cáo chi tiết quyết toán của Adyen. Ví dụ 100255
	Tiền tệ PaymentCurrency	Mã ISO gồm ba chữ cái cho biết loại tiền tệ của giao dịch.
Mô tả Thuộc tính này xác định loại tiền tệ dùng cho `PaymentAmount`. Các giá trị thường gặp gồm EUR, USD, GBP, v.v. Khi phân tích, thuộc tính này giúp nhóm giao dịch theo thị trường và chuẩn hóa giá trị tài chính khi tổng hợp dữ liệu từ nhiều khu vực. Vì sao điều này quan trọng Cho biết đơn vị tiền tệ của trường số tiền trong báo cáo đa tiền tệ. Lấy dữ liệu ở đâu 'amount.currency' trong yêu cầu thanh toán của Adyen. Ví dụ EURUSDGBP

Bắt buộc Nên có Không bắt buộc

Hoạt động xử lý thanh toán

Đây là các bước và mốc chính cần ghi lại trong nhật ký sự kiện để khám phá chính xác quy trình xử lý thanh toán trên Adyen.

5 Nên có 11 Không bắt buộc

	Hoạt động	Mô tả
	Đã quyết toán thanh toán	Tiền đã được bù trừ thành công và ghi có vào tài khoản Adyen của đơn vị bán hàng. Thông tin này xuất hiện trong Settlement Detail Report.
Vì sao điều này quan trọng Đây là bước kết thúc về mặt tài chính của quy trình thành công. Sự kiện này cần thiết để tính 'Overall Payment Cycle Time' và phân tích 'Payment Reconciliation Delay Analysis'. Lấy dữ liệu ở đâu Adyen Settlement Detail Report (SDR), loại bản ghi 'Settled'. Thu thập Ghi nhận khi giao dịch xuất hiện trong Settlement Report Loại sự kiện explicit
	Đã thu tiền thanh toán	Lệnh chuyển tiền từ người mua sang đơn vị bán hàng đã được xử lý thành công. Việc này có thể diễn ra ngay lập tức (tự động thu tiền) hoặc sau đó (thu tiền thủ công).
Vì sao điều này quan trọng Xác nhận doanh thu được ghi nhận. Khoảng thời gian từ lúc ủy quyền đến khi thu tiền là yếu tố quan trọng của KPI 'Payment Authorization Lead Time'. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'CAPTURE' với success='true'. Thu thập Ghi nhận khi webhook CAPTURE báo thành công Loại sự kiện explicit
	Nhận yêu cầu thanh toán	Nền tảng thanh toán Adyen nhận yêu cầu giao dịch lần đầu. Sự kiện này được ghi nhận từ dấu thời gian của yêu cầu API ban đầu hoặc thời điểm tạo pspReference.
Vì sao điều này quan trọng Đánh dấu thời điểm bắt đầu chính xác của một phiên bản quy trình. Đây là mốc cần thiết để tính tổng thời gian xử lý từ đầu đến cuối. Lấy dữ liệu ở đâu Nhật ký Adyen Payment API hoặc dấu thời gian gắn với thời điểm tạo pspReference. Thu thập Ghi nhận khi pspReference được tạo qua API Loại sự kiện explicit
	Thanh toán bị từ chối	Ngân hàng phát hành hoặc quy tắc quản lý rủi ro của Adyen đã từ chối giao dịch. Sự kiện được ghi nhận qua webhook ủy quyền với trạng thái thất bại.
Vì sao điều này quan trọng Tác động trực tiếp đến KPI 'Payment Transaction Failure Rate'. Phân tích lý do từ chối giúp tối ưu tỷ lệ ủy quyền thành công. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'AUTHORISATION' với success='false'. Thu thập Ghi nhận khi webhook AUTHORISATION báo thất bại Loại sự kiện explicit
	Thanh toán được chấp thuận	Ngân hàng phát hành thẻ hoặc phương thức thanh toán đã chấp thuận giao dịch và giữ lại khoản tiền. Sự kiện được ghi nhận qua webhook thông báo tiêu chuẩn của Adyen.
Vì sao điều này quan trọng Đây là mốc quan trọng xác nhận giao dịch hợp lệ và có tiền. Đây cũng là điều kiện cần để thu tiền. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'AUTHORISATION' với success='true'. Thu thập Ghi nhận khi webhook AUTHORISATION báo thành công Loại sự kiện explicit
	Bắt đầu hoàn tiền	Yêu cầu hoàn tiền cho người mua đã được gửi. Đây là bước khởi đầu của luồng xử lý ngược.
Vì sao điều này quan trọng Cho thấy có ngoại lệ sau quyết toán. Tỷ lệ hoàn tiền cao có thể là dấu hiệu của vấn đề về chất lượng ở các bước trước. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'REFUND'. Thu thập Ghi nhận khi webhook REFUND được kích hoạt Loại sự kiện explicit
	Đã đảo ngược yêu cầu bồi hoàn giao dịch	Tranh chấp được giải quyết có lợi cho đơn vị bán hàng và tiền được hoàn lại. Đây là kết quả xử lý ngoại lệ thành công.
Vì sao điều này quan trọng Kết quả tích cực cho việc quản lý rủi ro, giúp bù đắp tác động tài chính của yêu cầu bồi hoàn ban đầu. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'CHARGEBACK_REVERSED'. Thu thập Ghi nhận khi webhook CHARGEBACK_REVERSED được gửi Loại sự kiện explicit
	Đã ghi nhận lỗi kỹ thuật	Đã xảy ra lỗi hệ thống trong quá trình xử lý, chẳng hạn như webhook thất bại hoặc API hết thời gian chờ. Có thể nhận biết lỗi qua các mã lỗi cụ thể trong giao diện.
Vì sao điều này quan trọng Hỗ trợ trực tiếp việc phân tích 'Payment Transaction Failure Rate' bằng cách phân loại lỗi kỹ thuật và lỗi tài chính. Lấy dữ liệu ở đâu Nhật ký Adyen Interface hoặc phản hồi lỗi cụ thể từ các lệnh gọi API. Thu thập Ghi nhận khi mã phản hồi lỗi 5xx hoặc 4xx được trả về Loại sự kiện explicit
	Đã gửi thanh toán đi quyết toán	Adyen đã chuyển giao dịch đến ngân hàng thanh toán hoặc mạng lưới thanh toán để xử lý tài chính. Trạng thái chuyển thành SentForSettlement.
Vì sao điều này quan trọng Đánh dấu thời điểm chuyển từ xử lý vận hành sang bù trừ tài chính. Chậm trễ ở bước này ảnh hưởng đến dòng tiền. Lấy dữ liệu ở đâu Adyen Transaction Status API hoặc thông tin suy ra từ nhật ký lịch sử thay đổi trạng thái. Thu thập Đối chiếu thay đổi của trường trạng thái sang SentForSettlement Loại sự kiện inferred
	Đã phản hồi yêu cầu bồi hoàn giao dịch	Bằng chứng đã được gửi đến Adyen để phản đối yêu cầu bồi hoàn giao dịch. Đây là hoạt động xử lý lại hoặc thao tác thủ công trong luồng tranh chấp.
Vì sao điều này quan trọng Theo dõi công sức dành cho việc bảo vệ doanh thu. Chỉ số này quan trọng đối với 'Payment Rework Rate'. Lấy dữ liệu ở đâu Adyen Disputes API hoặc nhật ký Case Management cho thấy bằng chứng đã được gửi. Thu thập Suy ra từ thay đổi trạng thái thành 'Defense Supplied' Loại sự kiện inferred
	Đã quyết toán khoản hoàn tiền	Khoản hoàn tiền đã được xử lý về mặt tài chính và ghi nợ vào tài khoản của đơn vị bán hàng. Settlement Detail Report xác nhận giao dịch này.
Vì sao điều này quan trọng Hoàn tất quy trình hoàn tiền. Sự kiện này quan trọng khi tính 'Average Error Resolution Time' nếu khoản hoàn tiền phát sinh do lỗi. Lấy dữ liệu ở đâu Adyen Settlement Detail Report, loại bản ghi 'Refunded' hoặc 'RefundedReversed'. Thu thập Ghi nhận khi khoản hoàn tiền xuất hiện trong Settlement Report Loại sự kiện explicit
	Hủy thanh toán	Ủy quyền đã bị hủy trước khi thu tiền. Thao tác này giải phóng khoản tiền đang được giữ trên thẻ của người mua.
Vì sao điều này quan trọng Đây là vòng lặp trong quy trình, khi một đơn hàng hợp lệ bị dừng trước khi hoàn tất, thường do khách hàng yêu cầu hoặc hết thời gian chờ hàng tồn kho. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'CANCELLATION'. Thu thập Ghi nhận khi webhook CANCELLATION được gửi Loại sự kiện explicit
	Nhận thông báo yêu cầu bồi hoàn giao dịch	Adyen đã nhận được thông báo tranh chấp từ tổ chức thẻ. Thông báo này kích hoạt quy trình xử lý tranh chấp.
Vì sao điều này quan trọng Đây là chỉ báo quan trọng về tuân thủ và rủi ro. Sự kiện này ảnh hưởng đến 'Compliance Incident Rate' và cần được xử lý thủ công ngay. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'CHARGEBACK' hoặc 'NOTIFICATION_OF_CHARGEBACK'. Thu thập Ghi nhận khi webhook CHARGEBACK được gửi Loại sự kiện explicit
	Thu tiền thất bại	Lần thu khoản tiền đã được ủy quyền không thành công, thường do hết thời gian chờ kỹ thuật hoặc trạng thái thẻ thay đổi giữa lúc ủy quyền và thu tiền.
Vì sao điều này quan trọng Đây là điểm lỗi nghiêm trọng, cần xử lý lại hoặc thử lại. Sự kiện này góp phần làm tăng 'Payment Exception Rate'. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'CAPTURE_FAILED'. Thu thập Ghi nhận khi webhook CAPTURE_FAILED được gửi Loại sự kiện explicit
	Thực hiện sàng lọc rủi ro	Công cụ RevenueProtect của Adyen phân tích giao dịch để tìm dấu hiệu gian lận. Có thể suy ra sự kiện này khi phản hồi ủy quyền có điểm gian lận hoặc kết quả đánh giá rủi ro.
Vì sao điều này quan trọng Điểm rủi ro cao có thể dẫn đến việc kiểm tra thủ công hoặc tự động từ chối giao dịch, tạo điểm nghẽn hoặc khiến quy trình kết thúc. Lấy dữ liệu ở đâu Phản hồi Adyen Payment (trường fraudResult) hoặc nhật ký Case Management. Thu thập Suy ra khi có đối tượng fraudResult Loại sự kiện inferred
	Xác nhận đã chi trả	Tiền từ một lô giao dịch đã quyết toán được chuyển vào tài khoản ngân hàng của đơn vị bán hàng.
Vì sao điều này quan trọng Đây là khoản tiền thực tế được chuyển cho doanh nghiệp, liên quan đến 'Payment Reconciliation Cycle Time'. Lấy dữ liệu ở đâu Adyen Notification Webhook: eventCode 'PAYOUT_THIRD_PARTY' hoặc thông tin suy ra từ Payout Report. Thu thập Ghép batch ID trong Payout Report với Transaction ID Loại sự kiện inferred

Nên có Không bắt buộc

Hướng dẫn trích xuất dữ liệu

Cách lấy dữ liệu từ Adyen

Các bước

Đăng nhập Adyen Customer Area bằng tài khoản người dùng có vai trò Merchant Report.
Mở Reports rồi chọn Settlement details trong menu.
Tìm phần cài đặt Automatic generation hoặc chọn Generate report để xuất báo cáo một lần.
Trong bảng cấu hình, đặt Format thành CSV (các giá trị phân tách bằng dấu phẩy).
Trong mục Include columns, chọn All hoặc đánh dấu cụ thể các cột: 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 và Interchange.
QUAN TRỌNG: Đảm bảo phạm vi báo cáo bao gồm tất cả Journal Types (Settled, Refunded, Chargeback, PaidOut, v.v.) để ghi nhận toàn bộ vòng đời tài chính.
Tạo báo cáo cho khoảng thời gian mong muốn (ví dụ: 90 ngày gần nhất). Lưu ý, báo cáo quyết toán được tạo theo ngày của lô quyết toán, không phải ngày giao dịch.
Tải tệp CSV đã tạo về môi trường trích xuất dữ liệu của bạn.
Chạy tập lệnh chuyển đổi (được cung cấp bên dưới) để chuyển sổ cái CSV dạng 'Wide' sang định dạng nhật ký sự kiện dạng 'Long' mà ProcessMind yêu cầu.
Tập lệnh thực hiện các chuyển đổi quan trọng: dùng Creation Date để tạo sự kiện 'Payment Request Received' và ánh xạ cột Type sang các hoạt động tài chính cụ thể.
Kiểm tra để đảm bảo tệp CSV đầu ra có các tiêu đề: PspReference, EventCode, EventDate, SourceSystem.
Tải tệp CSV đã chuyển đổi lên ProcessMind.

Cấu hình

Loại báo cáo: Settlement Detail Report (sổ giao dịch tài chính)
Định dạng tệp: CSV (phân tách bằng dấu phẩy theo chuẩn)
Mức độ chi tiết: Cấp giao dịch, mỗi dòng là một bút toán tài chính
Múi giờ: UTC (nên dùng để đồng bộ dữ liệu trích xuất với các hệ thống khác)
Khoảng ngày: Dựa trên các đợt thanh toán (ngày đóng đợt), không phải ngày tạo giao dịch. Nếu chạy trích xuất định kỳ, hãy đảm bảo các khoảng thời gian có phần giao nhau.
Cột bắt buộc: Psp Reference (khóa), Loại (hoạt động), Creation Date, Booking Date (dấu thời gian sự kiện), Merchant Account.
Cài đặt bộ lọc: Đảm bảo không có bộ lọc nào loại các loại 'Chargeback' hoặc 'Refund', để dữ liệu quy trình được đầy đủ.

Truy vấn mẫu 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}')

Các bước

Cấu hình trước khi bắt đầu: Đảm bảo bạn có người dùng Adyen Report với vai trò Merchant Report. Lấy API Key trong Customer Area, tại Developers > API Credentials.
Xác định báo cáo cần dùng: Quá trình trích xuất này cần hai báo cáo CSV do Adyen tạo: Settlement Detail Report (ghi nhận sự kiện tài chính như quyết toán, Chargeback, hoàn tiền) và Received Payment Detail Report (ghi nhận sự kiện vận hành như yêu cầu, từ chối, xác thực).
Thiết lập môi trường Python: Dùng pip để cài các thư viện cần thiết: pandas, requests và numpy. Các thư viện này dùng để kết nối API và chuyển đổi dữ liệu.
Thiết lập kết nối API: Cấu hình tập lệnh Python (được cung cấp bên dưới) để xác thực với endpoint https://management-test.adyen.com hoặc https://management-live.adyen.com. Dùng Report API để liệt kê các báo cáo có sẵn trong khoảng thời gian cụ thể và tải xuống từ các URL tương ứng.
Nạp dữ liệu: Tập lệnh đọc dữ liệu CSV thô vào pandas DataFrame. Báo cáo Adyen thường có dạng 'wide' (mỗi giao dịch một dòng, kèm nhiều cột trạng thái), nên cần chuyển đổi dữ liệu.
Ánh xạ hoạt động, vận hành: Xử lý Received Payment Detail Report. Ánh xạ CreationDate thành Payment Request Received. Kiểm tra cột Status (ví dụ: Authorised, Refused, Error) để tạo các sự kiện Payment Authorised, Payment Refused hoặc Technical Error Logged.
Ánh xạ hoạt động, tài chính: Xử lý Settlement Detail Report. Báo cáo này có cột JournalType. Ánh xạ các giá trị như Settled thành Payment Settled, Refunded thành **Refund InitiatedvàChargeback` thành Chargeback Notification Received.
Suy ra các hoạt động phức tạp:
- Risk Screening Performed: Kiểm tra xem cột FraudScore có giá trị lớn hơn -1 hay không.
- Payout Confirmed: Liên kết giao dịch với mục chi trả trong báo cáo quyết toán bằng BatchNumber.
- Chargeback Defended: Tìm các loại bút toán SecondChargeback hoặc Defense.
Chuyển đổi dữ liệu: Dùng thao tác 'melt' hoặc 'stack' trong pandas để chuyển tập dữ liệu dạng wide thành nhật ký sự kiện dạng long, trong đó mỗi hoạt động nằm trên một dòng riêng.
Chuẩn hóa thuộc tính: Đổi tên cột theo lược đồ đích: PspReference, EventCode, EventDate, SourceSystem (đặt cố định là 'Adyen') và PaymentAmount. Đảm bảo ngày tháng được phân tích theo định dạng ISO 8601.
Lọc dữ liệu: Dùng bộ lọc Type để loại bỏ các dòng đối soát nội bộ không phải là bước trong quy trình (ví dụ: dòng tiêu đề hoặc số dư chuyển tiếp).
Xuất dữ liệu cuối cùng: Tập lệnh xuất DataFrame đã xử lý thành tệp CSV tên adyen_event_log.csv, sẵn sàng tải lên ProcessMind.

Cấu hình

Môi trường API: Chọn endpoint Adyen Test (management-test.adyen.com) hoặc Live (management-live.adyen.com) tùy theo giai đoạn triển khai.
Xác thực: Dùng x-api-key trong header. Không dùng Basic Auth cho Management API.
Loại báo cáo:
- settlement_detail_report: Cần thiết để ghi nhận các sự kiện trong vòng đời tài chính.
- received_payment_detail_report: Cần thiết để xử lý yêu cầu ban đầu và logic xác thực.
Khoảng thời gian: Adyen tạo báo cáo dựa trên thời điểm đóng lô. Hãy yêu cầu báo cáo bao phủ ngày CreationDate cần lấy và thêm 7 ngày để ghi nhận các khoản quyết toán đến muộn.
Phạm vi tài khoản người bán: Nếu có nhiều tài khoản người bán, hãy lặp qua danh sách tài khoản hoặc dùng báo cáo cấp Company Account nếu có.
Cấu hình pandas: Nếu số giao dịch vượt quá 100k dòng, hãy đặt low_memory=False khi đọc CSV để tránh lỗi suy luận kiểu dữ liệu.

Truy vấn mẫu 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.')

Sẵn sàng bắt đầu?

Dùng mẫu này để đơn giản hóa việc thu thập dữ liệu và bắt đầu tối ưu hóa quy trình xử lý thanh toán trên Adyen. Tìm cơ hội nâng cao hiệu quả và hiểu rõ hơn về hoạt động tài chính của bạn.

Quay lại hướng dẫn cải tiến

Tải mẫu xuống

Bắt đầu cải thiện quy trình xử lý thanh toán trên Adyen ngay hôm nay.

Đạt tỷ lệ xử lý tự động xuyên suốt 98% và loại bỏ các trường hợp thanh toán ngoại lệ.

Bắt đầu dùng thử miễn phí

Không cần thẻ tín dụng. Bắt đầu tối ưu hóa ngay.

Mẫu dữ liệu xử lý thanh toán của bạn

Mẫu dữ liệu xử lý thanh toán của bạn

Thuộc tính xử lý thanh toán

Hoạt động xử lý thanh toán

Hướng dẫn trích xuất dữ liệu

Xuất báo cáo chi tiết quyết toán Adyen

Các bước

Cấu hình

Truy vấn mẫu python

Trích xuất bằng Python qua Reporting API

Các bước

Cấu hình

Truy vấn mẫu python

Sẵn sàng bắt đầu?

Bắt đầu cải thiện quy trình xử lý thanh toán trên Adyen ngay hôm nay.