Class ConfirmResponse

Validates and deep-clones the gateway payload. Normalises OrderStatus, ErrorCode, actionCode to string (or undefined).

Captured amount in major units (e.g. DA). Returns undefined when the gateway value is absent, non-satim-module, fractional, or exceeds Number.MAX_SAFE_INTEGER — these cases indicate a malformed response that should not be silently coerced. Callers needing strictness should also call verifyAmount.

Actually-debited amount in major units.

For standard captures, equals getAmount. For partial captures (pre-auth flows), may be less than the original hold.

Same null-vs-malformed semantics as getAmount.

OrderStatus "2": deposited (success).

OrderStatus "4": refunded.

OrderStatus "0": registered but not paid yet.

OrderStatus "3": authorization voided / reversed.

OrderStatus "1": funds held, awaiting capture.

Session timed out (actionCode === "-2007"), only when no terminal OrderStatus is present.

Customer cancelled (actionCode === "10" or message matches "payment is cancelled").

Bank declined (actionCode ∈ {"2003","111"}, or respCode outside {"", "00"}, or message matches "payment is declined").

Catch-all failure predicate — true iff every other predicate is false. Mutual-exclusivity contract enforcement point: any response that does not fit a narrower predicate lands here.

Localised success/info message. Falls back to getErrorMessage for non-success terminal states.

Source order on success: params.respCode_desc, then actionCodeDescription, then a fixed English fallback.

Localised failure message keyed to the active predicate.

For declined payments, the message is the SDK's generic "Your transaction was rejected" rather than the gateway's specific respCode_desc (e.g. "Do not honor"). Callers needing the raw gateway reason should read it from getRawResponse.

Assert captured amount equals expectedAmount. Compares minor-unit integers via the same IEEE-754-safe toMinorUnits pipeline used at registration.

Sole defence against partial-capture manipulation. Satim.confirm() calls this automatically on isSuccessful() responses — bypassing requires constructing ConfirmResponse directly, which also bypasses the gateway call entirely.

Shallow copy of the raw gateway response with cardholder PII redacted.

Redacted fields: Ip, Pan, cardholderName, expiration.

Use for debugging, logging, error reporting. Mutating the returned object does not affect this wrapper. For PII access, call the dedicated getCardPan / getCardHolderName / getCardExpiry / getIpAddress methods.