feat(hardlink): unify kiosk payments and finalize legacy cleanup
This commit is contained in:
@@ -0,0 +1,55 @@
|
||||
// Package paymentapi defines the modern Hardlink terminal contract and its HTTP client.
|
||||
// It contains no provider selection, PMS posting or guest-journey logic.
|
||||
package paymentapi
|
||||
|
||||
const (
|
||||
Sale = "sale"
|
||||
Preauth = "preauth"
|
||||
SalePath = "/api/payment/sale"
|
||||
PreauthPath = "/api/payment/preauth"
|
||||
)
|
||||
|
||||
// PreauthRequirement describes a later required hold; validating it never executes it.
|
||||
type PreauthRequirement struct {
|
||||
Amount int64 `json:"amount"`
|
||||
CheckoutDate string `json:"checkoutDate,omitempty"`
|
||||
}
|
||||
|
||||
// Request uses integer minor units and currency supplied by CMS.
|
||||
type Request struct {
|
||||
Reference string `json:"reference,omitempty"`
|
||||
Amount int64 `json:"amount"`
|
||||
Currency string `json:"currency,omitempty"`
|
||||
CheckoutDate string `json:"checkoutDate,omitempty"`
|
||||
RequiredPreauth *PreauthRequirement `json:"requiredPreauth,omitempty"`
|
||||
}
|
||||
|
||||
// Result is authoritative terminal outcome and metadata, never a PMS description.
|
||||
// CurrencyCode is configured bookkeeping currency, not settlement-currency evidence.
|
||||
type Result struct {
|
||||
Outcome string `json:"outcome"`
|
||||
HTTPStatus int `json:"httpStatus"`
|
||||
Reason string `json:"reason,omitempty"`
|
||||
Retryable bool `json:"retryable"`
|
||||
Message string `json:"message,omitempty"`
|
||||
Provider string `json:"provider,omitempty"`
|
||||
AmountMinor int64 `json:"amountMinor"`
|
||||
CurrencyCode string `json:"currencyCode,omitempty"`
|
||||
TransactionReference string `json:"transactionReference,omitempty"`
|
||||
CardType string `json:"cardType,omitempty"`
|
||||
MaskedCardNumber string `json:"maskedCardNumber,omitempty"`
|
||||
ExpiryDate string `json:"expiryDate,omitempty"`
|
||||
CardHash string `json:"cardHash,omitempty"`
|
||||
CardReference string `json:"cardReference,omitempty"`
|
||||
ReceiptNumber string `json:"receiptNumber,omitempty"`
|
||||
SequenceNumber string `json:"sequenceNumber,omitempty"`
|
||||
AuthorizationCode string `json:"authorizationCode,omitempty"`
|
||||
LastFour string `json:"lastFour,omitempty"`
|
||||
}
|
||||
|
||||
// Frame carries observational progress or one final result.
|
||||
type Frame struct {
|
||||
Type string `json:"type"`
|
||||
Code string `json:"code,omitempty"`
|
||||
Result *Result `json:"result,omitempty"`
|
||||
}
|
||||
Reference in New Issue
Block a user