Ensure Gateway ID validation consistency in ProcessWebhook

Đang mở Phù hợp với người mới
#13 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
go
Lĩnh vực
backend, security

Hướng nghiên cứu

Bắt đầu với payment/service.go, tập trung vào ProcessWebhook và khối giao dịch quanh các dòng 278–323; so sánh các bước kiểm tra gateway của nó với luồng ValidateReference. Chạy các bài kiểm thử thanh toán liên quan và bổ sung kiểm thử cho webhook có ID gateway khác với giao dịch đã lưu. Hoàn thành khi các gateway không khớp không thể thay đổi trạng thái giao dịch và các bài kiểm thử đều đạt.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Issue: Missing Gateway Validation in Webhook Processing

Description

In the payment package, incoming webhook requests are processed via the ProcessWebhook method in payment/service.go. Currently, this method retrieves a transaction using only the parsed reference number from the webhook payload. However, it does not verify that the transaction's stored GatewayID matches the gatewayID parameter provided in the URL route (/api/v1/payments/:gatewayID/webhook).

This omission allows one payment gateway (or any client spoofing that gateway's route) to potentially alter or settle transaction records belonging to another gateway, creating a data integrity risk and security vulnerability.

Similar validation is correctly performed in the ValidateReference flow (used for real-time reference checking).


Impact

  • Cross-Gateway Mutation: A webhook routed to /api/v1/payments/gateway-a/webhook could succeed in marking a transaction as successful even if that transaction was initialized under gateway-b.
  • Security & Auditing: Weakens the separation of duties and trust boundaries between different payment providers.

Code References

  • Target File: service.go
  • Location: Inside the repository transaction block in ProcessWebhook: service.go#L278-L323

Proposed Solution

Add a validation check inside the RunInTransaction block in ProcessWebhook to ensure the gateway identifiers match before modifying the transaction state.

// Inside ProcessWebhook in service.go
err = s.repo.RunInTransaction(ctx, func(repo PaymentRepository) error {
    tx, err := repo.GetByReferenceNumberForUpdate(ctx, gwPayload.ReferenceNumber)
    if err != nil {
        return fmt.Errorf("failed to retrieve transaction by reference: %w", err)
    }
    if tx == nil {
        return fmt.Errorf("reference %s: %w", gwPayload.ReferenceNumber, ErrTransactionNotFound)
    }

    // NEW VALIDATION: Ensure the webhook matches the gateway configured for this transaction
    if tx.GatewayID != gatewayID {
        return fmt.Errorf("gateway mismatch for transaction %s: expected %s, got %s: %w", 
            tx.ReferenceNumber, tx.GatewayID, gatewayID, ErrTransactionNotFound)
    }

    // ... existing status and amount checks ...
})

By returning ErrTransactionNotFound (or a similar error), the HTTP handler will return a 404 Not Found (or 422 Unprocessable Entity), signaling to the gateway to stop retrying the mismatched payload.

Ngôn ngữ chính
Go
Star
6
Fork
8
Merge trung bình
21 giờ 36 phút
Pull request đã merge (30 ngày)
42

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của OpenNSW/core

Tất cả issue của OpenNSW/core

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.