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.

Update Boarded Card

The UpdateBoardedCard method changes the expiration date and address for an existing payment method stored inside the Merchantware Vault.

Arguments

Name	Type	Description
Credentials	MerchantCredentials	A MerchantCredentials object used to authenticate against Merchantware.
Request	UpdateBoardedCardRequest	An UpdateBoardedCardRequest object used to update a token from the vault.

Response

A VaultBoardingResponse46 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.
Include only the parameters you need to update, for example, to update a card’s expiry date, send only the vault token and expiration date parameters. Do not send empty strings in the request.

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>
        <UpdateBoardedCard 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>
                <ExpirationDate>0925</ExpirationDate>
                <AvsStreetAddress>1 Federal Street</AvsStreetAddress>
                <AvsZipCode>02110</AvsZipCode>
            </Request>
        </UpdateBoardedCard>
    </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>
        <UpdateBoardedCardResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/v46/">
            <UpdateBoardedCardResult>
                <VaultToken>100000101RT3C3AZNTGX</VaultToken>
                <ErrorCode />
                <ErrorMessage />
            </UpdateBoardedCardResult>
        </UpdateBoardedCardResponse>
    </soap12:Body>
</soap12:Envelope>

Update Boarded Card | Global Payments