webhook

type AlertService = alerts.Service

type PaymentLookup interface {
	LookupPayment(ctx context.Context, paymentID string) (*yellowcard.PaymentDetails, error)
}

type RefundPendingFetcher interface {
	// GetRefundPendingDisbursements returns (sequenceID, paymentID) pairs for all
	// disbursements in DisbursementRefundPending status.
	GetRefundPendingDisbursements(ctx context.Context) ([]RefundPendingRecord, error)
}

type RefundPendingRecord struct {
	SequenceID       string  // YC sequenceId / idempotency key
	PaymentID        string  // YC payment ID
	LoanID           string  // Loan ID for tracking
	LoanReference    string  // Human-facing loan reference, for alerts
	UserID           string  // User ID for tracking
	RecipientName    string  // Recipient name for fiat disbursement
	AmountUSD        float64 // Amount in USD
	AmountStroops    int64   // Amount in stroops (USDC * 10^7)
	RampFiatAmount   int64   // Original off-ramp fiat amount in cents (local currency)
	RampFiatCurrency string  // Original off-ramp fiat currency (e.g. "KES")
	DestinationPhone string  // Recipient phone number
	CountryCode      string  // ISO country code
	NetworkCode      string  // MoMo network code
	NetworkName      string  // MoMo network name
}

type RefundPoller struct {
	// contains filtered or unexported fields
}

type RefundPollerConfig struct {
	PollInterval time.Duration // How often to poll (default: 30s)
}

type Service struct {
	// contains filtered or unexported fields
}

type TransactionRecorder interface {
	// UpdateOffRampTransaction syncs a loan's off-ramp row with the provider's
	// reported status. Keyed by loan rather than by external ID, which no longer
	// identifies a single row now that every leg of an anchor transaction shares
	// the provider's request ID.
	UpdateOffRampTransaction(ctx context.Context, loanID string, status string, externalStatus string) error

	// RecordFiatFailover records a fiat failover transaction after a direct settlement refund.
	RecordFiatFailover(ctx context.Context, rec RefundPendingRecord, newRequestID string) error
}

type WebhookEventHandler interface {
	// ProcessYellowCardEvent handles a single webhook event, mapping it to the
	// appropriate disbursement status update and triggering any side effects.
	ProcessYellowCardEvent(ctx context.Context, event yellowcard.WebhookEvent) error
}