VaultBoardCredit

VaultBoardCredit

The VaultBoardCredit web method stores the payment information for a credit card into the Merchantware Vault using swiped card data.

Arguments

Name Type Size Description
merchantName string 1-160 The name of the business or organization owning the Merchantware account.
merchantSiteId string 8-160 The site identifier of a location or storefront owned by the Merchantware account owner.
merchantKey string 1-160 The software key or password for the site accessing a Merchantware account.
merchantDefinedToken string 0-40 This value is no longer supported.
trackData string 1-500 The complete track data (all tracks) for the payment card returned from a card reader.
avsStreetAddress string 0-100 The street address associated with the payment card for use in address verification system (AVS) checks.
avsStreetZipCode string 0, 5, or 9 The ZIP Code associated with the payment card for use in address verification system (AVS) checks.

Return Values

A VaultBoardingResponse is returned.

Notes

Data from Track 2 is required for the trackData parameter. However, you may send in the raw swipe, as long as it has not been altered since it was read from the payment card. This method will separate Track 2 data by itself.

The trackData should be unaltered raw swipe data from unencrypted readers or from IDTech, IDTech Enhanced, Magtek encrypted readers.

Merchants defined tokens are no longer supported. If you wish to use this feature please contact the integrations team.

SOAP Information

SOAPAction
http://schemas.merchantwarehouse.com/merchantware/40/Credit/VaultBoardCredit
Sample Request Packet (raw)
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <VaultBoardCredit
     xmlns="http://schemas.merchantwarehouse.com/merchantware/40/Credit/">
      <merchantName>Zero Inc.</merchantName>
      <merchantSiteId>00000000</merchantSiteId>
      <merchantKey>00000-00000-00000-00000-00000</merchantKey>
      <trackData> [magnetic stripe data] </trackData>
      <avsStreetAddress>123 Main Street</avsStreetAddress>
      <avsStreetZipCode>02110</avsStreetZipCode>
    </VaultBoardCredit>
  </soap:Body>
</soap:Envelope>
Sample Return Packet (raw)
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <VaultBoardCreditResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/40/Credit/">
      <VaultBoardCreditResult>
        <ErrorCode></ErrorCode>
        <ErrorMessage></ErrorMessage>
        <VaultToken>CUSTOMER15</VaultToken>
      </SaleResult>
    </SaleResponse>
  </soap:Body>
</soap:Envelope>