public class AuthorizationRequest extends Object implements ICoreRequest, IPaymentMethod, IPreviousTransaction, IRequestAmount, ISignatureRequest, ISubtotals, ITerminalReference
| Constructor and Description |
|---|
AuthorizationRequest() |
| Modifier and Type | Method and Description |
|---|---|
String |
getAddress()
Gets the cardholder address for use with address verification.
|
Map |
getAltPrices()
Gets a map of alternate currencies and the price in each currency.
|
String |
getAmount()
Gets the requested amount.
|
String |
getCardholderName()
Gets the cardholder name.
|
CardType |
getCardType()
Gets designates categories of cards: credit, debit, EBT.
|
String |
getCashBackAmount()
Gets the amount of cash back requested.
|
String |
getCurrencyCode()
Gets the transaction currency code.
|
Customer |
getCustomer()
Gets suggested receipt fields.
|
String |
getCvv()
Gets the card CVV for use with PAN based transactions.
|
String |
getDescription()
Gets a narrative description of the transaction.
|
String |
getDestinationAccount()
Gets the settlement account for merchants with split settlements.
|
String |
getEbtEligibleAmount()
Gets the amount of the transaction that should be charged to an EBT card.
|
String |
getExpMonth()
Gets the card expiration month for use with PAN based transactions.
|
String |
getExpYear()
Gets the card expiration year for use with PAN based transactions.
|
String |
getFsaEligibleAmount()
Gets the amount of the transaction that should be charged to an FSA card.
|
String |
getHsaEligibleAmount()
Gets the amount of the transaction that should be charged to an HSA card.
|
String |
getKsn()
Gets the key serial number used for DUKPT encryption.
|
String |
getOnlineAuthCode()
Gets used to validate online gift card authorizations.
|
String |
getOrderRef()
Gets an identifier from an external point of sale system.
|
String |
getPan()
Gets the primary account number.
|
String |
getPaymentType()
Gets designates brands of payment methods: Visa, Discover, etc.
|
String |
getPinBlock()
Gets the encrypted pin block.
|
String |
getPostalCode()
Gets the cardholder postal code for use with address verification.
|
String |
getRoutingNumber()
Gets the ACH routing number for ACH transactions.
|
String |
getSigFile()
Gets a location on the filesystem which a customer signature should be written to.
|
SignatureFormat |
getSigFormat()
Gets the image format to be used for returning signatures.
|
int |
getSigWidth()
Gets the width that the signature image should be scaled to, preserving the aspect
ratio.
|
String |
getTaxAmount()
Gets the tax amount.
|
String |
getTerminalName()
Gets the name of the target payment terminal.
|
int |
getTimeout()
Gets the request timeout in seconds.
|
String |
getTipAmount()
Gets the tip amount.
|
String |
getToken()
Gets the payment token to be used for this transaction.
|
String |
getTrack1()
Gets track 1 magnetic stripe data.
|
String |
getTrack2()
Gets track 2 magnetic stripe data.
|
String |
getTransactionId()
Gets the ID of the previous transaction being referenced.
|
String |
getTransactionRef()
Gets the transaction reference string assigned to the transaction request.
|
boolean |
isCashBackEnabled()
Gets that cash back should be enabled for supported cards.
|
boolean |
isDisableSignature()
Gets whether or not signature prompt should be skipped on the terminal.
|
boolean |
isEnroll()
Gets that the payment method should be added to the token vault alongside the
authorization.
|
boolean |
isManualEntry()
Gets that the payment entry method is a manual keyed transaction.
|
boolean |
isPromptForTip()
Gets that the terminal should request a tip from the user before starting the
transaction.
|
boolean |
isTaxExempt()
Gets that the request is tax exempt.
|
boolean |
isTest()
Gets whether or not to route transaction to the test gateway.
|
void |
setAddress(String value)
Sets the cardholder address for use with address verification.
|
void |
setAltPrices(Map value)
Sets a map of alternate currencies and the price in each currency.
|
void |
setAmount(String value)
Sets the requested amount.
|
void |
setCardholderName(String value)
Sets the cardholder name.
|
void |
setCardType(CardType value)
Sets designates categories of cards: credit, debit, EBT.
|
void |
setCashBackAmount(String value)
Sets the amount of cash back requested.
|
void |
setCashBackEnabled(boolean value)
Sets that cash back should be enabled for supported cards.
|
void |
setCurrencyCode(String value)
Sets the transaction currency code.
|
void |
setCustomer(Customer value)
Sets suggested receipt fields.
|
void |
setCvv(String value)
Sets the card CVV for use with PAN based transactions.
|
void |
setDescription(String value)
Sets a narrative description of the transaction.
|
void |
setDestinationAccount(String value)
Sets the settlement account for merchants with split settlements.
|
void |
setDisableSignature(boolean value)
Sets whether or not signature prompt should be skipped on the terminal.
|
void |
setEbtEligibleAmount(String value)
Sets the amount of the transaction that should be charged to an EBT card.
|
void |
setEnroll(boolean value)
Sets that the payment method should be added to the token vault alongside the
authorization.
|
void |
setExpMonth(String value)
Sets the card expiration month for use with PAN based transactions.
|
void |
setExpYear(String value)
Sets the card expiration year for use with PAN based transactions.
|
void |
setFsaEligibleAmount(String value)
Sets the amount of the transaction that should be charged to an FSA card.
|
void |
setHsaEligibleAmount(String value)
Sets the amount of the transaction that should be charged to an HSA card.
|
void |
setKsn(String value)
Sets the key serial number used for DUKPT encryption.
|
void |
setManualEntry(boolean value)
Sets that the payment entry method is a manual keyed transaction.
|
void |
setOnlineAuthCode(String value)
Sets used to validate online gift card authorizations.
|
void |
setOrderRef(String value)
Sets an identifier from an external point of sale system.
|
void |
setPan(String value)
Sets the primary account number.
|
void |
setPaymentType(String value)
Sets designates brands of payment methods: Visa, Discover, etc.
|
void |
setPinBlock(String value)
Sets the encrypted pin block.
|
void |
setPostalCode(String value)
Sets the cardholder postal code for use with address verification.
|
void |
setPromptForTip(boolean value)
Sets that the terminal should request a tip from the user before starting the
transaction.
|
void |
setRoutingNumber(String value)
Sets the ACH routing number for ACH transactions.
|
void |
setSigFile(String value)
Sets a location on the filesystem which a customer signature should be written to.
|
void |
setSigFormat(SignatureFormat value)
Sets the image format to be used for returning signatures.
|
void |
setSigWidth(int value)
Sets the width that the signature image should be scaled to, preserving the aspect
ratio.
|
void |
setTaxAmount(String value)
Sets the tax amount.
|
void |
setTaxExempt(boolean value)
Sets that the request is tax exempt.
|
void |
setTerminalName(String value)
Sets the name of the target payment terminal.
|
void |
setTest(boolean value)
Sets whether or not to route transaction to the test gateway.
|
void |
setTimeout(int value)
Sets the request timeout in seconds.
|
void |
setTipAmount(String value)
Sets the tip amount.
|
void |
setToken(String value)
Sets the payment token to be used for this transaction.
|
void |
setTrack1(String value)
Sets track 1 magnetic stripe data.
|
void |
setTrack2(String value)
Sets track 2 magnetic stripe data.
|
void |
setTransactionId(String value)
Sets the ID of the previous transaction being referenced.
|
void |
setTransactionRef(String value)
Sets the transaction reference string assigned to the transaction request.
|
public void setTransactionRef(String value)
value - the transaction reference string assigned to the transaction
request. If no transaction ref was assiged on the request, then the gateway will
randomly generate one.public String getTransactionRef()
getTransactionRef in interface ICoreRequestpublic void setOrderRef(String value)
value - an identifier from an external point of sale system.public String getOrderRef()
getOrderRef in interface ICoreRequestpublic void setDestinationAccount(String value)
value - the settlement account for merchants with split settlements.public String getDestinationAccount()
getDestinationAccount in interface ICoreRequestpublic void setTest(boolean value)
value - whether or not to route transaction to the test gateway.public boolean isTest()
isTest in interface ICoreRequestpublic void setTimeout(int value)
value - the request timeout in seconds.public int getTimeout()
getTimeout in interface ICoreRequestpublic void setToken(String value)
value - the payment token to be used for this transaction. This should be used
for recurring transactions.public String getToken()
getToken in interface IPaymentMethodpublic void setTrack1(String value)
value - track 1 magnetic stripe data.public String getTrack1()
getTrack1 in interface IPaymentMethodpublic void setTrack2(String value)
value - track 2 magnetic stripe data.public String getTrack2()
getTrack2 in interface IPaymentMethodpublic void setPan(String value)
value - the primary account number. We recommend using the terminal or
e-commerce tokenization libraries instead of passing account numbers in
directly, as this would put your application in PCI scope.public String getPan()
getPan in interface IPaymentMethodpublic void setRoutingNumber(String value)
value - the ACH routing number for ACH transactions.public String getRoutingNumber()
getRoutingNumber in interface IPaymentMethodpublic void setCardholderName(String value)
value - the cardholder name. Only required if the request includes a primary
account number or track data.public String getCardholderName()
getCardholderName in interface IPaymentMethodpublic void setExpMonth(String value)
value - the card expiration month for use with PAN based transactions.public String getExpMonth()
getExpMonth in interface IPaymentMethodpublic void setExpYear(String value)
value - the card expiration year for use with PAN based transactions.public String getExpYear()
getExpYear in interface IPaymentMethodpublic void setCvv(String value)
value - the card CVV for use with PAN based transactions.public String getCvv()
getCvv in interface IPaymentMethodpublic void setAddress(String value)
value - the cardholder address for use with address verification.public String getAddress()
getAddress in interface IPaymentMethodpublic void setPostalCode(String value)
value - the cardholder postal code for use with address verification.public String getPostalCode()
getPostalCode in interface IPaymentMethodpublic void setManualEntry(boolean value)
value - that the payment entry method is a manual keyed transaction. If this
is true, no other payment method will be accepted.public boolean isManualEntry()
isManualEntry in interface IPaymentMethodpublic void setKsn(String value)
value - the key serial number used for DUKPT encryption.public String getKsn()
getKsn in interface IPaymentMethodpublic void setPinBlock(String value)
value - the encrypted pin block.public String getPinBlock()
getPinBlock in interface IPaymentMethodpublic void setCardType(CardType value)
value - designates categories of cards: credit, debit, EBT.public CardType getCardType()
getCardType in interface IPaymentMethodpublic void setPaymentType(String value)
value - designates brands of payment methods: Visa, Discover, etc.public String getPaymentType()
getPaymentType in interface IPaymentMethodpublic void setTransactionId(String value)
value - the ID of the previous transaction being referenced.public String getTransactionId()
getTransactionId in interface IPreviousTransactionpublic void setCurrencyCode(String value)
value - the transaction currency code.public String getCurrencyCode()
getCurrencyCode in interface IRequestAmountpublic void setAmount(String value)
value - the requested amount.public String getAmount()
getAmount in interface IRequestAmountpublic void setTaxExempt(boolean value)
value - that the request is tax exempt. Only required for tax exempt level 2
processing.public boolean isTaxExempt()
isTaxExempt in interface IRequestAmountpublic void setSigFile(String value)
value - a location on the filesystem which a customer signature should be
written to.public String getSigFile()
getSigFile in interface ISignatureRequestpublic void setSigFormat(SignatureFormat value)
value - the image format to be used for returning signatures.public SignatureFormat getSigFormat()
getSigFormat in interface ISignatureRequestpublic void setSigWidth(int value)
value - the width that the signature image should be scaled to, preserving
the aspect ratio. If not provided, the signature is returned in the terminal's max
resolution.public int getSigWidth()
getSigWidth in interface ISignatureRequestpublic void setDisableSignature(boolean value)
value - whether or not signature prompt should be skipped on the terminal.
The terminal will indicate whether or not a signature is required by the card in the
receipt suggestions response.public boolean isDisableSignature()
isDisableSignature in interface ISignatureRequestpublic void setTipAmount(String value)
value - the tip amount.public String getTipAmount()
getTipAmount in interface ISubtotalspublic void setTaxAmount(String value)
value - the tax amount.public String getTaxAmount()
getTaxAmount in interface ISubtotalspublic void setCashBackAmount(String value)
value - the amount of cash back requested.public String getCashBackAmount()
getCashBackAmount in interface ISubtotalspublic void setFsaEligibleAmount(String value)
value - the amount of the transaction that should be charged to an FSA card.
This amount may be less than the transaction total, in which case only this amount
will be charged if an FSA card is presented. If the FSA amount is paid on an FSA card,
then the FSA amount authorized will be indicated on the response.public String getFsaEligibleAmount()
getFsaEligibleAmount in interface ISubtotalspublic void setHsaEligibleAmount(String value)
value - the amount of the transaction that should be charged to an HSA card.public String getHsaEligibleAmount()
getHsaEligibleAmount in interface ISubtotalspublic void setEbtEligibleAmount(String value)
value - the amount of the transaction that should be charged to an EBT card.public String getEbtEligibleAmount()
getEbtEligibleAmount in interface ISubtotalspublic void setTerminalName(String value)
value - the name of the target payment terminal.public String getTerminalName()
getTerminalName in interface ITerminalReferencepublic void setOnlineAuthCode(String value)
value - used to validate online gift card authorizations.public String getOnlineAuthCode()
public void setEnroll(boolean value)
value - that the payment method should be added to the token vault alongside
the authorization.public boolean isEnroll()
public void setDescription(String value)
value - a narrative description of the transaction.public String getDescription()
public void setPromptForTip(boolean value)
value - that the terminal should request a tip from the user before starting
the transaction.public boolean isPromptForTip()
public void setCashBackEnabled(boolean value)
value - that cash back should be enabled for supported cards.public boolean isCashBackEnabled()
public void setAltPrices(Map value)
value - a map of alternate currencies and the price in each currency.public Map getAltPrices()
public void setCustomer(Customer value)
value - suggested receipt fields.public Customer getCustomer()
Copyright © 2020 BlockChyp, Inc.. All rights reserved.