merchant:epaymentform [2012/05/21 10:02] jpresley |
merchant:epaymentform [2013/04/18 15:19] (current) yura [Form Fields] |
| | | | |
| | [[:merchant:epaymentform:buynowlink|Creating a "Buy Now" button]] - Creating a "Buy Now" button | | [[:merchant:epaymentform:buynowlink|Creating a "Buy Now" button]] - Creating a "Buy Now" button |
| | + | |
| | + | [[:merchant:epaymentform:DropDown|Drop-Down Menu]] - Creating a Basic Drop-Down Menu |
| | | | |
| | [[:merchant:epaymentform:sameasbilling|Same As Billing]] - checkbox for "Same As Billing" | | [[:merchant:epaymentform:sameasbilling|Same As Billing]] - checkbox for "Same As Billing" |
| | | UMrouting | Checks | Bank Routing number. Required when UMcommand is set to check or checkcredit. | | | | UMrouting | Checks | Bank Routing number. Required when UMcommand is set to check or checkcredit. | |
| | | UMaccount | Checks | Checking Account Number. Required when UMcommand is set to check or checkcredit. | | | | UMaccount | Checks | Checking Account Number. Required when UMcommand is set to check or checkcredit. | |
| | + | | UMaccounttype | | The type of account to debit/credit, either “Checking” or “Savings”. If omitted or left blank, it will default to “Checking” Only applies to the Check:Sale and Check:Credit commands. | |
| | | UMamount | x | Charge amount without $. This is the grand total including tax, shipping and any discounts. | | | | UMamount | x | Charge amount without $. This is the grand total including tax, shipping and any discounts. | |
| | + | | UMallowPartialAuth | | Yes/No. Indicates whether to allow a partial authorization if the full UMamount is not available (for debit, prepaid and gift cards). If left blank or set to No, the transaction will be automatically canceled and reversed if full UMamount is not available. | |
| | | UMcurrency | * | Currency of UMamount. Required if using a [[Developer:multicurrency|MCP]] based account. Must be one of the 3 digit numeric codes found [[developer/currencycode|here]]. | | | | UMcurrency | * | Currency of UMamount. Required if using a [[Developer:multicurrency|MCP]] based account. Must be one of the 3 digit numeric codes found [[developer/currencycode|here]]. | |
| | | UMtax | | Portion of above charge amount (UMamount) that is sales tax. | | | | UMtax | | Portion of above charge amount (UMamount) that is sales tax. | |
| | | UMtip | | Portion of charge amount (UMamount) for gratuity (tip). | | | | UMtip | | Portion of charge amount (UMamount) for gratuity (tip). | |
| | | UMshipping | | Portion of above charge amount (UMamount) that is for shipping charges. | | | | UMshipping | | Portion of above charge amount (UMamount) that is for shipping charges. | |
| | + | | UMduty | | Duty charge (Required only for level 3) | |
| | | UMdiscount | | The amount of any discounts that were applied. | | | | UMdiscount | | The amount of any discounts that were applied. | |
| | | UMsubtotal | | The amount of the order before tip, shipping, discount and tax were applied. UMsubtotal+UMtip+UMshipping-UMdiscount+UMtax must equal UMamount. If UMsubtotal is not specified, it will be ignored. | | | | UMsubtotal | | The amount of the order before tip, shipping, discount and tax were applied. UMsubtotal+UMtip+UMshipping-UMdiscount+UMtax must equal UMamount. If UMsubtotal is not specified, it will be ignored. | |
| | | UMcustemail | | Customer's Email Address. | | | | UMcustemail | | Customer's Email Address. | |
| | | UMcustreceipt | | Yes/No. Sends the Customer a Receipt. This overrides the setting for the merchant and source. | | | | UMcustreceipt | | Yes/No. Sends the Customer a Receipt. This overrides the setting for the merchant and source. | |
| | + | | UMcustreceiptname| | Name of the custom receipt template to use. If omitted or if receipt not found, default customer receipt template will be used. | |
| | | UMname | x | Name on card or checking account. | | | | UMname | x | Name on card or checking account. | |
| | | UMstreet | CC | Street Address | | | | UMstreet | CC | Street Address | |
| | | UMdlnum | Checks | Driver's license number. | | | | UMdlnum | Checks | Driver's license number. | |
| | | UMdlstate | Checks | Driver's license state of issue. | | | | UMdlstate | Checks | Driver's license state of issue. | |
| | + | | UMcheckformat | | Record type of electronic check transaction. Not supported by all check processors. List of Check Record Types Also known as SEC code. | |
| | | UMchecknum | Checks | Check number. (optional) | | | | UMchecknum | Checks | Check number. (optional) | |
| | + | | UMcheckimagefront | | JPG image of front side of check. (optional) If data is encoded, encoding must match UMcheckimageencoding. | |
| | + | | UMcheckimageback | | JPG image of back side of check. (optional) If data is encoded, encoding must match UMcheckimageencoding. | |
| | + | |UMcheckimageencoding | | Encoding method used for check images. (Either base64 or raw). Be careful to avoid double encoding the data! Many check scanners output the image files already in base64 format. No additional encoding is required. | |
| | | UMclerk | | Indicates the clerk/person processing transaction, for reporting purposes. (optional) | | | | UMclerk | | Indicates the clerk/person processing transaction, for reporting purposes. (optional) | |
| | | UMtranterm | | Indiactes the terminal used to process transaction, for reporting purposes. (optional) | | | | UMtranterm | | Indiactes the terminal used to process transaction, for reporting purposes. (optional) | |
| | | UMip | | The IP address of the client requesting the transaction. This is used in many of the fraud modules. | | | | UMip | | The IP address of the client requesting the transaction. This is used in many of the fraud modules. | |
| | | UMsoftware | | Allows application developers to stamp their application name and version number onto each transaction. Used to assist customers with trouble shooting. (optional) | | | | UMsoftware | | Allows application developers to stamp their application name and version number onto each transaction. Used to assist customers with trouble shooting. (optional) | |
| - | | UMredir | | Redirects to specific URL after card has been processed. All form fields are passed back along with the processing results. | |
| | | UMredirApproved | | Redirection URL - If the card is approved, redirect to this URL. No fields are passed back. Typically merchants should enable merchant receipts with this option. To enable merchant receipts for a source, see Merchant Email Receipts above. | | | | UMredirApproved | | Redirection URL - If the card is approved, redirect to this URL. No fields are passed back. Typically merchants should enable merchant receipts with this option. To enable merchant receipts for a source, see Merchant Email Receipts above. | |
| | | UMredirDeclined | | Redirection URL - If the card is not approved, redirect to this URL. No fields are passed back. If UMredirApproved is set but UMredirDeclined is not, the gateway will display the template entered in the sources area. This feature overrides the "Declined Template" feature that is available in the Source Key settings screen. If both are set, the declined template will be ignored and the user will be redirect to the UMredirDeclined url. | | | | UMredirDeclined | | Redirection URL - If the card is not approved, redirect to this URL. No fields are passed back. If UMredirApproved is set but UMredirDeclined is not, the gateway will display the template entered in the sources area. This feature overrides the "Declined Template" feature that is available in the Source Key settings screen. If both are set, the declined template will be ignored and the user will be redirect to the UMredirDeclined url. | |
| - | | UMechofields | | Echo input fields in response. If UMechofields is set to yes then all fields included in the form (except for the credit card number, key, expiration and cvc) will be included in the redirection URL as GET variables. This is only useful with the client-side method. For example if you post a form with the field "comments" to the gateway and set UMredir to "http://mysite.com/handler.cgi" then the gateway will redirect to http://mysite.com/handler.cgi?comments=... Please Note: Use of this feature is not recommended for security reasons. These fields will typically be logged in your web server log files. On many hosting companies these log files are world-readable which means that anyone would be able to read the information. | | + | | UMechofields | | Echo input fields in response. If UMechofields is set to all then all fields included in the form (except for the credit card number, key, expiration and cvc) will be included in the redirection URL as GET variables. This is only useful with the client-side method. For example if you post a form with the field "comments" to the gateway and set UMredirApproved to "http://mysite.com/handler.cgi" then the gateway will redirect to http://mysite.com/handler.cgi?comments=... Please Note: Use of this feature is not recommended for security reasons. These fields will typically be logged in your web server log files. On many hosting companies these log files are world-readable which means that anyone would be able to read the information. | |
| | | UMonError | | Instructs the gateway what to do when a decline is received when multiple transactions are being processed (see "Split Payments" above). Can be set to Stop, Continue or Void. Defaults to "Stop" | | | | UMonError | | Instructs the gateway what to do when a decline is received when multiple transactions are being processed (see "Split Payments" above). Can be set to Stop, Continue or Void. Defaults to "Stop" | |
| | | UMtestmode | | If UMtestmode is set to 1 the gateway will simulate a transaction without actually processing the card. All fraud and verification checks are performed. | | | | UMtestmode | | If UMtestmode is set to 1 the gateway will simulate a transaction without actually processing the card. All fraud and verification checks are performed. | |