Adds the system payment method for paying with EnakPoint (docs/prd-point-coin.md F9, §8, §10.5, PC-303). Migration 000094 allows the point type, keeps one per organization with a partial unique index, creates it for every existing organization, and adds a trigger that creates it for new ones, as the walk-in customer is. It adds payments.points_used and point_value. Their CHECK is written so it can never be NULL: the PRD form, (both NULL) OR (both > 0), is NULL for points_used with a NULL point_value, which a CHECK lets through, so a payment could have lost the value a refund depends on. A test caught it. The API cannot create, delete or retype the EnakPoint method, nor turn another method into one; that answers 400. Renaming it is allowed. The method list takes the outlet from ?outlet_id= or the user's outlet and leaves EnakPoint out when that outlet does not accept it, filtered in the query so the count stays right. The organization-wide active list is unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
57 lines
2.6 KiB
Go
57 lines
2.6 KiB
Go
package contract
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/google/uuid"
|
|
)
|
|
|
|
type CreatePaymentMethodRequest struct {
|
|
OrganizationID uuid.UUID `json:"organization_id"`
|
|
OutletID uuid.UUID `json:"outlet_id""'`
|
|
Name string `json:"name" validate:"required,min=1,max=100"`
|
|
Type string `json:"type" validate:"required,oneof=cash card digital_wallet qr edc"`
|
|
Processor *string `json:"processor,omitempty" validate:"omitempty,max=100"`
|
|
Configuration map[string]interface{} `json:"configuration,omitempty"`
|
|
IsActive *bool `json:"is_active,omitempty"`
|
|
}
|
|
|
|
type UpdatePaymentMethodRequest struct {
|
|
Name *string `json:"name,omitempty" validate:"omitempty,min=1,max=100"`
|
|
Type *string `json:"type,omitempty" validate:"omitempty,oneof=cash card digital_wallet qr edc point"`
|
|
Processor *string `json:"processor,omitempty" validate:"omitempty,max=100"`
|
|
Configuration map[string]interface{} `json:"configuration,omitempty"`
|
|
IsActive *bool `json:"is_active,omitempty"`
|
|
}
|
|
|
|
type PaymentMethodResponse struct {
|
|
ID uuid.UUID `json:"id"`
|
|
OrganizationID uuid.UUID `json:"organization_id"`
|
|
Name string `json:"name"`
|
|
Type string `json:"type"`
|
|
Processor *string `json:"processor,omitempty"`
|
|
Configuration map[string]interface{} `json:"configuration,omitempty"`
|
|
IsActive bool `json:"is_active"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
type ListPaymentMethodsRequest struct {
|
|
OrganizationID *uuid.UUID `json:"organization_id,omitempty"`
|
|
// When set, EnakPoint is left out unless the outlet accepts it (F9).
|
|
OutletID *uuid.UUID `json:"outlet_id,omitempty"`
|
|
Type *string `json:"type,omitempty" validate:"omitempty,oneof=cash card digital_wallet qr edc point"`
|
|
IsActive *bool `json:"is_active,omitempty"`
|
|
Search string `json:"search,omitempty"`
|
|
Page int `json:"page" validate:"min=1"`
|
|
Limit int `json:"limit" validate:"min=1,max=100"`
|
|
}
|
|
|
|
type ListPaymentMethodsResponse struct {
|
|
PaymentMethods []PaymentMethodResponse `json:"payment_methods"`
|
|
TotalCount int `json:"total_count"`
|
|
Page int `json:"page"`
|
|
Limit int `json:"limit"`
|
|
TotalPages int `json:"total_pages"`
|
|
}
|