runQuickSale

Run a sale based on the credit card details of a previous transaction.

Description

This method allows you to run a new transaction using the payment data from a previous transaction. Simply pass the reference number ($RefNum) of the previous transaction and the gateway will automatically transfer the credit card or electronic check (ACH) information for use in the new transaction. Some credit card information, such as the card code and magnetic strip cannot be stored. This may cause the new transaction to come in at a higher rate than the original.

Syntax

TransactionResponse runQuickSale ( ueSecurityToken Token, integer RefNum, TransactionDetail Details, boolean AuthOnly )

Arguments

Type	Name	Description
ueSecurityToken	Token	Merchant security token: used to identify merchant and validate transaction.
integer	RefNum	Unique transaction reference number assigned by the gateway.
TransactionDetail	Details	Request transaction details, including transaction amount, invoice number, customer ID, PO number, and other transaction specific data.
boolean	AuthOnly	If true, the transaction will be authorized, but not be submitted for settlement.

Return Value

|TransactionResponse |Returns a TransactionResponse object containing the results of the transaction and all relevant data.|

Exceptions

The following exceptions (errors) are applicable to this method.

Code	Message	Advice
20002	Invalid Security Token.	Supplied security token is invalid.
10105	Unable to find original transaction.	The specified transaction RefNum did not match a eligible transaction or the transaction belongs to a different merchant.
10136	Original transaction not approved.	QuickSale only allowed for transactions that were approved

Examples

PHP

<?php

try {

$refnum=1009411;

$details=array(

"Amount"=>4.00,

"Invoice"=>1234,

"Description"=>"Test Transaction",

"PONum"=>"",

"OrderID"=>1234,

"Tax"=>0,

"Tip"=>0,

"NonTax"=>false,

"Shipping"=>0,

"Discount"=>0,

"Subtotal"=>4.00

);

print_r($client->runQuickSale($token,$refnum, $details, true));

}

catch(SoapFault $e) {

echo $e->getMessage();

echo "\n\nRequest: " . $client->__getLastRequest();

echo "\n\nResponse: " . $client->__getLastResponse();

}

Java

try {

//Set RefNum to the transaction refference number

//you want to run a quick sale on

BigInteger RefNum = new BigInteger("123456789");

//populate transaction details

TransactionDetail details = new TransactionDetail();

details.setAmount(22.34);

details.setDescription("QuickSale");

details.setInvoice("119891");

// Create response object

TransactionResponse response;

response = client.runQuickSale(token, RefNum, details, false);

System.out.println("Response: " + response.getResult());

System.out.println("RefNum: " + response.getRefNum());

} catch (Exception e) {

System.out.println("Soap Exception: " + e.getMessage());

}

VB

Dim client As eBizCharge.eBizChargeService = New eBizCharge.eBizChargeService

Dim token As eBizCharge.ueSecurityToken

token = Me.CreateToken("714SSUxv1uohng2XkMJ7kLpETsu58G66", "1234")

Dim refnum As Integer

Dim details As eBizCharge.TransactionDetail = New eBizCharge.TransactionDetail

Dim authonly As Boolean

refnum = "46990567"

details.Amount = "34.50"

details.AmountSpecified = True

details.Description = "Example QuickSale"

details.Invoice = "123456"

authonly = False

Dim response As eBizCharge.TransactionResponse

response = client.runQuickSale(token, refnum, details, authonly)

If response.ResultCode = "A" Then

MsgBox("Transaction Approved, Refernce Number: " & response.RefNum)

ElseIf response.ResultCode = "D" Then

MsgBox("Transaction Declined, Reason: " & response.Error)

Else

MsgBox("Transaction Error, Reason: " & response.Error)

End If

.NET C#

eBizCharge.TransactionDetail details = new eBizCharge.TransactionDetail();

string refnum;

bool authonly;

refnum = "46973415";

authonly = false;

details.Amount = 34.50;

details.AmountSpecified = true;

details.Description = "Example QuickSale";

details.Invoice = "123456";

eBizCharge.TransactionResponse response = new eBizCharge.TransactionResponse();

try

{

response = client.runQuickSale(token, refnum, details, authonly);

if (response.ResultCode == "A")

{

MessageBox.Show(string.Concat("Transaction Approved, RefNum: ",

response.RefNum));

}

else

{

MessageBox.Show(string.Concat("Transaction Failed: ",

response.Error));

}

catch (Exception err)

{

MessageBox.Show(err.Message);

}

XML

<?xml version="1.0" encoding="UTF-8"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:ns1="urn:eBizCharge" xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"

SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<SOAP-ENV:Body>

<ns1:runQuickSale>

</PinHash>

<SourceKey xsi:type="xsd:string">HB4P7C4K2w2ZCQQQXRqrxDj6agrS2NIT</SourceKey>

</Token>

<Description xsi:type="xsd:string">Example Transaction</Description>

</Details>

<AuthOnly xsi:type="xsd:boolean">false</AuthOnly>

</ns1:runQuickSale>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>