merchant:epaymentform:tokenization

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 Both sides next revision
merchant:epaymentform:tokenization [2015/02/05 16:33]
yura removed
merchant:epaymentform:tokenization [2015/02/05 16:34]
yura created
Line 1: Line 1:
-====== Tokenization ====== +This page has move to [[merchant:epaymentform:tokenization|http://wiki.usaepay.com/developer/tokenization]]
- +
- +
-The payment form can be used to generate a credit card reference token.  ​This token can then be used in place of a  +
-credit card number when processing a transaction. ​ This is useful when a developer does not want to under take the  +
-security requirements of storing card data.  The tokens can be stored by the developer without needing to meet PCI  +
-requirements for PAN storage.  +
- +
-The gateway implements tokenization using the cc:save command. ​ This command validates the card data and then returns a card reference token (UMcardRef). ​ This card reference number is alpha numeric and can be up to 19 characters in length. ​ The card reference number can be used in the card number (UMcard) field in most scenarios. +
- +
-===== Result Variables ​ ===== +
-The following response variables are specific to the cc:save command.  +
- +
-^ Field ^ Description ^ +
-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 | +
- +
- +
-===== Example Request Form ===== +
- +
-<code html> +
- +
-<​html>​ +
- +
-<​head>​ +
-<​title>​Credit Card Information</​title>​ +
-</​head>​ +
- +
-<body link="#​000080"​ vlink="#​000080"​ alink="#​000080"​ text="#​000000"​ bgcolor="#​D4D7E4">​ +
- +
-<form name="​epayform"​ action="​[UMformURL]"​ method="​POST"​  +
- ​onSubmit="​document.epayform.submitbutton.value='​Please Wait... Processing';"​  +
- ​autocomplete="​off">​ +
-<input type="​hidden"​ name="​UMsubmit"​ value="​1">​ +
-<input type="​hidden"​ name="​UMkey"​ value="​[UMkey]">​ +
-<input type="​hidden"​ name="​UMredirDeclined"​ value="​[UMredirDeclined]">​ +
-<input type="​hidden"​ name="​UMredirApproved"​ value="​[UMredirApproved]">​ +
-<input type="​hidden"​ name="​UMhash"​ value="​[UMhash]">​ +
-<input type="​hidden"​ name="​UMcommand"​ value="​cc:​save">​ +
-<input type="​hidden"​ name="​UMechofields"​ value="​[UMechofields]">​ +
-<input type="​hidden"​ name="​UMformString"​ value="​[UMformString]">​ +
-<div align="​center">​ +
-<table border="​0"​ width="​500"​ cellpadding="​4"​ cellspacing="​0">​ +
-<​tr>​ +
- <td bgcolor="#​C4C7D4"​ width="​500"​ colspan="​2">​ +
- <​b><​font face="​Verdana,​ Arial">​Credit Card Information:</font> </b> +
- <img border="​0"​ src="/​images/​visa.gif" width="​44"​ height="​28"​ hspace="​3">​ +
- <img border="​0"​ src="/​images/​mastercard.gif" width="​44"​ height="​28"​ hspace="​3">​ +
- <img border="​0"​ src="/images/​amex.gif"​ width="​44"​ height="​28"​ hspace="​3">​ +
- <img border="​0"​ src="/​images/​discover.gif"​ width="​44"​ height="​28"​ hspace="​3">​ +
- </​td>​ +
-</​tr>​ +
-<​tr>​ +
- <td bgcolor="#​F0F0F0"​ width="​234"​ align="​right">​ +
- <font face="​Verdana"​ size="​2">​Card Number:</​font>​ +
- </​td>​ +
- <td bgcolor="#​F0F0F0"​ width="​266">​ +
- <input type="​text"​ name="​UMcard"​ size="​19">​ +
- </​td>​ +
-</​tr>​ +
-<​tr>​ +
- <td bgcolor="#​F0F0F0"​ width="​234"​ align="​right">​ +
- <font face="​Verdana"​ size="​2">​Card Expiration Date: </​font>​ +
- </​td>​ +
- <td bgcolor="#​F0F0F0"​ width="​266">​ +
- <input type="​text"​ name="​UMexpir"​ size="​4">​ MMYY +
- </​td>​ +
-</​tr>​ +
-<​tr>​ +
- <td bgcolor="#​F0F0F0"​ width="​234"​ align="​right">​ +
- <font face="​Verdana"><​font size="​2">​Card ID (CVV2/CID) Number:<​br>​ &​nbsp;</​font>​ +
- <font size="​1">​[<​a target="​_blank"​ href="/​cvv.htm">​What is the Card  +
- ID?</​a>​]</​font></​font>​ +
- </​td>​ +
- <td bgcolor="#​F0F0F0"​ width="​266">​ +
- <​input type="​text"​ name="​UMcvv2"​ size="​5">​ +
- </​td>​ +
-</​tr>​ +
-<​tr>​ +
- <td bgcolor="#​F0F0F0"​ width="​500"​ colspan="​2"​ align="​center">​ +
- <input type="​submit"​ name="​submitbutton"​ value="​Store Card">​ +
- </​td>​ +
-</​tr>​ +
-</​table>​ +
-</​div>​ +
-</​form>​ +
-</​body>​ +
-</​html>​ +
- +
-</​code>​ +
- +
-===== Example Response Form ===== +
- +
-Typically a developer ​will want to redirect the user back to their own site and store the UMcardRef variable for later. ​ The following form can also be used if your app is going to scrape the html response page. +
- +
-<code html> +
-<​html>​ +
- +
-<​head>​ +
-<​title>​ Result </title> +
-</​head>​ +
- +
-<body link="#​000080"​ vlink="#​000080"​ alink="#​000080"​ text="#​000000"​ bgcolor="#​D4D7E4">​ +
- +
-<div align="​center">​ +
- <table border="​0"​ width="​500"​ cellpadding="​4"​ cellspacing="​0">​ +
- +
- <​tr>​ +
- <td bgcolor="#​C4C7D4"​ width="​500"​ colspan="​2">​ +
- <font face="​Verdana,​ Arial">​ +
- <p align="​center">​ +
- [ifApproved] +
- <​center><​font size=4><​b>​Card Data Stored</​b></​font></​center><​br>​ +
- Thank you, your card data has been stored.<​br><​br>​ +
- <​table>​ +
- <​tr><​td><​b>​Card Ref: </​b></​td><​td>​[UMcardRef]</​td></​tr>​ +
- <​tr><​td><​b>​Card #: </​b></​td><​td>​[UMmaskedCardNum] ​ ([UMcardType])</​td></​tr>​ +
- </​table>​ +
- <​br><​br>​ +
- [/​ifApproved] +
- [ifDeclined] +
- <​center><​font size=4><​b>​Card Declined</​b></​font></​center>​ +
- The bank has declined your card.  Please check your information and try again. +
- <​br><​br>​ +
- [/​ifDeclined] +
- [ifError] +
- <​center><​font size=4><​b>​Unable to Store Card Data</​b></​font></​center><​br>​ +
- <​font size=3>​The system was unable to process your request: <b> "​[UMerror]"</​b>​.  +
- Please use your browser back button and try again or contact the merchant for assistance. +
- [/​ifError] +
- <​br><​br><​br>​ +
- </​p>​ +
- </​td>​ +
- </​tr>​ +
- </​table>​ +
-</​div>​ +
-</​body>​ +
-</​html>​  +
-</​code>​ +
merchant/epaymentform/tokenization.txt · Last modified: 2015/02/05 16:35 by yura

Page Tools