For AI agents: the complete documentation index is at /llms.txt, and the full text of every page is at /llms-full.txt. Most pages are also available as Markdown by adding .md to the URL.

Find Boarded Card

The FindBoardedCard method retrieves the payment data stored inside the Merchantware Vault.

Arguments

Name	Type	Description
Credentials	MerchantCredentials	A MerchantCredentials object used to authenticate against Merchantware.
Request	VaultTokenRequest	A VaultTokenRequest object used to retrieve information about a boarded card from the vault.

Response

A VaultTokenResponse46 object is returned.

Notes

Any returned sensitive information (such as credit card numbers) will be masked or truncated.
Any value passed into the vault token field is not case sensitive.

Example SOAP Request

Sample Request Packet (raw)

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>
        <FindBoardedCard xmlns="http://schemas.merchantwarehouse.com/merchantware/v46/">
            <Credentials>
                <MerchantName>Zero Inc</MerchantName>
                <MerchantSiteId>00000000</MerchantSiteId>
                <MerchantKey>00000-00000-00000-00000-00000</MerchantKey>
            </Credentials>
            <Request>
                <VaultToken>100000101RT3C3AZNTGX</VaultToken>
            </Request>
        </FindBoardedCard>
    </soap12:Body>
</soap12:Envelope>

Sample Return Packet

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>
        <FindBoardedCardResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/v46/">
            <FindBoardedCardResult>
                <CardNumber>0026</CardNumber>
                <ExpirationDate>1220</ExpirationDate>
                <Cardholder>TEST CARD/GENIUS</Cardholder>
                <CardType>4</CardType>
                <AvsStreetAddress />
                <AvsZipCode />
                <ErrorCode />
                <ErrorMessage />
                <CardBin />
                <Rfmiq>10000003WM</Rfmiq>
            </FindBoardedCardResult>
        </FindBoardedCardResponse>
    </soap12:Body>
</soap12:Envelope>