Return Funds to a Customer

This code steps you through the process of refunding payments that have been made on settled transactions.

There are three outcomes when processing credit card transactions:

  1. Approved
  2. Declined
  3. Error

Refunds can only be run on 'Approved' transactions that have been settled. 'Declined' transactions cannot be refunded. As a result, in order to test the refund process, you must first pass an odd dollar amount. This will return the transaction with an 'Approved' status. Then, you can test a refund for the transaction.

An error could result from a variety of conditions such as missing data, invalid card numbers, and expiration dates provided in invalid formats.

The following sample code calls a routine from our Code Library.
Download BluePay.cs
Or, download via GitHub

* BluePay C#.NET Sample code.
* This code sample runs a $3.00 Credit Card Sale transaction
* against a customer using test payment information. If
* approved, a 2nd transaction is run to refund the customer
* for $1.75.
* If using TEST mode, odd dollar amounts will return
* an approval and even dollar amounts will return a decline.

using System;
using BluePayLibrary;

namespace Transactions
    class ReturnFunds
        public static void Main()
            string accountID = "Merchant's Account ID Here";
            string secretKey = "Merchant's Secret Key Here";
            string mode = "TEST";
            BluePay payment = new BluePay

                firstName: "Bob",
                lastName: "Tester",
                address1: "123 Test St.",
                address2: "Apt #500",
                city: "Testville",
                state: "IL",
                zip: "54321",
                country: "USA",
                phone: "123-123-12345",
                email: "[email protected]"
                ccNumber: "4111111111111111",
                ccExpiration: "1225",
                cvv2: "123"

            // Sale Amount: $3.00
            payment.Sale(amount: "3.00");

            // Makes the API Request with BluePay

            // If transaction was approved..
            if (payment.IsSuccessfulTransaction())
                BluePay paymentRefund = new BluePay

                // Creates a refund transaction against previous sale
                    masterID: payment.GetTransID(), // id of previous transaction to refund
                    amount: "1.75" // partial refund of $1.75

                // Makes the API Request with BluePay

                // Reads the responses from BluePay
                Console.WriteLine("Transaction Status: " + paymentRefund.GetStatus());
                Console.WriteLine("Transaction ID: " + paymentRefund.GetTransID());
                Console.WriteLine("Transaction Message: " + paymentRefund.GetMessage());
                Console.WriteLine("AVS Response: " + paymentRefund.GetAVS());
                Console.WriteLine("CVV2 Response: " + paymentRefund.GetCVV2());
                Console.WriteLine("Masked Payment Account: " + paymentRefund.GetMaskedPaymentAccount());
                Console.WriteLine("Card Type: " + paymentRefund.GetCardType());
                Console.WriteLine("Authorization Code: " + paymentRefund.GetAuthCode());
                Console.WriteLine("Error: " + payment.GetMessage());
Can’t find what you’re
looking for? We can help.

Contact 800-350-2684 for Integration Support.

  • Microsoft Gold Partner Badge
  • 2018 American Business Awards Gold Stevie® Winner Badge for Best Payment and Electronic Commerce Solution
  • 2018 CNP Awards Customer Choice Winner Badge for Best E-Commerce Platform/Gateway
  • Best in Biz Awards 2018 Silver Winner Badge for Business Development Department of the Year
  • TSG Gateway Awards 2019 BluePay
BluePay Processing, LLC is a registered ISO of Wells Fargo Bank, N.A., Concord, CA, 94524 U.S.A.
BluePay Canada ULC, is a Registered ISO/MSP of Peoples Trust Company, Vancouver, Canada.