developer:soap-1.1:methods:getbatchuploadstatus

getBatchUploadStatus

Retrieve the status of a currently running batch.

Description

This method allows you to retrieve the status of a currently running batch.

This method is useful in determining whether a batch has been submitted to the gateway for processing, has been paused or is waiting to be uploaded.

To retrieve the status of batches other than the currently running batch, use the getBatchStatus method.

See also pauseBatchUpload, runBatchUpload, createBatchUpload, getBatchStatus

Syntax

BatchUploadStatus getBatchUploadStatus ( ueSecurityToken Token, integer BatchNum )

Arguments

Type Name Description
ueSecurityToken Token Merchant security token: used to identify merchant and validate transaction.
integer BatchNum A unique batch reference number assigned by the gateway.

Return Value

BatchUploadStatus Returns the status of the currently running batch. Possible results include: open, closing, closed.

Examples

PHP

For directions on how to set up the WSDL link, create “$token” and “$client”, go to PHP Soap How-to.

<?php 
 
try { 
 
  $batchnum='127'; 
  print_r($tran->getBatchUploadStatus($sourcekey,$batchnum)); 
 
  } 
 
catch(SoapFault $e) { 
 
  echo $e->getMessage(); 
  echo "\n\nRequest: " . $tran->__getLastRequest(); 
  echo "\n\nResponse: " . $tran->__getLastResponse(); 
 
} 
 
?> 

.NET VB

Dim uploadrefnum As String
        uploadrefnum = "1169"
        Dim res As usaepay.BatchUploadStatus = New usaepay.BatchUploadStatus
        res = client.getBatchUploadStatus(token, uploadrefnum)
        MsgBox(res.Status)

.NET C#

string uploadrefnum = "1169";
 
            usaepay.BatchUploadStatus res = new usaepay.BatchUploadStatus();
 
            try
            {
                res = client.getBatchUploadStatus(token, uploadrefnum);
                MessageBox.Show(string.Concat(res.Status));
            }
 
            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:usaepay" 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:getBatchUploadStatus> 
<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">783e31c06e100aba1c56e6f9a114991e7152058e</HashValue> 
<Seed xsi:type="xsd:string">11937773911544188845</Seed> 
<Type xsi:type="xsd:string">sha1</Type> 
</PinHash> 
<SourceKey xsi:type="xsd:string">HB4P7C4K2w2ZCQQQXRqrxDj6agrS2NIT</SourceKey> 
</Token> 
<BatchNum xsi:type="xsd:integer">288</BatchNum> 
</ns1:getBatchUploadStatus> 
</SOAP-ENV:Body> 
</SOAP-ENV:Envelope> 
developer/soap-1.1/methods/getbatchuploadstatus.txt · Last modified: 2010/10/21 16:40 by irina

Page Tools