APA POS SDK/com.abrantix.apa.sdk/TransactionRequest/CashAdvanceBuilder

CashAdvanceBuilder

class CashAdvanceBuilder : TransactionRequest.AbstractBuilder<TransactionRequest.CashAdvanceBuilder>

Builds a TransactionType.CASH_ADVANCE request (PostFinance cashback operation).

Functions

fun amount(amount: Amount): TransactionRequest.CashAdvanceBuilder

Amount to charge.

fun amount(value: Long, fractionDigits: Int, currency: Int): TransactionRequest.CashAdvanceBuilder

amount taking the ISO-4217 numeric currency code - the officially supported form, for example amount(1050, 2, 756) for CHF 10.50 - instead of the alphabetic code.

fun amount(value: Long, fractionDigits: Int, currency: String): TransactionRequest.CashAdvanceBuilder

Amount to charge, expressed with fractionDigits fraction digits instead of currency's own default, for example amount(1050, 2, "CHF") for CHF 10.50 - useful when the value is only known at a different (or unknown) scale, for example digit-by-digit from a UI text field typed by a cashier, without needing java.math.BigDecimal. Rescaled to currency's actual minor units, rounding half up if fractionDigits is more precise than the currency supports.

build

open fun build(): TransactionRequest

Builds the TransactionRequest.

manualCardEntry

@JvmOverloads

fun manualCardEntry(pan: String, expiryDate: String, cvc2: String? = null): TransactionRequest.CashAdvanceBuilder

Sets pan/expiryDate/cvc2 together for manual PAN key entry ("MPKE") - see TransactionRequest.pan for field meaning. cvc2 is optional.

salesId

fun salesId(salesId: String): TransactionRequest.CashAdvanceBuilder

See TransactionRequest.salesId.

transactionId

fun transactionId(transactionId: String): TransactionRequest.CashAdvanceBuilder

Sets TransactionRequest.transactionId. Optional - defaults to a random UUID if never called. Set explicitly to control it, for example to persist it before starting the transaction (see "Payment recovery" in the README).