developer:transactionapi

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
developer:transactionapi [2012/07/09 09:04]
tem
developer:transactionapi [2014/09/26 13:06] (current)
yura [Split Payments]
Line 383: Line 383:
   * The cardholder sees two or more separate charges with the DBA names of the respective merchants on the statement.   * The cardholder sees two or more separate charges with the DBA names of the respective merchants on the statement.
   * At least 2 MIDs (Merchant IDs) are required, with a source key generated in each account.   * At least 2 MIDs (Merchant IDs) are required, with a source key generated in each account.
 +
 +NOTE: If you set "​UMaddcustomer=yes",​ it will create customer record on both merchant accounts. ​
  
  
Line 493: Line 495:
  
 When a new version of the gateway API is released, the URL will change to keep scripts written on the old version from breaking. The second position (4 in this example) refers to the addition of new fields/​features. These features provide additional functionality and are not mandatory. The third position (1 in this example) indicates bug fixes, when nothing structural has changed within the API. When a new version of the gateway API is released, the URL will change to keep scripts written on the old version from breaking. The second position (4 in this example) refers to the addition of new fields/​features. These features provide additional functionality and are not mandatory. The third position (1 in this example) indicates bug fixes, when nothing structural has changed within the API.
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
  
 ==== CGI Post Variables ==== ==== CGI Post Variables ====
Line 519: Line 511:
 | UMauthCode | CC:PostAuth | Authorization Code obtained "​offline"​ (ie telephone authorization). Only required for Post Auth. | | UMauthCode | CC:PostAuth | Authorization Code obtained "​offline"​ (ie telephone authorization). Only required for Post Auth. |
 | UMrefNum | CC:​Capture,​Void,​Refund,​ CreditVoid | The UMrefNum received when a transaction was authorized via either the "​sale"​ or "​authonly"​ commands. Required for void and capture commands. ​ | | UMrefNum | CC:​Capture,​Void,​Refund,​ CreditVoid | The UMrefNum received when a transaction was authorized via either the "​sale"​ or "​authonly"​ commands. Required for void and capture commands. ​ |
-| UMcard | CC:Sale, CC:​AuthOnly,​ CC:Credit, CC:PostAuth | Credit Card Number with no spaces or dashes. |+| UMcard | CC:Sale, CC:​AuthOnly,​ CC:Credit, CC:PostAuth | Credit Card Number with no spaces or dashes
 +| UMsaveCard ​   |               | If set to true and the transaction has been approved, the system will issue a token for future use. |
 | UMexpir | CC:Sale, CC:​AuthOnly,​ CC:Credit, CC:PostAuth | Expiration Date in the form of MMYY with no spaces or punctuation. | | UMexpir | CC:Sale, CC:​AuthOnly,​ CC:Credit, CC:PostAuth | Expiration Date in the form of MMYY with no spaces or punctuation. |
 | UMrouting | Check:Sale, Check:​Credit | Bank Routing number. Required when UMcommand is set to check or checkcredit. | | UMrouting | Check:Sale, Check:​Credit | Bank Routing number. Required when UMcommand is set to check or checkcredit. |
Line 563: Line 556:
 | 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 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. |
 | 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.  No transaction data is stored when [[testmode]] is enabled. ​ You will not see the transaction on reports or in the batch. Use of [[testmode]] is discouraged for anything more than rudimentary integration testing. For a better simulation of a transaction,​ it is recommended that you use the [[developer:​sandbox|Sandbox]]. | | UMtestmode |     ​  ​  | If UMtestmode is set to 1 the gateway will simulate a transaction without actually processing the card.  No transaction data is stored when [[testmode]] is enabled. ​ You will not see the transaction on reports or in the batch. Use of [[testmode]] is discouraged for anything more than rudimentary integration testing. For a better simulation of a transaction,​ it is recommended that you use the [[developer:​sandbox|Sandbox]]. |
Line 646: Line 639:
 ^ Field ^ Description ^ ^ Field ^ Description ^
 | UMcardpresent ​    | Set UMcardpresent=true to enable card present mode. If UMmagstripe is sent, UMcardpresent will be automatically set to true. | | UMcardpresent ​    | Set UMcardpresent=true to enable card present mode. If UMmagstripe is sent, UMcardpresent will be automatically set to true. |
-| UMmagstripe     | Mag stripe data read from card. Can include Track 1, Track 2 or both. For encrypted track data,  base64 encode the entire block (including masked track data) and then prepend with "enc : / /"​. ​ See [[developer:endtoencryption|end to end encryption]] |+| UMmagstripe     | Mag stripe data read from card. Can include Track 1, Track 2 or both. For encrypted track data,  base64 encode the entire block (including masked track data) and then prepend with "enc : / /"​. ​ See [[http://​wiki.usaepay.com/​developer/​endtoendencryption|End To End Encryption]] |
 | UMdukpt ​          | DUK/PT key for Pin-Debit transactions. The first 16 characters are the encrypted pin block, followed by the 6 character long Key Set Identifier (KSID). ​ The remaining characters are the Pin Pad serial number and transaction counter. ​ | | UMdukpt ​          | DUK/PT key for Pin-Debit transactions. The first 16 characters are the encrypted pin block, followed by the 6 character long Key Set Identifier (KSID). ​ The remaining characters are the Pin Pad serial number and transaction counter. ​ |
 | UMtermtype     | The type of terminal being used: POS (cash register), StandAlone (self service terminal), Unattended (ie gas pump) Unkown (defaults to Unknown) | | UMtermtype     | The type of terminal being used: POS (cash register), StandAlone (self service terminal), Unattended (ie gas pump) Unkown (defaults to Unknown) |
Line 703: Line 696:
 | UMprocRefNum | Transaction Reference number provided by backend processor (platform), blank if not available) | | UMprocRefNum | Transaction Reference number provided by backend processor (platform), blank if not available) |
 | UMcardLevelResult | [[developer:​cardlevelcodes|Card level results]] (for Visa cards only), blank if no results provided| | UMcardLevelResult | [[developer:​cardlevelcodes|Card level results]] (for Visa cards only), blank if no results provided|
 +|UMcardRef |Card reference token. 16-19 digit alphanumeric string. It is returned with dashes but it is not required that these be stored. |
 +|UMcardType |The type of card that was submitted, ie “Visa” |
 +|UMmaskedCardNum |The masked out card number including the last 4 digits |
  
  
developer/transactionapi.1341849874.txt.gz · Last modified: 2012/07/09 09:04 by tem

Page Tools