Class Invoice
Following transactions do require invoice object:
- Sale Transaction
- Authorization Transaction
- Voice Authorization Transaction
- Primary Credit Transaction
- Recurring Transaction : Action -- Add, Payment
However, Invoice information can also be passed in the following transactions:
- Delayed Capture Transaction
- Credit Transaction
- Void Authorization Transaction
- Reference Credit Transaction
................. // Create a new Invoice data object with the Amount, Billing Address etc. details. Invoice inv = new Invoice(); // Set Amount. Currency amt = new Currency(new decimal(25.12)); inv.setAmt(amt); inv.setPoNum("PO12345"); inv.setInvNum("INV12345"); inv.setAltTaxAmt(new Currency(new decimal(25.14))); // Set the Billing Address details. BillTo bill = new BillTo(); bill.setBillToStreet("123 Main St."); bill.setBillToZip("12345"); inv.setBillTo (Bill); .................
-
Constructor Summary
ConstructorsConstructorDescriptionInvoice()Constructor.This is a default constructor which does not take any parameters. -
Method Summary
Modifier and TypeMethodDescriptionvoidAdds a advice detail item to the list.voidaddLineItem(LineItem item) Adds a line item to line item list.protected voidGets the AltTaxAmountgetAmt()Gets the AmountGets the BillTo ObjectGets the BrowserInfo ObjectGets the CitDateGets the CommCodeGets Comment1Gets Comment2protected ContextGets the Customer's IP Address.Gets the CustomerInfo ObjectGets the custrefgetDesc()Gets the descriptiongetDesc1()Gets the description1getDesc2()Gets the description2getDesc3()Gets the description3getDesc4()Gets the description4Gets the DiscountGets the DutyAmountGets the EchoData.Gets the EndTimeGets the Freight AmountGets the Handling AmountGets the InvNumGets the Invoice DateGets the line item Amount.Gets the Local Tax Amount.Gets the Miscellaneous Data.Gets the National Tax AmountGets the Order dateGets the order description for this InvoiceGets the OrderIDGets the Order TimegetPar()Gets the PargetPoNum()Gets the PoNum.Gets the Recurring status.Gets the type of the Recurring transaction (UK).Gets the Report Group.protected StringBufferGets the Requestbuffer used for creating the actual request string.Gets the SCAExemption.Gets the Shipping Amt.Gets the Start TimeGets the Tax AmtGets the TaxExemptGets the TransactionId.Gets the UserItem ObjectGets the VAT Invoice Number.Gets the VAT registration numberGets the Vat Tax AmtGets the VAT Tax percentage.Gets the VAT Tax Rate.getVMaid()Gets the VMaidvoidremoveAdviceDetailItem(int index) Removes a advice detail item from the list.voidClears the advice detail item list.voidClears the line item list.voidremoveLineItem(int index) Removes a line item from line item list.voidsetAltTaxAmt(Currency altTaxAmt) Sets the AltTaxAmountvoidSets the AmountvoidSets the BillTo ObjectvoidsetBrowserInfo(BrowserInfo browserInfo) Sets the BrowserInfo ObjectvoidsetCitDate(String citDate) Sets the CitDate.voidsetCommCode(String commCode) Sets the CommCodevoidsetComment1(String comment1) Sets Comment1voidsetComment2(String comment2) Sets Comment2protected voidsetContext(Context context) voidSets the Customer's IP Address.voidsetCustomerInfo(CustomerInfo customerInfo) Sets the CustomerInfo ObjectvoidsetCustRef(String custRef) Sets the CommCodevoidSets the descriptionvoidSets the description1voidSets the description2voidSets the description3voidSets the description4voidsetDevices(Devices devices) Sets the Devices ObjectvoidsetDiscount(Currency discount) Sets the DiscountvoidsetDutyAmt(Currency dutyAmt) Sets the DutyAmountvoidsetEchoData(String echoData) Sets the EchoData.voidsetEndTime(String endTime) Sets the EndTimevoidsetFreightAmt(Currency freightAmt) Sets the Freight AmountvoidsetHandlingAmt(Currency handlingAmt) Sets the Handling AmountvoidSets the InvNumvoidsetInvoiceDate(String invoiceDate) Sets the Invoice DatevoidsetItemAmt(Currency itemAmt) Sets the line item Amount.voidsetLocalTaxAmt(Currency localTaxAmt) Sets the Local Tax Amount.voidsetMerchantInfo(MerchantInfo merchantInfo) Sets the MerchantInfo ObjectvoidsetMiscData(String miscData) Sets the Miscellaneous Data.voidsetNationalTaxAmt(Currency nationalTaxAmt) Sets the National Tax Amount.voidsetOrderDate(String orderDate) Sets the Order DatevoidsetOrderDesc(String orderDesc) Sets the order description for this InvoicevoidsetOrderId(String orderId) Sets the OrderID.voidsetOrderTime(String orderTime) Sets the Order TimevoidSets the PARvoidSets the PoNum.voidsetRecurring(String recurring) Sets the Recurring status.voidsetRecurringType(String recurringType) Sets the type of the Recurring transaction (UK).voidsetReportGroup(String reportGroup) Sets the Report Group.protected voidsetRequestBuffer(StringBuffer value) sets the StringBuffer to hold the request string.voidsetScaExemption(String scaExemption) Sets the SCAExemption.voidsetShippingAmt(Currency shippingAmt) Sets the Shipping AmtvoidvoidsetStartTime(String startTime) Sets the Start Time.voidSets the Tax AmtvoidsetTaxExempt(String taxExempt) Sets the TaxExemptvoidsetTransactionId(String transactionId) Sets the TransactionId.voidsetUserItem(UserItem userItem) Sets the UserItem ObjectvoidsetVatInvNum(String vatInvNum) Sets the VAT Invoice Number.voidsetVatRegNum(String vatRegNum) Sets the VAT registration numbervoidsetVatTaxAmt(Currency vatTaxAmt) Sets the Vat Tax AmtvoidsetVatTaxPercent(String vatTaxPercent) Sets the VAT Tax percentage.voidsetVatTaxRate(String vatTaxRate) Sets the VAT Tax Rate.voidSets the VMaid
-
Constructor Details
-
Invoice
public Invoice()Constructor.This is a default constructor which does not take any parameters. *
-
-
Method Details
-
addLineItem
Adds a line item to line item list.- Parameters:
item- Lineitem objectUse this method to add a line item in the purchase order.
Line item data describes the details of the item purchased and can be can be passed for each transaction. The convention for passing line item data in name/value pairs is that each name/value starts with L_ and ends with n where n is the line item number. For example L_QTY0=1 is the quantity for line item 0 and is equal to 1, with n starting at 0
Following example shows how to use line item.
................. //inv is the Invoice object. ................. // Create a line item. LineItem item = new LineItem(); // Add first item. Currency lnamt = new Currency(new Double(8.95), "USD"); item.setAmt(lnamt); item.setDesc("Line 1"); item.setQty(1); item.setItemNumber("1"); // Add line item to invoice. inv.addLineItem(item); // Create a line item. LineItem item1 = new LineItem(); // Add second item. Currency lnamt1 = new Currency(new Double(5.25), "USD"); item1.setAmt(lnamt); item1.setDesc("Line 2"); item1.setQty(2); item1.setItemNumber("2"); // Add line item to invoice. inv.addLineItem(item1); .................
-
removeLineItem
public void removeLineItem(int index) Removes a line item from line item list.- Parameters:
index- Index of lineitem to be removed.Use this method to remove a line item at a particular index in the purchase order.
................. // Inv is the Invoice object ................. // Remove item at index 0 inv.removeLineItem(0); .................
-
removeAllLineItems
public void removeAllLineItems()Clears the line item list.Use this method to clear all the line items added to the purchase order.
................. // inv is the Invoice object ................. // Remove all line items. inv.removeAllLineItems(); .................
-
addAdviceDetailItem
Adds a advice detail item to the list.- Parameters:
item- AdviceDetail objectThis class holds the advice detail related information. Detail of a charge where *n* is a value from 1 - 5. Use for additional breakdown of the amount. For example ADDLAMT1=1 is the amount for the additional amount for advice detail item 1 and is equal to 1,
Following example shows how to use advice detail.
................. //inv is the Invoice object. ................. // Create a advice detail item. AdviceDetail addDetail1 = new AdviceDetail(); addDetail1.setAddLAmt("1"); addDetail1.setAddLAmtType("1"); inv.addAdviceDetailItem(addDetail1); // To add another item, just do the same as above but increment the value of AddDetail to 2: AddDetail2 ..................
-
removeAdviceDetailItem
public void removeAdviceDetailItem(int index) Removes a advice detail item from the list.- Parameters:
index- Index of the AdviceDetailItem to be removed.Use this method to remove a advice detail item at a particular index in the purchase order.
................. // Inv is the Invoice object ................. // Remove item at index 2 inv.removeAdviceDetailItem(2); .................
-
removeAllAdviceDetailItem
public void removeAllAdviceDetailItem()Clears the advice detail item list.Use this method to clear all the items added to the purchase order.
................. // inv is the Invoice object ................. // Remove all advice detail items. inv.removeAllAdviceDetailItem(); ................. -
generateRequest
protected void generateRequest() -
getAltTaxAmt
Gets the AltTaxAmountAlternate Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: ALTTAXAMT
-
setAltTaxAmt
Sets the AltTaxAmountAlternate Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
altTaxAmt- CurrencyMaps to Payflow Parameter: ALTTAXAMT
-
getAmt
Gets the AmountAmount (US Dollars) U.S. based currency. Specify the exact amount to the cent using a decimal point'use 34.00, not 34. Do not include comma separators'use 1199.95 not 1,199.95.
Your processor and/or Internet merchant account provider may stipulate a maximum amount.
- Returns:
- Currency
Maps to Payflow Parameter: AMT
................. // inv is the Invoice object ................. // Set the Amount for the invoice. // A valid amount is a two decimal value. Currency amt = new Currency(new decimal(25.12)) //For values which have more than two decimal places Currency amt = new Currency(new decimal(25.1214)); amt.setNoOfDecimalDigits (2); //If the NoOfDecimalDigits property is used then it is mandatory to set one of the following properties to true. amt.setRound (true); amt.setTruncate (true); inv.setAmt (Amt);
-
setAmt
Sets the AmountAmount (US Dollars) U.S. based currency. Specify the exact amount to the cent using a decimal point'use 34.00, not 34. Do not include comma separators'use 1199.95 not 1,199.95.
Your processor and/or Internet merchant account provider may stipulate a maximum amount.
- Parameters:
amt- CurrencyMaps to Payflow Parameter: AMT
................. // inv is the Invoice object ................. // Set the Amount for the invoice. // A valid amount is a two decimal value. Currency amt = new Currency(new decimal(25.12)) //For values which have more than two decimal places Currency amt = new Currency(new decimal(25.1214)); amt.setNoOfDecimalDigits (2); //If the NoOfDecimalDigits property is used then it is mandatory to set one of the following properties to true. amt.setRound (true); amt.setTruncate (true); inv.setAmt (Amt);
-
getBillTo
Gets the BillTo ObjectUse this method to get the billing addresses of the purchase order.
- Returns:
- BillTo
-
setBillTo
Sets the BillTo ObjectUse this method to set the billing addresses of the purchase order.
- Parameters:
billTo- BillTo................. // inv is the Invoice object ................. // Set the Billing Address details. BillTo bill = New BillTo(); bill.setBillToStreet("123 Main St."); bill.setBillToZip("12345"); inv.setBillTo (bill); .................
-
getBrowserInfo
Gets the BrowserInfo ObjectUse this method to get the browser related information of the purchase order.
- Returns:
- BrowserInfo
-
setBrowserInfo
Sets the BrowserInfo ObjectUse this method to set the browser related information of the purchase order.
- Parameters:
browserInfo- BrowserInfo................. // inv is the Invoice object ................. // Set the Browser Info details. BrowserInfo browser = New BrowserInfo(); browser.setBrowserCountryCode ("USA"); browser.setBrowserUserAgent ("IE 6.0"); inv.setBrowserInfo (browser); .................
-
getCommCode
Gets the CommCodeUse this method to get the Commodity Code for the purchase order.
- Returns:
- String
Maps to Payflow Parameter: COMMCODE
-
setCommCode
Sets the CommCodeUse this method to set the Commodity Code for the purchase order.
- Parameters:
commCode- StringMaps to Payflow Parameter: COMMCODE
-
getComment1
Gets Comment1Merchant-defined value for reporting and auditing purposes.
- Returns:
- String
Maps to Payflow Parameter: COMMENT1
-
setComment1
Sets Comment1Merchant-defined value for reporting and auditing purposes.
- Parameters:
comment1- StringMaps to Payflow Parameter: COMMENT1
-
getComment2
Gets Comment2Merchant-defined value for reporting and auditing purposes.
- Returns:
- String
Maps to Payflow Parameter: COMMENT2
-
setComment2
Sets Comment2Merchant-defined value for reporting and auditing purposes.
- Parameters:
comment2- StringMaps to Payflow Parameter: COMMENT2
-
getCustomerInfo
Gets the CustomerInfo ObjectUse this method to get the customer related information of the purchase order.
- Returns:
- CustomerInfo
-
setCustomerInfo
Sets the CustomerInfo ObjectUse this method to set the customer related information of the purchase order.
- Parameters:
customerInfo- CustomerInfo................. // inv is the Invoice object ................. // Set the Customer Info details. CustomerInfo cust = New CustomerInfo(); cust.setCustCode ("CustXXXXX"); cust.setCustIP ("255.255.255.255"); inv.setCustomerInfo (Cust); .................
-
setMerchantInfo
Sets the MerchantInfo ObjectUse this method to set the merchant related information of the purchase order.
- Parameters:
merchantInfo- MerchantInfo................. // inv is the Invoice object ................. // Set the Merchant Info details. MerchantInfo merchant = new MerchantInfo(); merchant.setMerchantName("MerchantXXXXX"); merchant.setMerchantCity("Somewhere"); inv.setMerchantInfo (merchant); .................
-
setDevices
Sets the Devices ObjectUse this method to set the devices the cardholder used.
- Parameters:
devices- Devices................. // inv is the Invoice object ................. // Set the Devices details. Devices devices = new Devices(); devices.setCatType("3"); devices.setContactLess("RFD"); inv.set .................
-
getUserItem
Gets the UserItem ObjectUse this method to get the User items.
- Returns:
- UserItem
-
setUserItem
Sets the UserItem ObjectUse this method to set the User Items.
- Parameters:
userItem- UserItem................. // inv is the Invoice object ................. // Set the User Item details. UserItem nUser = new UserItem(); nUser.setUserItem1("TUSER1"); nUser.setUserItem2("TUSER2"); inv.setUserItem(nUser); .................
-
getCustRef
Gets the custrefMerchant-defined identifier for reporting and auditing purposes.
You can use CUSTREF when performing Inquiry transactions. To ensure that you can always access the correct transaction when performing an Inquiry, you must provide a unique CUSTREF when submitting any transaction, including retries.
- Returns:
- String
Maps to Payflow Parameter: CUSTREF
-
setCustRef
Sets the CommCodeMerchant-defined identifier for reporting and auditing purposes.
You can use CUSTREF when performing Inquiry transactions. To ensure that you can always access the correct transaction when performing an Inquiry, you must provide a unique CUSTREF when submitting any transaction, including retries.
- Parameters:
custRef- StringMaps to Payflow Parameter: CUSTREF
-
getDesc
Gets the descriptionGeneral description of the transaction.
- Returns:
- String
Maps to Payflow Parameter: DESC
-
setDesc
Sets the descriptionGeneral description of the transaction.
- Parameters:
desc- StringMaps to Payflow Parameter: DESC
-
getDesc1
Gets the description1Up to 4 lines of additional description of the charge.
- Returns:
- String
Maps to Payflow Parameter: DESC1
-
setDesc1
Sets the description1Up to 4 lines of additional description of the charge.
- Parameters:
desc1- StringMaps to Payflow Parameter: DESC1
-
getDesc2
Gets the description2Up to 4 lines of additional description of the charge.
- Returns:
- String
Maps to Payflow Parameter: DESC2
-
setDesc2
Sets the description2Up to 4 lines of additional description of the charge.
- Parameters:
desc2- StringMaps to Payflow Parameter: DESC2
-
getDesc3
Gets the description3Up to 4 lines of additional description of the charge.
- Returns:
- String
Maps to Payflow Parameter: DESC3
-
setDesc3
Sets the description3Up to 4 lines of additional description of the charge.
- Parameters:
desc3- StringMaps to Payflow Parameter: DESC3
-
getDesc4
Gets the description4Up to 4 lines of additional description of the charge.
- Returns:
- String
Maps to Payflow Parameter: DESC4
-
setDesc4
Sets the description4Up to 4 lines of additional description of the charge.
- Parameters:
desc4- StringMaps to Payflow Parameter: DESC4
-
getDiscount
Gets the DiscountDiscount amount on total sale. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: DISCOUNT
-
setDiscount
Sets the DiscountDiscount amount on total sale. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
discount- CurrencyMaps to Payflow Parameter: DISCOUNT
-
getDutyAmt
Gets the DutyAmountSometimes called import tax. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: DUTYAMT
-
setDutyAmt
Sets the DutyAmountSometimes called import tax. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
dutyAmt- CurrencyMaps to Payflow Parameter: DUTYAMT
-
getEndTime
Gets the EndTimeENDTIME specifies the end of the time period during which the transaction specified by the CUSTREF occurred.
ENDTIME must be less than 30 days after STARTTIME. An inquiry cannot be performed across a date range greater than 30 days.
If you set ENDTIME, and not STARTTIME, then STARTTIME is defaulted to 30 days before ENDTIME. If neither STARTTIME nor ENDTIME is specified, then the system searches the last 30 days.
Format: yyyymmddhhmmss
yyyy - Year, mm - Month dd - Day, hh - Hours, mm - Minutes ss - Seconds.
- Returns:
- String
Maps to Payflow Parameter: ENDTIME
-
setEndTime
Sets the EndTimeENDTIME specifies the end of the time period during which the transaction specified by the CUSTREF occurred.
ENDTIME must be less than 30 days after STARTTIME. An inquiry cannot be performed across a date range greater than 30 days.
If you set ENDTIME, and not STARTTIME, then STARTTIME is defaulted to 30 days before ENDTIME. If neither STARTTIME nor ENDTIME is specified, then the system searches the last 30 days.
Format: yyyymmddhhmmss
yyyy - Year, mm - Month dd - Day, hh - Hours, mm - Minutes ss - Seconds.
- Parameters:
endTime- StringMaps to Payflow Parameter: ENDTIME
-
getFreightAmt
Gets the Freight AmountFreight Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: FREIGHTAMT
-
setFreightAmt
Sets the Freight AmountFreight Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
freightAmt- CurrencyMaps to Payflow Parameter: FREIGHTAMT
-
getHandlingAmt
Gets the Handling AmountHandling Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: HANDLINGAMT
-
setHandlingAmt
Sets the Handling AmountUHandling Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
handlingAmt- CurrencyMaps to Payflow Parameter: HANDLINGAMT
-
getInvNum
Gets the InvNumMerchant invoice number. This reference number (PNREF'generated by PayPal) is used for authorizations and settlements. The Acquirer decides if this information will appear on the merchant's bank reconciliation statement.
- Returns:
- String
Maps to Payflow Parameter: INVNUM
-
setInvNum
Sets the InvNumMerchant invoice number. This reference number (PNREF'generated by PayPal) is used for authorizations and settlements. The Acquirer decides if this information will appear on the merchant's bank reconciliation statement.
- Parameters:
invNum- StringMaps to Payflow Parameter: INVNUM
-
getInvoiceDate
Gets the Invoice DateTransaction Date.
Format: yyyymmdd.
yyyy - Year, mm - Month, dd - Day.
- Returns:
- String
Maps to Payflow Parameter: INVOICEDATE
-
setInvoiceDate
Sets the Invoice DateTransaction Date.
Format: yyyymmdd.
yyyy - Year, mm - Month, dd - Day.- Parameters:
invoiceDate- StringMaps to Payflow Parameter: INVOICEDATE
-
getLocalTaxAmt
Gets the Local Tax Amount.Local Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: LOCALTAXAMT
-
setLocalTaxAmt
Sets the Local Tax Amount.Local Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
localTaxAmt- CurrencyMaps to Payflow Parameter: LOCALTAXAMT
-
getNationalTaxAmt
Gets the National Tax AmountNational Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: NATIONALTAXAMT
-
setNationalTaxAmt
Sets the National Tax Amount.National Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
nationalTaxAmt- CurrencyMaps to Payflow Parameter: NATIONALTAXAMT
-
getOrderDate
Gets the Order dateOrder date. Format: mmddyy mm - Month, dd - Day, yy - Year.
- Returns:
- String
Maps to Payflow Parameter: ORDERDATE
-
setOrderDate
Sets the Order DateOrder date. Format: mmddyy mm - Month, dd - Day, yy - Year.
- Parameters:
orderDate- StringMaps to Payflow Parameter: ORDERDATE
-
getOrderTime
Gets the Order Time- Returns:
- String
Maps to Payflow Parameter: ORDERTIME
-
setOrderTime
Sets the Order Time- Parameters:
orderTime- StringMaps to Payflow Parameter: ORDERTIME
-
getPoNum
Gets the PoNum.Purchase Order Number / Merchant related data.
- Returns:
- String
Maps to Payflow Parameter: PONUM
-
setPoNum
Sets the PoNum.Purchase Order Number / Merchant related data.
- Parameters:
poNum- StringMaps to Payflow Parameter: PONUM
-
getTransactionId
Gets the TransactionId.Transaction ID / Merchant related data.
- Returns:
- String
Maps to Payflow Parameter: TRANSACTIONID
-
setTransactionId
Sets the TransactionId.Transaction Id / Merchant related data.
- Parameters:
transactionId- StringMaps to Payflow Parameter: TRANSACTIONID
-
getEchoData
Gets the EchoData.Used to echo data back in response.
- Returns:
- String
Maps to Payflow Parameter: ECHODATA
-
setEchoData
Sets the EchoData.Echo Data is used to "echo" back data sent for processing in the response.
For example, if you send "ECHODATA=ADDRESS" then the Billing Address fields will be returned in the response
- Parameters:
echoData- StringMaps to Payflow Parameter: ECHODATA
-
getOrderId
Gets the OrderIDUsed for Order ID
- Returns:
- orderID String
Maps to Payflow Parameter: ORDERID
-
setOrderId
Sets the OrderID.Order ID is used to prevent duplicate "orders" from being processed. This is NOT the same as Request ID; which is used at the transaction level. Order ID (ORDERID) is used to check for a duplicate order in the future. For example, if you pass ORDERID=10101 and in two weeks another order is processed with the same ORDERID, a duplicate condition will occur. The results you receive will be from the original order with DUPLICATE=2 to show that it was ORDERID that triggered the duplicate. The order id is stored for 3 years.
Important Note: Order ID functionality to catch duplicate orders processed withing seconds of each other is limited. Order ID should be used in conjunction with Request ID to prevent duplicates due to processing / communication errors. DO NOT use ORDERID as your only means to check for duplicate transactions.
- Parameters:
orderId- StringMaps to Payflow Parameter: ORDERID
-
getRecurring
Gets the Recurring status.Is a recurring transaction? Y or N.
- Returns:
- String
Maps to Payflow Parameter: RECURRING
-
setRecurring
Sets the Recurring status.Is a recurring transaction? Y or N.
- Parameters:
recurring- StringMaps to Payflow Parameter: RECURRING
-
getShippingAmt
Gets the Shipping Amt.Shipping Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- Currency
Maps to Payflow Parameter: SHIPPINGAMT
-
setShippingAmt
Sets the Shipping AmtShipping Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
shippingAmt- CurrencyMaps to Payflow Parameter: SHIPPINGAMT
-
getShipTo
- Returns:
- ShipTo
Use this method to get the shipping addresses of the purchase order.
-
setShipTo
- Parameters:
shipTo-Use this property to set the shipping addresses of the purchase order.
................. // inv is the Invoice object ................. // Set the Shipping Address details. ShipTo ship = New ShipTo(); ship.setShipToStreet ("685A E. Middlefield Rd."); ship.setShipToZip ("94043"); inv.setShipTo(ship); .................
-
getStartTime
Gets the Start TimeSTARTTIME specifies the beginning of the time period during which the transaction specified by the CUSTREF occurred. If you set STARTTIME, and not ENDTIME, then ENDTIME is defaulted to 30 days after STARTTIME. If neither STARTTIME nor ENDTIME is specified, then the system searches the last 30 days. Format: yyyymmddhhmmss yyyy - Year, mm - Month dd - Day, hh - Hours, mm - Minutes ss - Seconds.
- Returns:
- startTime String
Maps to Payflow Parameter: STARTTIME
-
setStartTime
Sets the Start Time.STARTTIME specifies the beginning of the time period during which the transaction specified by the CUSTREF occurred. If you set STARTTIME, and not ENDTIME, then ENDTIME is defaulted to 30 days after STARTTIME. If neither STARTTIME nor ENDTIME is specified, then the system searches the last 30 days. Format: yyyymmddhhmmss
yyyy - Year, mm - Month dd - Day, hh - Hours, mm - Minutes ss - Seconds.
- Parameters:
startTime- StringMaps to Payflow Parameter: STARTTIME
-
getTaxAmt
Gets the Tax AmtTax Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- taxAmt Currency
Maps to Payflow Parameter: TAXAMT
-
setTaxAmt
Sets the Tax AmtTax Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
taxAmt- CurrencyMaps to Payflow Parameter: TAXAMT
-
getTaxExempt
Gets the TaxExemptIs the customer tax exempt? Y or N
- Returns:
- taxExempt String
Maps to Payflow Parameter: TAXEXEMPT
-
setTaxExempt
Sets the TaxExemptIs the customer tax exempt? Y or N
- Parameters:
taxExempt- StringMaps to Payflow Parameter: TAXEXEMPT
-
getVatRegNum
Gets the VAT registration number- Returns:
- vatRegNum String
Maps to Payflow Parameter: VATREGNUM
-
setVatRegNum
Sets the VAT registration number- Parameters:
vatRegNum- StringMaps to Payflow Parameter: VATREGNUM
-
getVatTaxAmt
Gets the Vat Tax AmtVAT Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- vatTaxAmt Currency
Maps to Payflow Parameter: VATTAXAMT
-
setVatTaxAmt
Sets the Vat Tax AmtVAT Tax Amount. Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
vatTaxAmt- CurrencyMaps to Payflow Parameter: VATTAXAMT
-
getVatTaxPercent
Gets the VAT Tax percentage.- Returns:
- vatTaxPercent String
Maps to Payflow Parameter: VATTAXPERCENT
-
setVatTaxPercent
Sets the VAT Tax percentage.- Parameters:
vatTaxPercent- StringMaps to Payflow Parameter: VATTAXPERCENT
-
getItemAmt
Gets the line item Amount.Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Returns:
- itemAmt String
Maps to Payflow Parameter: ITEMAMT
-
setItemAmt
Sets the line item Amount.Amount should always be a decimal. Exact amount to the cent (34.00, not 34). Do not include comma separators. Use 1199.95 instead of 1,199.95.
- Parameters:
itemAmt- StringMaps to Payflow Parameter: ITEMAMT
-
getOrderDesc
Gets the order description for this Invoice- Returns:
- orderDesc String
Maps to Payflow Parameter: ORDERDESC
-
setOrderDesc
Sets the order description for this Invoice- Parameters:
orderDesc- StringMaps to Payflow Parameter: ORDERDESC
-
setRecurringType
Sets the type of the Recurring transaction (UK). Type of transaction occurrence. The values are: F = First occurrence / S = Subsequent occurrence (default)- Parameters:
recurringType- StringMaps to Payflow Parameter: RECURRINGTYPE
-
getRecurringType
Gets the type of the Recurring transaction (UK).- Returns:
- recurringType String
Maps to Payflow Parameter: RECURRINGTYPE
-
setCustIp
Sets the Customer's IP Address.- Parameters:
custIp- StringMaps to Payflow Parameter: CUSTIP
-
getCustIp
Gets the Customer's IP Address.- Returns:
- custIp String
Maps to Payflow Parameter: CUSTIP
-
setVatInvNum
Sets the VAT Invoice Number.- Parameters:
vatInvNum- StringMaps to Payflow Parameter: VATINVNUM
-
getVatInvNum
Gets the VAT Invoice Number.- Returns:
- vatInvNum String
Maps to Payflow Parameter: VATINVNUM
-
setVatTaxRate
Sets the VAT Tax Rate.- Parameters:
vatTaxRate- StringMaps to Payflow Parameter: VATTAXRATE
-
getVatTaxRate
Gets the VAT Tax Rate.- Returns:
- vatTaxRate String
Maps to Payflow Parameter: VATTAXRATE
-
setReportGroup
Sets the Report Group. Category that the transaction is in, for example: coffee mugs.- Parameters:
reportGroup- StringMaps to Payflow Parameter: REPORTGROUP
-
getReportGroup
Gets the Report Group.- Returns:
- reportGroup String
Maps to Payflow Parameter: REPORTGROUP
-
setMiscData
Sets the Miscellaneous Data.- Parameters:
miscData- StringMaps to Payflow Parameter: MISCDATA
-
getMiscData
Gets the Miscellaneous Data.- Returns:
- miscData String
Maps to Payflow Parameter: MISCDATA
-
setScaExemption
Sets the SCAExemption.- Parameters:
scaExemption- StringMaps to Payflow Parameter: SCAEXEMPTION
-
getScaExemption
Gets the SCAExemption.- Returns:
- scaExemption String
Maps to Payflow Parameter: SCAEXEMPTION
-
setCitDate
Sets the CitDate.- Parameters:
citDate- StringMaps to Payflow Parameter: CITDATE
-
getCitDate
Gets the CitDate- Returns:
- citDate String
Maps to Payflow Parameter: CITDATE
-
setVMaid
Sets the VMaid- Parameters:
vMaid- StringMaps to Payflow Parameter: VMAID
-
getVMaid
Gets the VMaid- Returns:
- vMaid String
Maps to Payflow Parameter: VMAID
-
setPar
Sets the PAR- Parameters:
par- StringMaps to Payflow Parameter: PAR
-
getPar
Gets the Par- Returns:
- par String
Maps to Payflow Parameter: PAR
-
getContext
-
setContext
-
getRequestBuffer
Gets the Requestbuffer used for creating the actual request string.- Returns:
- mRequestBuffer StringBuffer
-
setRequestBuffer
sets the StringBuffer to hold the request string.- Parameters:
value- StringBuffer
-