Ensure Gateway ID validation consistency in ProcessWebhook

Aperta Adatta ai principianti
#13 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
72/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
go
Ambito
backend, security

Direzione di ricerca

Inizia da payment/service.go, concentrandoti su ProcessWebhook e sul relativo blocco di transazione intorno alle righe 278–323; confronta i controlli del gateway con il flusso di ValidateReference. Esegui i test di pagamento pertinenti e aggiungi una copertura per un webhook il cui ID gateway differisce da quello della transazione memorizzata. Il lavoro è completato quando i gateway non corrispondenti non possono modificare lo stato della transazione e i test passano.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
Go
Stelle
6
Fork
8
Merge medio
21h 36m
PR unite (30g)
42

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di OpenNSW/core

Tutte le issue di OpenNSW/core

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.