Loading...
Tokens are a way to work with cards and transactions without actually having the card number. They can allow you to void transactions, repeat a sale, look up info, or save a card for later use. However, there are a few different types of tokens you may encounter. Below is a list of the different kinds of tokens and what you can do with them.
Transaction Reference Number (Transaction Token)
This is the token that is returned with any transaction. You may also see this referred to as the PN Reference Number (PNRef). These tokens open up a range of functionality such as voiding, refunding, and capturing.
Gateway accounts can also be grouped together for Reference Number sharing. This will allow a call from one account to utilize tokens from the other. For instance, if a customer bought something from Store A but went to return them item at Store B, Store B would be able to use the original sale token to run a refund, so long as the two locations were "grouped" with each other. This allows a business to provide a customer with a unified commerce experience between different store locations and any online stores they may have.
To make use of a Reference Number in the MerchantWare 4.6 API, you need to define the Source tag as PREVIOUSTRANSACTION and the Token tag as the Reference Number you want to use inside the PaymentData object of your transaction request.
Example Previous Transaction SOAP Request
The Vault is a way to store a card so it can be later used through the Vault Token generated, unlocking Card on File functionality for a business.
Vault Token Use: Merchantware 4.6
To make use of a Reference Number in the MerchantWare 4.6 API, you need to define the Source tag as VAULT and the Token tag as the Vault Token you want to use inside the PaymentData object of your transaction request.
Below are the calls that use a Vault Token.
| Column 1 | Column 2 |
|---|---|
| Feature | Description |
| UpdateBoardedCard | Updates the expiration date of a card stored in the Vault. |
| Sale | Uses a Vault Token to run a Sale. |
| Refund | Uses a Vault Token to run a Refund. |
| Authorize | Uses a Vault Token to run an Authorization. |
| FindBoardedCard | Returns the card info that is tied to a Vault Token. |
| UnboardCard | Removes a Vault Token and the associated card from the Vault. |
For more information, see the MerchantWare 4.6 documentation.
One Time Use Genius Checkout Token
The Genius Checkout Single Use Token functions a bit differently from the other token types. This token is not tied to a card number or a completed transaction, this token is tied to a transaction that has yet to be run. It is meant to be used only once to run the transaction it was created for, much like a Transport Key, and will expire in two minutes. While the format of a Checkout token will be the same as a Vault token, know that they are separate and will only function as per their actual source.