runQuickCredit

Parent Previous Next

runQuickCredit

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

 

Description

This method allows you to run a new transaction using stored customer data. Simply pass the reference number (RefNum) of a previous transaction and the gateway will automatically transfer the credit card 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 runQuickCredit ( ueSecurityToken Token, integer RefNum, TransactionDetail Details )

 

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.

 

Return Value

TransactionResponse

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

 

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->runQuickCredit($token,$refnum, $details));

}

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 credit on

 BigInteger RefNum = new BigInteger("123456789");

 //populate transaction details

 TransactionDetail details = new TransactionDetail();

   details.setAmount(22.34);

   details.setDescription("QuickCredit");

   details.setInvoice("119891");

 // Create response object

 TransactionResponse response;

 response = client.runQuickCredit(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

       refnum = "46990787"

       details.Amount = "1.00"

       details.AmountSpecified = True

       details.Description = "Example QuickCredit"

       details.Invoice = "123456"

       Dim response As eBizCharge.TransactionResponse

       response = client.runQuickCredit(token, refnum, details)

       If response.ResultCode = "A" Then

           MsgBox("Transaction Approved, Reference 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;

           refnum = "46973415";

           details.Amount = 34.50;

           details.AmountSpecified = true;

           details.Description = "Example QuickCredit";

           details.Invoice = "123456";

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

           try

           {

               response = client.runQuickCredit(token, refnum, details);

               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:runQuickCredit>

<Token xsi:type="ns1:ueSecurityToken">

<ClientIP xsi:type="xsd:string">192.168.0.1</ClientIP>

<PinHash xsi:type="ns1:ueHash">

<HashValue xsi:type="xsd:string">11ac55b0a0b59f8f028dbf85bc32266fa973dd0e</HashValue>

<Seed xsi:type="xsd:string">12678150211876663375</Seed>

<Type xsi:type="xsd:string">sha1</Type>

</PinHash>

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

</Token>

<RefNum xsi:type="xsd:integer">1118268</RefNum>

<Details xsi:type="ns1:TransactionDetail">

<Amount xsi:type="xsd:double">29</Amount>

<Clerk xsi:type="xsd:string">John Doe</Clerk>

<Currency xsi:type="xsd:integer">0</Currency>

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

<Discount xsi:type="xsd:double">1</Discount>

<Invoice xsi:type="xsd:string">44539</Invoice>

<OrderID xsi:type="xsd:string">12345</OrderID>

<PONum xsi:type="xsd:string">54321</PONum>

<Shipping xsi:type="xsd:double">2</Shipping>

<Subtotal xsi:type="xsd:double">16</Subtotal>

<Table xsi:type="xsd:string">1</Table>

<Tax xsi:type="xsd:double">4</Tax>

<Terminal xsi:type="xsd:string">15</Terminal>

<Tip xsi:type="xsd:double">8</Tip>

</Details>

</ns1:runQuickCredit>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>