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.

Add Points | Global Payments

Add Points

The AddPoints method adds points to a card's point balance.

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	AddPointsRequest	An Add Points Request object containing the data used to add points to a card's point balance.

Response

A GiftResponse46 is returned.

Example Reader Add 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>
        <AddPoints 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>READER</Source>            
                <TrackData>;6033590009112245098=64120000000000000?</TrackData>
            </PaymentData>
            <Request>
                <AmountType>Currency</AmountType>
                <Amount>3.00</Amount>
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </Request>
        </AddPoints>
    </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>
        <AddPointsResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <AddPointsResult>
                <ApprovalStatus>APPROVED</ApprovalStatus>
                <CardNumber>***************5098</CardNumber>
                <ErrorMessage />
                <ExpirationDate>1264</ExpirationDate>
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <ReaderEntryMode>2</ReaderEntryMode>
                <ResponseMessage>00GMJM</ResponseMessage>
                <Token>1970135177</Token>
                <TransactionDate>01/22/2020 15:45:53</TransactionDate>
                <Loyalty>
                    <PointsType>POINTS</PointsType>
                    <ApprovedPoints>3</ApprovedPoints>
                    <PointsBalance>3003</PointsBalance>
                </Loyalty>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </AddPointsResult>
        </AddPointsResponse>
    </soap12:Body>
</soap12:Envelope>

Example Keyed Add 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>
        <AddPoints 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>KEYED</Source>          
                <CardNumber>6033590009112245098</CardNumber>
            </PaymentData>
            <Request>
                <AmountType>Currency</AmountType>
                <Amount>3.00</Amount>
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </Request>
        </AddPoints>
    </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>
        <AddPointsResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <AddPointsResult>
                <ApprovalStatus>APPROVED</ApprovalStatus>
                <CardNumber>***************5098</CardNumber>
                <ErrorMessage />
                <ExpirationDate />
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <ReaderEntryMode>1</ReaderEntryMode>
                <ResponseMessage>00GMJN</ResponseMessage>
                <Token>1970138323</Token>
                <TransactionDate>01/22/2020 15:49:51</TransactionDate>
                <Loyalty>
                    <PointsType>POINTS</PointsType>
                    <ApprovedPoints>3</ApprovedPoints>
                    <PointsBalance>3006</PointsBalance>
                </Loyalty>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </AddPointsResult>
        </AddPointsResponse>
    </soap12:Body>
</soap12:Envelope>

Example Reader Add 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>
        <AddPoints 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>READER</Source>            
                <TrackData>;6033590009112245098=64120000000000000?</TrackData>
            </PaymentData>
            <Request>
                <AmountType>Points</AmountType>
                <Amount>300</Amount>
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </Request>
        </AddPoints>
    </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>
        <AddPointsResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <AddPointsResult>
                <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>***********5098</CardNumber>
                <ReaderEntryMode>1</ReaderEntryMode>
                <Loyalty>
                    <PointsType>POINTS</PointsType>
                    <ApprovedPoints>300</ApprovedPoints>
                    <PointsBeforeNextReward>200</PointsBeforeNextReward>
                    <PointsBalance>300</PointsBalance>
                </Loyalty>
            </AddPointsResult>
        </AddPointsResponse>
    </soap12:Body>
</soap12:Envelope>

Example Keyed Add 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>
        <AddPoints 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>KEYED</Source>          
                <CardNumber>6033590009112245098</CardNumber>
            </PaymentData>
            <Request>
                <AmountType>Points</AmountType>
                <Amount>300</Amount>
                <InvoiceNumber>GIFT123</InvoiceNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CustomerEmailAddress>na@yahoo.com</CustomerEmailAddress>
            </Request>
        </AddPoints>
    </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>
        <AddPointsResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/46/Giftcard">
            <AddPointsResult>
                <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>***********5098</CardNumber>
                <ReaderEntryMode>1</ReaderEntryMode>
                <Loyalty>
                    <PointsType>POINTS</PointsType>
                    <ApprovedPoints>300</ApprovedPoints>
                    <PointsBeforeNextReward>200</PointsBeforeNextReward>
                    <PointsBalance>300</PointsBalance>
                </Loyalty>
            </AddPointsResult>
        </AddPointsResponse>
    </soap12:Body>
</soap12:Envelope>

Policies

Connect

Additional Resources

Add Points

Arguments

Response

Example Reader Add Points By Currency Amount SOAP Request

Sample Request Packet (raw)

Sample Return Packet (raw)

Example Keyed Add Points By Currency Amount SOAP Request

Sample Request Packet (raw)

Sample Return Packet (raw)

Example Reader Add Points By Points Amount SOAP Request

Sample Request Packet (raw)

Sample Return Packet (raw)

Example Keyed Add Points By Points Amount SOAP Request

Sample Request Packet (raw)

Sample Return Packet (raw)