119 lines
5.0 KiB
Go
119 lines
5.0 KiB
Go
package handlers
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"net"
|
|
"net/url"
|
|
"strings"
|
|
|
|
"gitea.futuresens.co.uk/futuresens/hardlink/v2/internal/creditcall"
|
|
"gitea.futuresens.co.uk/futuresens/hardlink/v2/internal/types"
|
|
"gitea.futuresens.co.uk/futuresens/hardlink/v2/paymentapi"
|
|
)
|
|
|
|
// creditCallDiagnostic carries allowlisted observations, never financial evidence.
|
|
type creditCallDiagnostic struct {
|
|
reason string
|
|
cause string
|
|
}
|
|
|
|
func (diagnostic creditCallDiagnostic) apply(final *paymentapi.Result) {
|
|
if diagnostic.reason == "" || final.Reason != "" {
|
|
return
|
|
}
|
|
switch final.Outcome {
|
|
case "unknown":
|
|
final.Message = "Payment outcome uncertain: " + diagnostic.cause + "; contact reception"
|
|
case "declined":
|
|
final.Message = "Transaction declined: " + diagnostic.cause
|
|
case "cancelled":
|
|
final.Message = "Transaction cancelled: " + diagnostic.cause
|
|
default:
|
|
return
|
|
}
|
|
final.Reason = diagnostic.reason
|
|
}
|
|
|
|
func creditCallInitialDiagnostic(result creditcall.TransactionResultXML) creditCallDiagnostic {
|
|
transactionResult, sdkError := creditCallDiagnosticFieldsFromEntries(result.Entries)
|
|
switch strings.ToLower(transactionResult) {
|
|
case types.ResultApproved:
|
|
return creditCallDiagnostic{}
|
|
case "timeout":
|
|
return creditCallDiagnostic{reason: "cli_timeout", cause: "CLI wait expired"}
|
|
}
|
|
if recognizedCreditCallSDKError(sdkError) {
|
|
return creditCallDiagnostic{reason: "sdk_" + sdkError, cause: sdkError}
|
|
}
|
|
return creditCallDiagnostic{}
|
|
}
|
|
|
|
func creditCallConfirmationErrorDiagnostic(err error) creditCallDiagnostic {
|
|
var networkError net.Error
|
|
if errors.Is(err, context.DeadlineExceeded) || (errors.As(err, &networkError) && networkError.Timeout()) {
|
|
return creditCallDiagnostic{reason: "confirmation_timeout", cause: "ConfirmTransaction timed out"}
|
|
}
|
|
var requestError *url.Error
|
|
if errors.As(err, &requestError) {
|
|
return creditCallDiagnostic{reason: "confirmation_request_error", cause: "ConfirmTransaction request failed"}
|
|
}
|
|
return creditCallDiagnostic{reason: "confirmation_response_read_error", cause: "ConfirmTransaction response could not be read"}
|
|
}
|
|
|
|
func creditCallConfirmationResultDiagnostic(entries []creditcall.EntryXML, invalidXML bool) creditCallDiagnostic {
|
|
if invalidXML {
|
|
return creditCallDiagnostic{reason: "confirmation_invalid_response", cause: "ConfirmTransaction response is invalid"}
|
|
}
|
|
transactionResult, sdkError := creditCallDiagnosticFieldsFromEntries(entries)
|
|
if recognizedCreditCallSDKError(sdkError) {
|
|
return creditCallDiagnostic{reason: "confirmation_sdk_" + sdkError, cause: "ConfirmTransaction: " + sdkError}
|
|
}
|
|
result := strings.ToLower(transactionResult)
|
|
if result == types.ResultError && strings.HasPrefix(sdkError, "ConfirmTransaction failed:") {
|
|
return creditCallDiagnostic{reason: "confirmation_cli_error", cause: "ConfirmTransaction CLI failed"}
|
|
}
|
|
switch result {
|
|
case "canceled", "cancelled":
|
|
result = "cancelled"
|
|
case types.ResultDeclined, types.ResultError, "timeout":
|
|
default:
|
|
result = "unknown"
|
|
}
|
|
return creditCallDiagnostic{reason: "confirmation_result_" + result, cause: "ConfirmTransaction result " + result}
|
|
}
|
|
|
|
func creditCallDiagnosticFieldsFromEntries(entries []creditcall.EntryXML) (transactionResult, sdkError string) {
|
|
for _, entry := range entries {
|
|
switch entry.Key {
|
|
case types.TransactionResult:
|
|
transactionResult = entry.Value
|
|
case types.Errors:
|
|
sdkError = entry.Value
|
|
}
|
|
}
|
|
return transactionResult, sdkError
|
|
}
|
|
|
|
// recognizedCreditCallSDKError matches exact symbolic names from the bundled
|
|
// ChipDNA SDK 3.17 transaction error types. Descriptions and numeric/compound
|
|
// errors are deliberately excluded; numeric values overlap between SDK types.
|
|
func recognizedCreditCallSDKError(code string) bool {
|
|
switch code {
|
|
case "ChipCardRemoved", "ClientNotConnectedToServer", "NoPinPadsAvailable", "AmountTooLarge", "AmountTooSmall",
|
|
"NoPinPadsConfigured", "PaymentDeviceUnavailable", "PaymentDeviceNotInitialized", "PinpadConnectionClosed",
|
|
"PinPadTransactionTerminated", "EposTransactionTerminated", "TransactionProcessingError", "TransactionInProgress",
|
|
"TransactionAlreadyInProgressError", "TransactionNotStarted", "MissingParameter", "InvalidParameter", "InvalidValue",
|
|
"UnexpectedParameters", "AmountZeroNotAllowed", "AmountInvalid", "AmountMissing",
|
|
"ReferenceAlreadyExistsForApprovedTransaction", "PinPadAmountInvalid", "PinpadAmountTooLarge",
|
|
"TransactionReferenceMissing", "TransactionReferenceEmpty", "TransactionForConfirmVoidNotFound", "TransactionNotFound",
|
|
"TransactionAlreadyConfirmed", "TransactionOriginallyDeclined", "TransactionNotCommitted", "ConfirmRequestFailed",
|
|
"ConfirmAccountVerificationNotAllowed", "ConfirmLinkedRefundNotAllowed", "RemoteServerAccessFailed",
|
|
"ServerCommunicationError", "ServerRequestError", "ServerResponseError", "NoResponseFromServer", "TemporarilyUnavailable",
|
|
"ChipCardBlocked", "ChipReadFailure", "SwipeReadFailure", "ExpiredCard", "BadCard", "CardSchemeNotSupported", "CardUsageExceeded",
|
|
"PinPadUserCancelled", "CardHolderActionTimedOut":
|
|
return true
|
|
}
|
|
return false
|
|
}
|