How to use Vault functions

You are here

2 posts / 0 new
Last post
dwooden
How to use Vault functions
Hi: The provided samples show how to authorize and capture, but they do not show how to create and use a token. We need to be able to use customer credit cards repeatedly, and do not intend to store them locally. How do we use the Vault?    
SDKSupport
How to use vault functions

That's a great question. Vault Operation is what the SED uses to capture and store sensitive cardholder data. In the response, from a create request, you will receive a GUID which will represent the cardholder data. You’ll use this GUID in future transactions in place of this data. Vault Operations is covered in page 34 of the SED 2.0 XML Messaging pdf document. Also, you will find an example of a GUID being used with a transaction on page 23 of the same pdf document. Also, I've included some details below that may help.

A basic "Vault Only" (ie, tokenization sans any actual charge) request will look something like this:

 

<Request_v1 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <Application>

    <ApplicationID>DEMO</ApplicationID>

    <LanguageID>EN</LanguageID>

  </Application>

  <VaultOperation>

    <Merchant>

      <MerchantID></MerchantID>

      <MerchantKey></MerchantKey>

    </Merchant>

    <VaultStorage>

      <Service>CREATE</Service>

    </VaultStorage>

  </VaultOperation>

</Request_v1>

 

This'll collect the credit card (or ACH) data and return the resultant token back to you. The VaultStorage.Service element takes standard CRUD values so, if you wanted to update an existing token, for example, you'd change it to --

 

<VaultStorage>

      <Service>UPDATE</Service>

      <GUID></GUID>

</VaultStorage>

 

-- where GUID is the existing token to reference.

 

You can also add that same VaultStorage element to a payment request (PaymentType element) -- you might want to add a "CREATE" operation to charge a card and tokenize it for subsequent payments, for instance. Or, if you have a token and want to save your user some typing, you could do a "READ".

Log in or register to post comments