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.

Remove Points | Global Payments

Remove Points

The RemovePoints method removes points from a card's point balance, which were added on a previous transaction.

Arguments

Name	Type	Description
Credentials	MerchantCredentials	A MerchantCredentials object used to authenticate against Merchantware.
PaymentData	GiftPaymentData	A PaymentData object containing the payment details of the card used to process the transaction.
Request	RemovePointsRequest	A RemovePoints request object containing the data used to remove points from a card's point balance.

Response

A GiftResponse46 is returned.

Example Remove Points By Currency Amount 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>
        <RemovePoints xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <Credentials>
                <MerchantName>Zero Inc</MerchantName>
                <MerchantSiteId>00000000</MerchantSiteId>
                <MerchantKey>00000-00000-00000-00000-00000</MerchantKey>
            </Credentials>
            <PaymentData>
                <Source>PREVIOUSTRANSACTION</Source>
                <Token>1970177862</Token>
            </PaymentData>
            <Request>
                <AmountType>Currency</AmountType>
                <Amount>3.00</Amount>
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </Request>
        </RemovePoints>
    </soap12:Body>
</soap12:Envelope>

Sample Return 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>
        <RemovePointsResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <RemovePointsResult>
                <ApprovalStatus>APPROVED</ApprovalStatus>
                <CardNumber />
                <ErrorMessage />
                <ExpirationDate />
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <ReaderEntryMode>1</ReaderEntryMode>
                <ResponseMessage>00GMJR</ResponseMessage>
                <Token>1970185732</Token>
                <TransactionDate>01/22/2020 16:39:49</TransactionDate>
                <Loyalty>
                    <PointsBalance>200277.96</PointsBalance>
                </Loyalty>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </RemovePointsResult>
        </RemovePointsResponse>
    </soap12:Body>
</soap12:Envelope>

Example Remove Points By Points Amount 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>
        <RemovePoints xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <Credentials>
                <MerchantName>Zero Inc</MerchantName>
                <MerchantSiteId>00000000</MerchantSiteId>
                <MerchantKey>00000-00000-00000-00000-00000</MerchantKey>
            </Credentials>
            <PaymentData>
                <Source>PREVIOUSTRANSACTION</Source>
                <Token>1319665708</Token>
            </PaymentData>
            <Request>
                <AmountType>Points</AmountType>
                <Amount>300</Amount>
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </Request>
        </RemovePoints>
    </soap12:Body>
</soap12:Envelope>

Sample Return 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>
        <RemovePointsResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <RemovePointsResult>
                <ApprovalStatus>APPROVED</ApprovalStatus>
                <ResponseMessage>928061</ResponseMessage>
                <Token>MC0110</Token>
                <InvoiceNumber>Transaction1000</InvoiceNumber>
                <TransactionDate>10/10/2008 1:13:55 PM</TransactionDate>
                <ExpirationDate>080729</ExpirationDate>
                <CardNumber>***********3456</CardNumber>
                <ReaderEntryMode>1</ReaderEntryMode>
                <Loyalty>
                    <PointsType>Points</PointsType>
                    <ApprovedPoints>300</ApprovedPoints>
                    <PointsBalance>62346</PointsBalance>
                </Loyalty>
            </RemovePointsResult>
        </RemovePointsResponse>
    </soap12:Body>
</soap12:Envelope>

Policies

Connect

Additional Resources

Remove Points

Arguments

Response

Example Remove Points By Currency Amount SOAP Request

Sample Request Packet (raw)

Sample Return Packet (raw)

Example Remove Points By Points Amount SOAP Request

Sample Request Packet (raw)

Sample Return Packet (raw)