rimpay

type BPayPaymentRequest struct {
	PhoneNumber *phone.Phone           `json:"phone_number"`
	Amount      money.Money            `json:"amount"`
	Description string                 `json:"description"`
	Reference   string                 `json:"reference"`
	Passcode    string                 `json:"passcode"` // B-PAY specific: user passcode
	Metadata    map[string]interface{} `json:"metadata,omitempty"`
}

type BPayProvider interface {
	// Name returns the provider name
	Name() string

	// IsAvailable checks if the provider is available
	IsAvailable(ctx context.Context) bool

	// ProcessBPayPayment processes a B-PAY payment
	ProcessBPayPayment(ctx context.Context, request *BPayPaymentRequest) (*PaymentResponse, error)

	// GetPaymentStatus gets payment status
	GetPaymentStatus(ctx context.Context, transactionID string) (*TransactionStatus, error)

	// ValidateConfig validates provider configuration
	ValidateConfig() error
}

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

type Config struct {
	Environment     Environment               `json:"environment"`
	DefaultProvider string                    `json:"default_provider"`
	Providers       map[string]ProviderConfig `json:"providers"`
	HTTP            HTTPConfig                `json:"http"`
	Logging         LoggingConfig             `json:"logging"`
	Security        SecurityConfig            `json:"security"`
}

type Environment string

type ErrorCode = types.ErrorCode

type HTTPClient interface {
	Do(req *HTTPRequest) (*HTTPResponse, error)
}

type HTTPConfig struct {
	Timeout         time.Duration `json:"timeout"`
	MaxIdleConns    int           `json:"max_idle_conns"`
	MaxConnsPerHost int           `json:"max_conns_per_host"`
	UserAgent       string        `json:"user_agent"`
}

type HTTPRequest struct {
	Method  string
	URL     string
	Headers map[string]string
	Body    []byte
	Timeout time.Duration
}

type HTTPResponse struct {
	StatusCode int
	Headers    map[string]string
	Body       []byte
}

type Language = types.Language

type Logger interface {
	Debug(msg string, fields ...interface{})
	Info(msg string, fields ...interface{})
	Warn(msg string, fields ...interface{})
	Error(msg string, fields ...interface{})
}

type LoggingConfig struct {
	Level  string `json:"level"`
	Format string `json:"format"`
	Output string `json:"output"`
}

type MasrviNotificationData struct {
	TransactionID string                 `json:"transaction_id"`
	Status        string                 `json:"status"`
	Reference     string                 `json:"reference"`
	Amount        money.Money            `json:"amount"`
	PhoneNumber   string                 `json:"phone_number"`
	Timestamp     string                 `json:"timestamp"`
	Data          map[string]interface{} `json:"data,omitempty"`
}

type MasrviPaymentRequest struct {
	PhoneNumber *phone.Phone           `json:"phone_number"`
	Amount      money.Money            `json:"amount"`
	Description string                 `json:"description"`
	Reference   string                 `json:"reference"`
	CallbackURL string                 `json:"callback_url"` // MASRVI specific: webhook URL
	ReturnURL   string                 `json:"return_url"`   // MASRVI specific: return URL after payment
	Metadata    map[string]interface{} `json:"metadata,omitempty"`
}

type MasrviProvider interface {
	// Name returns the provider name
	Name() string

	// IsAvailable checks if the provider is available
	IsAvailable(ctx context.Context) bool

	// ProcessPayment processes a MASRVI payment
	ProcessMasrviPayment(ctx context.Context, request *MasrviPaymentRequest) (*PaymentResponse, error)

	// GetPaymentStatus gets payment status (note: MASRVI uses webhooks)
	GetPaymentStatus(ctx context.Context, transactionID string) (*TransactionStatus, error)

	// HandleNotification handles MASRVI webhook notifications
	HandleNotification(notification *MasrviNotificationData) (*TransactionStatus, error)

	// ValidateConfig validates provider configuration
	ValidateConfig() error
}

type PaymentError = types.PaymentError

type PaymentProvider interface {
	// Name returns the provider name
	Name() string

	// IsAvailable checks if the provider is available
	IsAvailable(ctx context.Context) bool

	// ProcessPayment processes a payment
	ProcessPayment(ctx context.Context, request *PaymentRequest) (*PaymentResponse, error)

	// GetPaymentStatus gets payment status
	GetPaymentStatus(ctx context.Context, transactionID string) (*TransactionStatus, error)

	// ValidateConfig validates provider configuration
	ValidateConfig() error
}

type PaymentRequest = types.PaymentRequest

type PaymentResponse = types.PaymentResponse

type PaymentStatus = types.PaymentStatus

type ProviderConfig struct {
	Enabled     bool                   `json:"enabled"`
	BaseURL     string                 `json:"base_url"`
	Credentials map[string]string      `json:"credentials"`
	Timeout     time.Duration          `json:"timeout"`
	Options     map[string]interface{} `json:"options"`
}

type ProviderFactory func(config ProviderConfig, logger Logger) (PaymentProvider, error)

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

type SecurityConfig struct {
	EncryptionKey string        `json:"encryption_key"`
	SigningKey    string        `json:"signing_key"`
	TokenTTL      time.Duration `json:"token_ttl"`
}

type StatusEvent struct {
	Status    PaymentStatus          `json:"status"`
	Timestamp time.Time              `json:"timestamp"`
	Message   string                 `json:"message,omitempty"`
	Metadata  map[string]interface{} `json:"metadata,omitempty"`
}

type TransactionStatus struct {
	TransactionID     string                 `json:"transaction_id"`
	Status            PaymentStatus          `json:"status"`
	Amount            money.Money            `json:"amount,omitempty"`
	Reference         string                 `json:"reference"`
	ProviderReference string                 `json:"provider_reference,omitempty"`
	Message           string                 `json:"message,omitempty"`
	LastUpdated       time.Time              `json:"last_updated"`
	Events            []StatusEvent          `json:"events,omitempty"`
	ProviderData      map[string]interface{} `json:"provider_data,omitempty"`
}

type Validator interface {
	ValidatePaymentRequest(request *PaymentRequest) error
	ValidateAmount(amount money.Money) error
	ValidatePhoneNumber(phone string) error
}