You are on page 1of 129

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Web Services API


Implementation Guide
API Version 2.3.3
April, 2009

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

API and Document Changes History


April 3, 2009.
API Version: 2.3.3
Document Version: 1.7
Changes:
Expanded Product class with information pertinent to Top Up products:
<TargetCountry>, <CountryCode>, <TopUpMinAmount>,
<TopUpMaxAmount>.
The method GetProductsCatalog now returns both Top Up and PIN based
products.

February 24, 2009.


API Version: 2.3.2
Document Version: 1.6
Changes:
Added three new web methods to the API for performing processing of
Blackstone Pinless recharge, void, balance request, add phone and delete
phone.

December 08, 2008.


API Version: 2.2.1
Document Version: 1.5
Changes:
Added a new web method to the API for performing a PIN request returning a
lighted out response.
Added new section to document describing new web method:
GetMultiplePINLite.
Added SOAP request and responses, and Test Execution response for new
GetMultiplePINLite method.
Blackstones Web Service is now called Pinserves Web Service.

November 18, 2008.


API Version: 2.2.0
Document Version: 1.4
Changes:
Added a new web method to the API for performing a Void to a PIN request
based on clients own OrderID.
Added new section to document describing new web method: VoidOrder.

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Added SOAP request and responses, and Test Execution response for new
VoidOrder method.

October 30, 2008.


API Version: 2.1.1
Document Version: 1.3
Changes:
Added tag <ToppedUpNumber/> to PIN class SOAP response when
DoTopUp method is called.
Minor updates to this document.

October 1, 2008.
API Version: 2.1.0
Document Version: 1.2
Changes:
Added a new web method to the API for performing a Top-Up transaction.
Added new section to document describing new web method: DoTopUp.
Added SOAP request and responses, and Test Execution response for new
DoTopUp method.
Added table with Country Codes, required top-up transactions, as Appendix
E.

July 24, 2008.


API Version: 2.0.2
Document Version: 1.1
Changes:
Added two new tags to PIN class in the SOAP response after calling methods
GetSinglePIN and GetMultiplePIN:
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
Added new SOAP responses and Test Execution response to document, which
include above tags.
Added table with Error Codes as Appendix D.

March 27, 2008.


API Version: 2.0.1
Document Version: 1.0
Changes:
None, initial versions

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Introduction to Web Services


The term Web services describes a standardized way of integrating Web-based
applications over the Web. Web services enable businesses to communicate with each
other and with other clients, without intimate knowledge of each others IT systems
behind a firewall. Web services share business logic, data and processes through a Web
Services API. Application developers can then add the Web Services to an interface
(such as a Web page or executable program) to offer specific functionality to users.
The Web Services core technologies include:
Extensible Markup Language (XML): Language that defines the structure and
content of Web Services.
Web Services Description Language (WSDL): XML-formatted language that is
used to describe the Web Services capabilities, thereby allowing applications to
communicate effectively. The WSDL file is an XML file that defines the objects
and methods.
Simple Object Access Protocol (SOAP): XML-based protocol used to send Web
Services messages. Web services messages are sent between the customer
implementation of Web Services and the SOAP handler on Blackstone Web
servers.
Web Services give developers the ability to utilize four open Web standards:
HTTP - Hypertext Transfer Protocol
The standard protocol used over Port 80, which traverses firewalls, and is
responsible for requesting and transmitting data over the Internet.
SOAP - Simple Object Access Protocol
An XML-inherent protocol that encloses a set of rules for data description and
process. As a standard, this is the center-piece that complements the other three
standards mentioned here.
XML - Extensible Markup Language
The most common markup language in which all this information is written.
WSDL - Web Services Description Language
An XML-based method used to identify Web Services and their access at runtime.
.NET provides a tool called WSDL.exe, which essentially makes it quite easy to
generate an XML Web service as an XML file. This contains all the methods and
instructions the Web Service has, and typically uses SOAP as its default.

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

This guide assumes that you are familiar with common .NET data access, Web server
controls, and some object-oriented programming concepts.
For more information on Web Services technologies and the Microsoft Platform, visit
http://msdn2.microsoft.com/en-us/library/aa480728.aspx

Web Services Instructional Resources


The following are some useful resources available on the Internet regarding Web
Services:
Web Services and Other Distributed Technologies:
http://msdn2.microsoft.com/en-us/webservices/default.aspx
Web Services Primer:
http://webservices.xml.com/ pub/a/ws/2001/04/04/webservices/
SOAP Specification:
http://www.w3.org/TR/soap
WSDL Specification:
http://www.w3.org/TR/wsdl
XML Schema Specification (XSD):
http://www.w3.org/TR/xmlsch ema-2

Pinserve Web Service API


Pinserve Web Services API comprises and exposes several methods, and accessing to
them is only allowed to registered merchants.

Authentication
In order to gain access and use the Web Service API you must apply and obtain a special
Pinserves Touch-n-Buy Merchant Account. Please contact our sales department for
details.
Once you have an active Touch-n-Buy Merchant Account, youll be provided with a
Merchant ID (MID), a Terminal ID (TID) and a Password. These three elements of
identification are required by the Web Service API to allow you having access to its
methods. Along with those three elements, youll also need to provide the IP address(es)
your Terminal will use for accessing. Any unrecognized IP address will simply be
rejected.

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Consuming the Web Service


The consumption of the Web Service methods will be demonstrated with a simple
ASP.NET website example in Visual Studio 2005. Please refer to the documentation of
VS2005 or your own development environment for explanations on how to do it.
Create a Web Project in Visual Studio 2005, and then create a web reference to:
https://services.blackstoneonline.com/transactionbroker/broker.asmx

Fig. 1: Creation of a Web Reference in Visual Studio 2005

It will be added to your solution:

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Fig. 2: Web Reference added to the Solution


Add a new Class (Class1.vb) and add a public function:
Imports Microsoft.VisualBasic
Imports TransactionBroker.Broker
Public Class Class1
Public Function GetLegalDisclaimer() As String
Dim objBroker As TransactionBroker.Broker
Dim objLegal As TransactionBroker.Legal
objBroker = New TransactionBroker.Broker
objLegal = objBroker.GetLegalInformation("123", _
"1000123", "1234", "1234", 0, "T")
Return objLegal.Disclaimer
End Function
End Class

Add a new Webform (test.aspx), and then add a Label web control to it:
<%@ Page Language="VB" AutoEventWireup="false"
CodeFile="test.aspx.vb" Inherits="test" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<form id="form1" runat="server">


<div>
<asp:Label ID="Label1" runat="server"
Text="Label"></asp:Label></div>
</form>
</body>
</html>

Open the Code view and add the call to the Web Service method:
Partial Class test
Inherits System.Web.UI.Page
Dim cls As Class1
Protected Sub Page_Load(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Me.Load
If Not Page.IsPostBack Then
cls = New Class1
Me.Label1.Text = cls.GetLegalDisclaimer.ToString
End If
End Sub
End Class

After running this example youll get the next result:

Fig. 3: Result of running example

Copyright 2008 Pinserve Technologies

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Methods and Classes


The Web Service comprises several public methods and classes. There are two modes of
operation for these methods, which are L for Live transactions and T for Test
transactions.
Any call to a method with TransactionMode = T will go through without checking the
validity of three of the four authentication elements: MID, TID and Password. The IP
address is always checked in the background for validation. If you request a PIN in this
mode, it will return a dummy PIN that will not be billed to your account.
However, every call made in TransactionMode = L will be correctly validated and, in
case you request a PIN, it will be valid and will be billed to your account.
The parameters that are common for most of the methods are the following:
MID: It is the Merchant ID assigned by Pinserve to your account.
TID: It is the Terminal ID assigned by Pinserve to your account.
Password: Its a string originally generated by Pinserve on accounts creation. It
can be changed later by the merchants in their Virtual Office.
Cashier: This is a numeric string of maximum length of 4 digits that you can
freely use to identify any possible entity on your side thats initiating the
transaction. Use 0 if none.
TransactionMode: Use L for Live mode or T for Test mode.
ProfileID: Integer value that identifies the Profile. Use 0 or 15 for Generic
Profile.

Profiles, Products, Rates and Disclaimers


All the products Pinserve sells through this service have been arranged in Profiles,
depending of several factors, like geographic region, usage restriction, etc.
Although there are products that are available across all the Profiles, there are others that
are not, and in that way youll have to program your system to be aware of and manage
these restrictions. For example, the regional product Blackstone FL is available in every
profile created for Florida, but is not available in any other states profiles. However,
Blackstone #1 card is available in all profiles, because this is a nationwide product.

GetProductProfiles
Gets all available Profiles.
Parameter

Copyright 2008 Pinserve Technologies

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

Document Version 1.7

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

GetProductsCatalog
Gets all products available for the given ProfileID.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

ProfileID:

Numeric

TransactionMode:

String: L (Live) or T (Test)

GetAllDestinations
Gets the list of all destinations shown in rate decks.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

GetProductAccessPhones
Gets an Array of Access Phone numbers for given Product Code.
Parameter

Copyright 2008 Pinserve Technologies

Value

MID:

Numeric

TID:

Numeric

Document Version 1.7

10

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

ProductMaincode:

Numeric: Fixed Length = 6

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

GetLegalInformation
Gets version legal and privacy information, term and conditions.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

PIN Requests and Voids


Along with the common parameters previously explained, these methods require others
parameters:
ProductMaincode: Unique identification for a product line. Example: 300549 for
BLACKSTONE #1.
ProductDenomination: The dollar value of the PIN being requested. Use only
clean numeric values without any currency sign or commas. Example: 5 or 5.00
QtyPINs: The total number of PINs of the same product youre requesting in the
transaction. Use QtyPINs >= 1
OrderID: Numeric value that represents your own systems order identification
number. Use 0 for none.
ProfileID: Integer value that identifies the Profile. Use 0 or 15 for Generic
Profile.
TransactionID: Unique numeric identification value returned in PIN request
transactions.
The methods for requesting PINs return different responses depending of the number of
PINs requested.

Copyright 2008 Pinserve Technologies

Document Version 1.7

11

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

GetSinglePIN
Gets a single new PIN.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

ProductMaincode:

Numeric: Fixed Length = 6

ProductDenomination:

Currency

OrderID:

Numeric

ProfileID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

GetMultiplePIN
Gets an Array of new PINs.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

ProductMaincode:

Numeric: Fixed Length = 6

ProductDenomination:

Currency

QtyPINs:

Numeric (Min: 1, Max: 5)

OrderID:

Numeric

Copyright 2008 Pinserve Technologies

Document Version 1.7

12

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

ProfileID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

GetMultiplePINLite
Gets an Array of new PINs with a stripped out response, where any extra
information but PINs basic information is omitted.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

ProductMaincode:

Numeric: Fixed Length = 6

ProductDenomination:

Currency

QtyPINs:

Numeric (Min: 1, Max: 5)

OrderID:

Numeric

ProfileID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

In case you need to void a PIN request transaction, you can do it by calling the following
method. Please note the parameter TransactionID, which represents the value returned
together with the PINs information, in any of the two PIN request methods, is required or
otherwise the transaction will not be voided.

VoidTransaction
Voids a recent transaction based on returned Transaction ID.
Parameter

Copyright 2008 Pinserve Technologies

Value

MID:

Numeric

TID:

Numeric

Document Version 1.7

13

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

TransactionID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
You can also void a PIN request transaction using your own unique Order ID. Please note
the parameter OrderID, which represents the value passed in to the PIN request, in any of
the two PIN request methods, is required or otherwise the transaction will not be voided.

VoidOrder
Voids a recent transaction based on clients own OrderID passed in.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

OrderID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

Top Up Requests and Voids


Along with the common parameters previously explained, these methods require others
parameters:
ProductMaincode: Unique identification for a product line. Example: 320023 for
Boost RTR.
TopUpAmount: The dollar value of the top up being requested. Use only clean
numeric values without any currency sign or commas. Example: 5 or 5.00
PhoneNumber: The number of the mobile subscriber the top is being loaded to.
CountryCode: A two-letter code that identifies the country where the mobile
subscriber resides and/or the top-up product is intended to be used at. Please refer
to Appendix E for the list of countries and codes. For US based products use
CountryCode = US

Copyright 2008 Pinserve Technologies

Document Version 1.7

14

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

OrderID: Numeric value that represents your own systems order identification
number. Use 0 for none.
ProfileID: Integer value that identifies the Profile. Use 0 or 15 for Generic
Profile.
TransactionID: Unique numeric identification value returned in PIN request
transactions.

The method for requesting top-up returns a response of class type PIN, which may
include many empty fields not needed in top-up transactions.

DoTopUp
Performs a Top Up to mobile subscriber.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

ProductMaincode:

Numeric: Fixed Length = 6

TopUpAmount:

Currency

PhoneNumber

String: Max Length = 20

CountryCode

String: Fixed Length = 2

OrderID:

Numeric

ProfileID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
In case you need to void a top-up request transaction, you can do it by calling the
following method. Please note the parameter TransactionID, which represents the value
returned together with the top-up response, is required or otherwise the transaction will
not be voided.

VoidTransaction
Voids a recent transaction. Note: This is the same method referenced above for
voiding PIN transactions.

Copyright 2008 Pinserve Technologies

Document Version 1.7

15

Pinserve Web Services API Implementation Guide.

Parameter

API Version 2.3.3

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

TransactionID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
You can also void a top-up transaction using your own unique Order ID. Please note the
parameter OrderID, which represents the value passed in to the DoTopUp request, is
required or otherwise the transaction will not be voided.

VoidOrder
Voids a recent transaction based on clients own OrderID passed in.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

OrderID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

Blackstone Pinless processing


Along with the common parameters previously explained, these methods require others
parameters:
RechargeAmount: The dollar value of the recharge being requested. Use only
clean numeric values without any currency sign or commas. Example: 10 or 10.00
PrimaryPhone: The primary phone number associated to the subscribers
account.

Copyright 2008 Pinserve Technologies

Document Version 1.7

16

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

SecondaryPhone: Any additional phone number, besides the primary, associated


to the subscribers account.
AccountNumber: This the unique identifier assigned to the subscribers account,
thats assigned and returned when the PrimaryPhone is recharged for the very first
time.
OrderID: Numeric value that represents your own systems order identification
number. Use 0 for none.
ProfileID: Integer value that identifies the Profile. Use 0 or 15 for Generic
Profile.

The method for requesting recharge returns a response of class type PIN, which may
include many empty fields not needed in Blackstone Pinless recharge transactions.

PinlessRecharge
Performs a recharge to subscribers account.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

RechargeAmount:

Currency: Minimum $10.00

PrimaryPhone

String: Max Length = 20

OrderID:

Numeric

ProfileID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
In case you need to void a recharging request transaction, you can do it by calling the
following method. Please note the parameter OrderID, which represents the value passed
in to the PinlessRecharge request, is required or otherwise the transaction will not be
voided.

PinlessVoid
Voids a recent transaction based on clients own OrderID passed in.
Parameter

Copyright 2008 Pinserve Technologies

Value

Document Version 1.7

17

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

OrderID:

Numeric

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

You can request the current balance of the subscribers account by invoking the
following method.

PinlessBalance
Requests the subscriber accounts balance.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

AccountNumber:

Numeric

PrimaryPhone

String: Max Length = 20

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
For adding or deleting a secondary phone number to the subscribers account you can
invoke the following methods.

Copyright 2008 Pinserve Technologies

Document Version 1.7

18

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

PinlessAddPhone
Adds a secondary phone number associated to the subscribers account.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

AccountNumber:

Numeric

SecondaryPhone

String: Max Length = 20

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

PinlessDeletePhone
Deletes a secondary phone number associated from the subscribers account.
Parameter

Value

MID:

Numeric

TID:

Numeric

Password:

String: Max Length = 20

Cashier:

Numeric String: Max Length = 4

AccountNumber:

Numeric

SecondaryPhone

String: Max Length = 20

TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response

Copyright 2008 Pinserve Technologies

Document Version 1.7

19

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix A: Formal Definitions (WSDL)

Copyright 2008 Pinserve Technologies

Document Version 1.7

20

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
xmlns:tns="https://services.blackstoneonline.com/TransactionBroker/Broker"
xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
targetNamespace="https://services.blackstoneonline.com/TransactionBroker/Broker"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
- <wsdl:types>
- <s:schema elementFormDefault="qualified"
targetNamespace="https://services.blackstoneonline.com/TransactionBroker/Broker">
- <s:element name="GetSinglePIN">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductMaincode" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="ProductDenomination" type="s:decimal" />
<s:element minOccurs="1" maxOccurs="1" name="OrderID" type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="ProfileID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
- <s:element name="GetSinglePINResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="GetSinglePINResult" type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
- <s:complexType name="PIN">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="ErrorCode" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ErrorMessage" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="PinID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductMainCode" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductDenomination" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="PinNumber" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ControlNumber" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Language" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductSBT" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Conn800English" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="CustomerServiceEnglish" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="LocalAccessPhones" type="tns:ArrayOfAnyType" />
<s:element minOccurs="0" maxOccurs="1" name="ItemFK" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductDescription" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Batch" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ExpirationDate" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductType" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Barcode" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Instructions" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="PrinterDisclaimer" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ToppedUpNumber" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="AccountNumber" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="LegalInfo" type="tns:Legal" />
</s:sequence>
</s:complexType>
- <s:complexType name="ArrayOfAnyType">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="anyType" nillable="true" />
</s:sequence>
</s:complexType>
- <s:complexType name="Legal">
- <s:sequence>

Copyright 2008 Pinserve Technologies

Document Version 1.7

21

Pinserve Web Services API Implementation Guide.

<s:element minOccurs="0" maxOccurs="1"


<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
</s:sequence>
</s:complexType>
<s:complexType name="Denomination">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
</s:sequence>
</s:complexType>
<s:complexType name="Product">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="1" maxOccurs="1"
<s:element minOccurs="1" maxOccurs="1"
</s:sequence>
</s:complexType>
<s:complexType name="Catalog">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="1" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
</s:sequence>
</s:complexType>
<s:complexType name="RateDeck">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="1" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
</s:sequence>
</s:complexType>
<s:complexType name="Rate">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"
<s:element minOccurs="0" maxOccurs="1"

Copyright 2008 Pinserve Technologies

API Version 2.3.3


name="Version" type="s:string" />
name="Copyright" type="s:string" />
name="Disclaimer" type="s:string" />
name="PrivacyURL" type="s:string" />
name="TermsAndConditions" type="s:string" />
name="ContactPhone" type="s:string" />

name="DenominationID" type="s:string" />


name="DenominationCode" type="s:string" />
name="DenominationValue" type="s:string" />
name="DenominationBarcode" type="s:string" />

name="CardID" type="s:string" />


name="ProductMaincode" type="s:string" />
name="AvailableDenominations" type="s:string" />
name="Denominations" type="tns:ArrayOfAnyType" />
name="ProductName" type="s:string" />
name="ProductType" type="s:string" />
name="ProductTypeDesc" type="s:string" />
name="Disclaimer" type="s:string" />
name="DisclaimerSpanish" type="s:string" />
name="Carrier" type="s:string" />
name="RecommendedUse" type="s:string" />
name="Searchable" type="s:string" />
name="AccessType" type="s:string" />
name="AccessTypeDesc" type="s:string" />
name="Instructions" type="s:string" />
name="PrinterDisclaimer" type="s:string" />
name="ProductBarcode" type="s:string" />
name="TargetCountry" type="s:string" />
name="CountryCode" type="s:string" />
name="TopUpMinAmount" type="s:decimal" />
name="TopUpMaxAmount" type="s:decimal" />

name="ErrorCode" type="s:string" />


name="ErrorMessage" type="s:string" />
name="ProfileID" type="s:int" />
name="ProfileName" type="s:string" />
name="ProfileDescription" type="s:string" />
name="ProfileRegion" type="s:string" />
name="ProfileState" type="s:string" />
name="ProfileType" type="s:string" />
name="ProfileTypeDesc" type="s:string" />
name="ProductList" type="tns:ArrayOfAnyType" />

name="ProductName" type="s:string" />


name="ProductMaincode" type="s:string" />
name="ProductRateDeck" type="tns:ArrayOfAnyType" />
name="ProfileID" type="s:int" />
name="RateDeckType" type="s:string" />
name="RateDeckTypeDesc" type="s:string" />

name="RatePerMin" type="s:string" />


name="ConnFee" type="s:string" />
name="MinutesIn2" type="s:string" />

Document Version 1.7

22

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<s:element minOccurs="0" maxOccurs="1" name="MinutesIn3" type="s:string" />


<s:element minOccurs="0" maxOccurs="1" name="MinutesIn5" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="MinutesIn10" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="MinutesIn20" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="RateType" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="RateTypeDesc" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Destination" type="tns:Destination" />
</s:sequence>
</s:complexType>
<s:complexType name="Destination">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="DestinationID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="CountryName" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="CityName" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="CountrySpanish" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="CitySpanish" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="DestinationType" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="DestinationTypeDesc" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="DestinationTypeOrder" type="s:string" />
</s:sequence>
</s:complexType>
<s:complexType name="AccessPhone">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="State" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="City" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Phone" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="AccessLanguage" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="AccessType" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="AreaCode" type="s:string" />
</s:sequence>
</s:complexType>
<s:complexType name="PinlessTransactionResponse">
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="ErrorCode" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ErrorMessage" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Balance" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="LegalInfo" type="tns:Legal" />
</s:sequence>
</s:complexType>
<s:element name="GetMultiplePIN">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductMaincode" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="ProductDenomination" type="s:decimal" />
<s:element minOccurs="1" maxOccurs="1" name="QtyPINs" type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="OrderID" type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="ProfileID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetMultiplePINResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="GetMultiplePINResult"
type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetMultiplePINLite">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />

Copyright 2008 Pinserve Technologies

Document Version 1.7

23

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<s:element minOccurs="0" maxOccurs="1" name="ProductMaincode" type="s:string" />


<s:element minOccurs="1" maxOccurs="1" name="ProductDenomination" type="s:decimal" />
<s:element minOccurs="1" maxOccurs="1" name="QtyPINs" type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="OrderID" type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="ProfileID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetMultiplePINLiteResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="GetMultiplePINLiteResult"
type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="DoTopUp">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductMaincode" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TopUpAmount" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="PhoneNumber" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="CountryCode" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="OrderID" type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="ProfileID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="DoTopUpResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="DoTopUpResult" type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessRecharge">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="RechargeAmount" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="PrimaryPhone" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="OrderID" type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="ProfileID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessRechargeResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="PinlessRechargeResult" type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessBalance">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />

Copyright 2008 Pinserve Technologies

Document Version 1.7

24

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<s:element minOccurs="0" maxOccurs="1" name="AccountNumber" type="s:string" />


<s:element minOccurs="0" maxOccurs="1" name="PrimaryPhone" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessBalanceResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="PinlessBalanceResult"
type="tns:PinlessTransactionResponse" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessAddPhone">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="AccountNumber" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="SecondaryPhone" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessAddPhoneResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="PinlessAddPhoneResult"
type="tns:PinlessTransactionResponse" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessDeletePhone">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="AccountNumber" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="SecondaryPhone" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessDeletePhoneResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="PinlessDeletePhoneResult"
type="tns:PinlessTransactionResponse" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="VoidTransaction">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="TransactionID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="VoidTransactionResponse">
- <s:complexType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

25

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="VoidTransactionResult" type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="VoidOrder">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="OrderID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="VoidOrderResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="VoidOrderResult" type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessVoid">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="OrderID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="PinlessVoidResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="PinlessVoidResult" type="tns:PIN" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetAllDestinations">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetAllDestinationsResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="GetAllDestinationsResult"
type="tns:Destination" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductAccessPhones">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ProductMaincode" type="s:string" />

Copyright 2008 Pinserve Technologies

Document Version 1.7

26

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />


</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductAccessPhonesResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="GetProductAccessPhonesResult"
type="tns:AccessPhone" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductRateDeck">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="ProfileID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="ProductMaincode" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductRateDeckResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="GetProductRateDeckResult"
type="tns:RateDeck" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductProfiles">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductProfilesResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="GetProductProfilesResult"
type="tns:Catalog" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductsCatalog">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="ProfileID" type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetProductsCatalogResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="GetProductsCatalogResult" type="tns:Catalog" />
</s:sequence>
</s:complexType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

27

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

</s:element>
- <s:element name="GetLegalInformation">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="MID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TID" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Password" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="Cashier" type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="TransactionMode" type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
- <s:element name="GetLegalInformationResponse">
- <s:complexType>
- <s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="GetLegalInformationResult" type="tns:Legal" />
</s:sequence>
</s:complexType>
</s:element>
</s:schema>
</wsdl:types>
<wsdl:message name="GetSinglePINSoapIn">
<wsdl:part name="parameters" element="tns:GetSinglePIN" />
</wsdl:message>
<wsdl:message name="GetSinglePINSoapOut">
<wsdl:part name="parameters" element="tns:GetSinglePINResponse" />
</wsdl:message>
<wsdl:message name="GetMultiplePINSoapIn">
<wsdl:part name="parameters" element="tns:GetMultiplePIN" />
</wsdl:message>
<wsdl:message name="GetMultiplePINSoapOut">
<wsdl:part name="parameters" element="tns:GetMultiplePINResponse" />
</wsdl:message>
<wsdl:message name="GetMultiplePINLiteSoapIn">
<wsdl:part name="parameters" element="tns:GetMultiplePINLite" />
</wsdl:message>
<wsdl:message name="GetMultiplePINLiteSoapOut">
<wsdl:part name="parameters" element="tns:GetMultiplePINLiteResponse" />
</wsdl:message>
<wsdl:message name="DoTopUpSoapIn">
<wsdl:part name="parameters" element="tns:DoTopUp" />
</wsdl:message>
<wsdl:message name="DoTopUpSoapOut">
<wsdl:part name="parameters" element="tns:DoTopUpResponse" />
</wsdl:message>
<wsdl:message name="PinlessRechargeSoapIn">
<wsdl:part name="parameters" element="tns:PinlessRecharge" />
</wsdl:message>
<wsdl:message name="PinlessRechargeSoapOut">
<wsdl:part name="parameters" element="tns:PinlessRechargeResponse" />
</wsdl:message>
<wsdl:message name="PinlessBalanceSoapIn">
<wsdl:part name="parameters" element="tns:PinlessBalance" />
</wsdl:message>
<wsdl:message name="PinlessBalanceSoapOut">
<wsdl:part name="parameters" element="tns:PinlessBalanceResponse" />
</wsdl:message>
<wsdl:message name="PinlessAddPhoneSoapIn">
<wsdl:part name="parameters" element="tns:PinlessAddPhone" />
</wsdl:message>
<wsdl:message name="PinlessAddPhoneSoapOut">
<wsdl:part name="parameters" element="tns:PinlessAddPhoneResponse" />
</wsdl:message>
<wsdl:message name="PinlessDeletePhoneSoapIn">
<wsdl:part name="parameters" element="tns:PinlessDeletePhone" />
</wsdl:message>
<wsdl:message name="PinlessDeletePhoneSoapOut">
<wsdl:part name="parameters" element="tns:PinlessDeletePhoneResponse" />
</wsdl:message>
<wsdl:message name="VoidTransactionSoapIn">

Copyright 2008 Pinserve Technologies

Document Version 1.7

28

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<wsdl:part name="parameters" element="tns:VoidTransaction" />


</wsdl:message>
<wsdl:message name="VoidTransactionSoapOut">
<wsdl:part name="parameters" element="tns:VoidTransactionResponse" />
</wsdl:message>
<wsdl:message name="VoidOrderSoapIn">
<wsdl:part name="parameters" element="tns:VoidOrder" />
</wsdl:message>
<wsdl:message name="VoidOrderSoapOut">
<wsdl:part name="parameters" element="tns:VoidOrderResponse" />
</wsdl:message>
<wsdl:message name="PinlessVoidSoapIn">
<wsdl:part name="parameters" element="tns:PinlessVoid" />
</wsdl:message>
<wsdl:message name="PinlessVoidSoapOut">
<wsdl:part name="parameters" element="tns:PinlessVoidResponse" />
</wsdl:message>
<wsdl:message name="GetAllDestinationsSoapIn">
<wsdl:part name="parameters" element="tns:GetAllDestinations" />
</wsdl:message>
<wsdl:message name="GetAllDestinationsSoapOut">
<wsdl:part name="parameters" element="tns:GetAllDestinationsResponse" />
</wsdl:message>
<wsdl:message name="GetProductAccessPhonesSoapIn">
<wsdl:part name="parameters" element="tns:GetProductAccessPhones" />
</wsdl:message>
<wsdl:message name="GetProductAccessPhonesSoapOut">
<wsdl:part name="parameters" element="tns:GetProductAccessPhonesResponse" />
</wsdl:message>
<wsdl:message name="GetProductRateDeckSoapIn">
<wsdl:part name="parameters" element="tns:GetProductRateDeck" />
</wsdl:message>
<wsdl:message name="GetProductRateDeckSoapOut">
<wsdl:part name="parameters" element="tns:GetProductRateDeckResponse" />
</wsdl:message>
<wsdl:message name="GetProductProfilesSoapIn">
<wsdl:part name="parameters" element="tns:GetProductProfiles" />
</wsdl:message>
<wsdl:message name="GetProductProfilesSoapOut">
<wsdl:part name="parameters" element="tns:GetProductProfilesResponse" />
</wsdl:message>
<wsdl:message name="GetProductsCatalogSoapIn">
<wsdl:part name="parameters" element="tns:GetProductsCatalog" />
</wsdl:message>
<wsdl:message name="GetProductsCatalogSoapOut">
<wsdl:part name="parameters" element="tns:GetProductsCatalogResponse" />
</wsdl:message>
<wsdl:message name="GetLegalInformationSoapIn">
<wsdl:part name="parameters" element="tns:GetLegalInformation" />
</wsdl:message>
<wsdl:message name="GetLegalInformationSoapOut">
<wsdl:part name="parameters" element="tns:GetLegalInformationResponse" />
</wsdl:message>
<wsdl:portType name="BrokerSoap">
- <wsdl:operation name="GetSinglePIN">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets a single New PIN || Use
TransactionMode=T for testing purposes.</wsdl:documentation>
<wsdl:input message="tns:GetSinglePINSoapIn" />
<wsdl:output message="tns:GetSinglePINSoapOut" />
</wsdl:operation>
- <wsdl:operation name="GetMultiplePIN">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets an Array of New PINs || Use
TransactionMode=T for testing purposes || Required: QtyPINs>=1 AND QtyPINs<=5 (Max 5 PINs per
time)</wsdl:documentation>
<wsdl:input message="tns:GetMultiplePINSoapIn" />
<wsdl:output message="tns:GetMultiplePINSoapOut" />
</wsdl:operation>
- <wsdl:operation name="GetMultiplePINLite">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets an Array of New PINs with an
stripped out response || Use TransactionMode=T for testing purposes || Required: QtyPINs>=1 AND

Copyright 2008 Pinserve Technologies

Document Version 1.7

29

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

QtyPINs<=5 (Max 5 PINs per time)</wsdl:documentation>


<wsdl:input message="tns:GetMultiplePINLiteSoapIn" />
<wsdl:output message="tns:GetMultiplePINLiteSoapOut" />
</wsdl:operation>
<wsdl:operation name="DoTopUp">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Performs a Top Up to a Mobile
Subscriber || Use TransactionMode=T for testing purposes</wsdl:documentation>
<wsdl:input message="tns:DoTopUpSoapIn" />
<wsdl:output message="tns:DoTopUpSoapOut" />
</wsdl:operation>
<wsdl:operation name="PinlessRecharge">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Performs a Recharge to a Blackstone
Pinless Subscriber || Use TransactionMode=T for testing purposes</wsdl:documentation>
<wsdl:input message="tns:PinlessRechargeSoapIn" />
<wsdl:output message="tns:PinlessRechargeSoapOut" />
</wsdl:operation>
<wsdl:operation name="PinlessBalance">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets the current balance of a
Blackstone Pinless Subscriber || Use TransactionMode=T for testing purposes</wsdl:documentation>
<wsdl:input message="tns:PinlessBalanceSoapIn" />
<wsdl:output message="tns:PinlessBalanceSoapOut" />
</wsdl:operation>
<wsdl:operation name="PinlessAddPhone">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Adds a new secondary phone
number to Blackstone Pinless subscriber's account || Use TransactionMode=T for testing
purposes</wsdl:documentation>
<wsdl:input message="tns:PinlessAddPhoneSoapIn" />
<wsdl:output message="tns:PinlessAddPhoneSoapOut" />
</wsdl:operation>
<wsdl:operation name="PinlessDeletePhone">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Removes a secondary phone number
from Blackstone Pinless subscriber's account || Use TransactionMode=T for testing
purposes</wsdl:documentation>
<wsdl:input message="tns:PinlessDeletePhoneSoapIn" />
<wsdl:output message="tns:PinlessDeletePhoneSoapOut" />
</wsdl:operation>
<wsdl:operation name="VoidTransaction">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Voids a recent transaction || Use
TransactionMode=T for testing purposes.</wsdl:documentation>
<wsdl:input message="tns:VoidTransactionSoapIn" />
<wsdl:output message="tns:VoidTransactionSoapOut" />
</wsdl:operation>
<wsdl:operation name="VoidOrder">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Voids a recent transaction based on
client's own OrderID || Use TransactionMode=T for testing purposes.</wsdl:documentation>
<wsdl:input message="tns:VoidOrderSoapIn" />
<wsdl:output message="tns:VoidOrderSoapOut" />
</wsdl:operation>
<wsdl:operation name="PinlessVoid">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Voids a recent Blackstone Pinless
transaction based on client's own OrderID || Use TransactionMode=T for testing
purposes.</wsdl:documentation>
<wsdl:input message="tns:PinlessVoidSoapIn" />
<wsdl:output message="tns:PinlessVoidSoapOut" />
</wsdl:operation>
<wsdl:operation name="GetAllDestinations">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets the list of all destinations
shown in rate decks.</wsdl:documentation>
<wsdl:input message="tns:GetAllDestinationsSoapIn" />
<wsdl:output message="tns:GetAllDestinationsSoapOut" />
</wsdl:operation>
<wsdl:operation name="GetProductAccessPhones">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets an Array of Access Phone
numbers for given Product Code.</wsdl:documentation>
<wsdl:input message="tns:GetProductAccessPhonesSoapIn" />
<wsdl:output message="tns:GetProductAccessPhonesSoapOut" />
</wsdl:operation>
<wsdl:operation name="GetProductRateDeck">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets the Rates Deck for given
ProductMaincode and ProfileID. || Use ProfileID=0 for Generic Profile</wsdl:documentation>
<wsdl:input message="tns:GetProductRateDeckSoapIn" />

Copyright 2008 Pinserve Technologies

Document Version 1.7

30

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<wsdl:output message="tns:GetProductRateDeckSoapOut" />


</wsdl:operation>
- <wsdl:operation name="GetProductProfiles">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets all available
Profiles.</wsdl:documentation>
<wsdl:input message="tns:GetProductProfilesSoapIn" />
<wsdl:output message="tns:GetProductProfilesSoapOut" />
</wsdl:operation>
- <wsdl:operation name="GetProductsCatalog">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets all products available for the
given ProfileID. || Use ProfileID=0 for Generic Profile</wsdl:documentation>
<wsdl:input message="tns:GetProductsCatalogSoapIn" />
<wsdl:output message="tns:GetProductsCatalogSoapOut" />
</wsdl:operation>
- <wsdl:operation name="GetLegalInformation">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">Gets version, legal and privacy
information, term and conditions.</wsdl:documentation>
<wsdl:input message="tns:GetLegalInformationSoapIn" />
<wsdl:output message="tns:GetLegalInformationSoapOut" />
</wsdl:operation>
</wsdl:portType>
- <wsdl:binding name="BrokerSoap" type="tns:BrokerSoap">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
- <wsdl:operation name="GetSinglePIN">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetSinglePIN"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetMultiplePIN">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetMultiplePIN"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetMultiplePINLite">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetMultiplePINLite"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="DoTopUp">
<soap:operation soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/DoTopUp"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="PinlessRecharge">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessRecharge"
style="document" />
- <wsdl:input>

Copyright 2008 Pinserve Technologies

Document Version 1.7

31

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<soap:body use="literal" />


</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessBalance">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessBalance"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessAddPhone">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessAddPhone"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessDeletePhone">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessDeletePhone"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="VoidTransaction">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/VoidTransaction"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="VoidOrder">
<soap:operation soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/VoidOrder"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessVoid">
<soap:operation soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessVoid"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetAllDestinations">

Copyright 2008 Pinserve Technologies

Document Version 1.7

32

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetAllDestinations"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetProductAccessPhones">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductAccessPhones"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetProductRateDeck">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductRateDeck"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetProductProfiles">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductProfiles"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetProductsCatalog">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductsCatalog"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetLegalInformation">
<soap:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetLegalInformation"
style="document" />
- <wsdl:input>
<soap:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
- <wsdl:binding name="BrokerSoap12" type="tns:BrokerSoap">
<soap12:binding transport="http://schemas.xmlsoap.org/soap/http" />
- <wsdl:operation name="GetSinglePIN">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetSinglePIN"

Copyright 2008 Pinserve Technologies

Document Version 1.7

33

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetMultiplePIN">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetMultiplePIN"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetMultiplePINLite">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetMultiplePINLite"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="DoTopUp">
<soap12:operation soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/DoTopUp"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessRecharge">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessRecharge"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessBalance">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessBalance"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessAddPhone">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessAddPhone"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />

Copyright 2008 Pinserve Technologies

Document Version 1.7

34

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessDeletePhone">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessDeletePhone"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="VoidTransaction">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/VoidTransaction"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="VoidOrder">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/VoidOrder"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="PinlessVoid">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessVoid"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetAllDestinations">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetAllDestinations"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetProductAccessPhones">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductAccessPhones"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetProductRateDeck">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductRateDeck"

Copyright 2008 Pinserve Technologies

Document Version 1.7

35

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetProductProfiles">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductProfiles"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetProductsCatalog">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductsCatalog"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
- <wsdl:operation name="GetLegalInformation">
<soap12:operation
soapAction="https://services.blackstoneonline.com/TransactionBroker/Broker/GetLegalInformation"
style="document" />
- <wsdl:input>
<soap12:body use="literal" />
</wsdl:input>
- <wsdl:output>
<soap12:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
- <wsdl:service name="Broker">
- <wsdl:port name="BrokerSoap" binding="tns:BrokerSoap">
<soap:address location="http://localhost:2286/TransactionBroker/Broker.asmx" />
</wsdl:port>
- <wsdl:port name="BrokerSoap12" binding="tns:BrokerSoap12">
<soap12:address location="http://localhost:2286/TransactionBroker/Broker.asmx" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

Copyright 2008 Pinserve Technologies

Document Version 1.7

36

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix B: SOAP and HTML Definitions

Copyright 2008 Pinserve Technologies

Document Version 1.7

37

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

DoTopUp
Performs a Top Up to a Mobile Subscriber || Use TransactionMode=T for testing purposes

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
ProductMaincode:
TopUpAmount:
PhoneNumber:
CountryCode:
OrderID:
ProfileID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/DoTopUp"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<DoTopUp xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<TopUpAmount>string</TopUpAmount>
<PhoneNumber>string</PhoneNumber>
<CountryCode>string</CountryCode>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</DoTopUp>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<DoTopUpResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<DoTopUpResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>

Copyright 2008 Pinserve Technologies

Document Version 1.7

38

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

</LegalInfo>
</DoTopUpResult>
</DoTopUpResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<DoTopUp xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<TopUpAmount>string</TopUpAmount>
<PhoneNumber>string</PhoneNumber>
<CountryCode>string</CountryCode>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</DoTopUp>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<DoTopUpResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<DoTopUpResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</DoTopUpResult>
</DoTopUpResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/DoTopUp HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&ProductMaincode=string&TopUpAmount=string&PhoneNumber=string&CountryCode=string&OrderID=string&ProfileI
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>

Copyright 2008 Pinserve Technologies

Document Version 1.7

39

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

40

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetAllDestinations
Gets the list of all destinations shown in rate decks.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetAllDestinations"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetAllDestinations xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionMode>string</TransactionMode>
</GetAllDestinations>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetAllDestinationsResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetAllDestinationsResult>
<DestinationID>string</DestinationID>
<CountryName>string</CountryName>
<CityName>string</CityName>
<CountrySpanish>string</CountrySpanish>
<CitySpanish>string</CitySpanish>
<DestinationType>string</DestinationType>
<DestinationTypeDesc>string</DestinationTypeDesc>
<DestinationTypeOrder>string</DestinationTypeOrder>
</GetAllDestinationsResult>
<GetAllDestinationsResult>
<DestinationID>string</DestinationID>
<CountryName>string</CountryName>
<CityName>string</CityName>
<CountrySpanish>string</CountrySpanish>
<CitySpanish>string</CitySpanish>
<DestinationType>string</DestinationType>
<DestinationTypeDesc>string</DestinationTypeDesc>
<DestinationTypeOrder>string</DestinationTypeOrder>
</GetAllDestinationsResult>
</GetAllDestinationsResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetAllDestinations xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionMode>string</TransactionMode>
</GetAllDestinations>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>

Copyright 2008 Pinserve Technologies

Document Version 1.7

41

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<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/


<soap12:Body>
<GetAllDestinationsResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetAllDestinationsResult>
<DestinationID>string</DestinationID>
<CountryName>string</CountryName>
<CityName>string</CityName>
<CountrySpanish>string</CountrySpanish>
<CitySpanish>string</CitySpanish>
<DestinationType>string</DestinationType>
<DestinationTypeDesc>string</DestinationTypeDesc>
<DestinationTypeOrder>string</DestinationTypeOrder>
</GetAllDestinationsResult>
<GetAllDestinationsResult>
<DestinationID>string</DestinationID>
<CountryName>string</CountryName>
<CityName>string</CityName>
<CountrySpanish>string</CountrySpanish>
<CitySpanish>string</CitySpanish>
<DestinationType>string</DestinationType>
<DestinationTypeDesc>string</DestinationTypeDesc>
<DestinationTypeOrder>string</DestinationTypeOrder>
</GetAllDestinationsResult>
</GetAllDestinationsResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetAllDestinations HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfAnyType xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<anyType />
<anyType />
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

42

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetLegalInformation
Gets version legal and privacy information, term and conditions.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetLegalInformation"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetLegalInformation xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionMode>string</TransactionMode>
</GetLegalInformation>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetLegalInformationResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetLegalInformationResult>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</GetLegalInformationResult>
</GetLegalInformationResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetLegalInformation xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionMode>string</TransactionMode>
</GetLegalInformation>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetLegalInformationResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetLegalInformationResult>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</GetLegalInformationResult>
</GetLegalInformationResponse>

Copyright 2008 Pinserve Technologies

Document Version 1.7

43

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetLegalInformation HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<Legal xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</Legal>

Copyright 2008 Pinserve Technologies

Document Version 1.7

44

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetMultiplePIN
Gets an Array of New PINs || Use TransactionMode=T for testing purposes || Required: QtyPINs>0

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
ProductMaincode:
ProductDenomination:
QtyPINs:
OrderID:
ProfileID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetMultiplePIN"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetMultiplePIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<ProductDenomination>decimal</ProductDenomination>
<QtyPINs>int</QtyPINs>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetMultiplePIN>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetMultiplePINResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetMultiplePINResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetMultiplePINResult>
<GetMultiplePINResult>
<ErrorCode>string</ErrorCode>

Copyright 2008 Pinserve Technologies

Document Version 1.7

45

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetMultiplePINResult>
</GetMultiplePINResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetMultiplePIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<ProductDenomination>decimal</ProductDenomination>
<QtyPINs>int</QtyPINs>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetMultiplePIN>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetMultiplePINResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetMultiplePINResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetMultiplePINResult>
<GetMultiplePINResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>

Copyright 2008 Pinserve Technologies

Document Version 1.7

46

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetMultiplePINResult>
</GetMultiplePINResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetMultiplePIN HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&ProductMaincode=string&ProductDenomination=string&QtyPINs=string&OrderID=string&ProfileID=string&Transa
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfAnyType xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<anyType />
<anyType />
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

47

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetMultiplePINLite
Gets an Array of New PINs with an stripped out response || Use TransactionMode=T for testing purposes || Required: QtyPINs>=1 AND QtyPINs<=5 (Max 5 PINs per time)

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
ProductMaincode:
ProductDenomination:
QtyPINs:
OrderID:
ProfileID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetMultiplePINLite"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetMultiplePINLite xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<ProductDenomination>decimal</ProductDenomination>
<QtyPINs>int</QtyPINs>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetMultiplePINLite>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetMultiplePINLiteResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetMultiplePINLiteResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</GetMultiplePINLiteResult>
<GetMultiplePINLiteResult>

Copyright 2008 Pinserve Technologies

Document Version 1.7

48

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</GetMultiplePINLiteResult>
</GetMultiplePINLiteResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetMultiplePINLite xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<ProductDenomination>decimal</ProductDenomination>
<QtyPINs>int</QtyPINs>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetMultiplePINLite>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetMultiplePINLiteResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetMultiplePINLiteResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</GetMultiplePINLiteResult>

Copyright 2008 Pinserve Technologies

Document Version 1.7

49

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<GetMultiplePINLiteResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</GetMultiplePINLiteResult>
</GetMultiplePINLiteResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetMultiplePINLite HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&ProductMaincode=string&ProductDenomination=string&QtyPINs=string&OrderID=string&ProfileID=string&Transa
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfAnyType xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<anyType />
<anyType />
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

50

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetProductAccessPhones
Gets an Array of Access Phone numbers for given Product Code.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
ProductMaincode:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductAccessPhones"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetProductAccessPhones xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<TransactionMode>string</TransactionMode>
</GetProductAccessPhones>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetProductAccessPhonesResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetProductAccessPhonesResult>
<State>string</State>
<City>string</City>
<Phone>string</Phone>
<AccessLanguage>string</AccessLanguage>
<AccessType>string</AccessType>
<AreaCode>string</AreaCode>
</GetProductAccessPhonesResult>
<GetProductAccessPhonesResult>
<State>string</State>
<City>string</City>
<Phone>string</Phone>
<AccessLanguage>string</AccessLanguage>
<AccessType>string</AccessType>
<AreaCode>string</AreaCode>
</GetProductAccessPhonesResult>
</GetProductAccessPhonesResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetProductAccessPhones xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<TransactionMode>string</TransactionMode>
</GetProductAccessPhones>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>

Copyright 2008 Pinserve Technologies

Document Version 1.7

51

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<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/


<soap12:Body>
<GetProductAccessPhonesResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetProductAccessPhonesResult>
<State>string</State>
<City>string</City>
<Phone>string</Phone>
<AccessLanguage>string</AccessLanguage>
<AccessType>string</AccessType>
<AreaCode>string</AreaCode>
</GetProductAccessPhonesResult>
<GetProductAccessPhonesResult>
<State>string</State>
<City>string</City>
<Phone>string</Phone>
<AccessLanguage>string</AccessLanguage>
<AccessType>string</AccessType>
<AreaCode>string</AreaCode>
</GetProductAccessPhonesResult>
</GetProductAccessPhonesResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetProductAccessPhones HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&ProductMaincode=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfAnyType xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<anyType />
<anyType />
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

52

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetProductProfiles
Gets all available Profiles.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductProfiles"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetProductProfiles xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionMode>string</TransactionMode>
</GetProductProfiles>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetProductProfilesResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetProductProfilesResult>
<ProfileID>int</ProfileID>
<ProfileName>string</ProfileName>
<ProfileDescription>string</ProfileDescription>
<ProfileRegion>string</ProfileRegion>
<ProfileState>string</ProfileState>
<ProfileType>string</ProfileType>
<ProfileTypeDesc>string</ProfileTypeDesc>
<ProductList>
<anyType />
<anyType />
</ProductList>
</GetProductProfilesResult>
<GetProductProfilesResult>
<ProfileID>int</ProfileID>
<ProfileName>string</ProfileName>
<ProfileDescription>string</ProfileDescription>
<ProfileRegion>string</ProfileRegion>
<ProfileState>string</ProfileState>
<ProfileType>string</ProfileType>
<ProfileTypeDesc>string</ProfileTypeDesc>
<ProductList>
<anyType />
<anyType />
</ProductList>
</GetProductProfilesResult>
</GetProductProfilesResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetProductProfiles xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionMode>string</TransactionMode>
</GetProductProfiles>
</soap12:Body>
</soap12:Envelope>

Copyright 2008 Pinserve Technologies

Document Version 1.7

53

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetProductProfilesResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetProductProfilesResult>
<ProfileID>int</ProfileID>
<ProfileName>string</ProfileName>
<ProfileDescription>string</ProfileDescription>
<ProfileRegion>string</ProfileRegion>
<ProfileState>string</ProfileState>
<ProfileType>string</ProfileType>
<ProfileTypeDesc>string</ProfileTypeDesc>
<ProductList>
<anyType />
<anyType />
</ProductList>
</GetProductProfilesResult>
<GetProductProfilesResult>
<ProfileID>int</ProfileID>
<ProfileName>string</ProfileName>
<ProfileDescription>string</ProfileDescription>
<ProfileRegion>string</ProfileRegion>
<ProfileState>string</ProfileState>
<ProfileType>string</ProfileType>
<ProfileTypeDesc>string</ProfileTypeDesc>
<ProductList>
<anyType />
<anyType />
</ProductList>
</GetProductProfilesResult>
</GetProductProfilesResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetProductProfiles HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfAnyType xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<anyType />
<anyType />
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

54

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetProductsCatalog
Gets all products available for the given ProfileID. || Use ProfileID=0 for Generic Profile

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
ProfileID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetProductsCatalog"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetProductsCatalog xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetProductsCatalog>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetProductsCatalogResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetProductsCatalogResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<ProfileID>int</ProfileID>
<ProfileName>string</ProfileName>
<ProfileDescription>string</ProfileDescription>
<ProfileRegion>string</ProfileRegion>
<ProfileState>string</ProfileState>
<ProfileType>string</ProfileType>
<ProfileTypeDesc>string</ProfileTypeDesc>
<ProductList>
<anyType />
<anyType />
</ProductList>
</GetProductsCatalogResult>
</GetProductsCatalogResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetProductsCatalog xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetProductsCatalog>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/

Copyright 2008 Pinserve Technologies

Document Version 1.7

55

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<soap12:Body>
<GetProductsCatalogResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetProductsCatalogResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<ProfileID>int</ProfileID>
<ProfileName>string</ProfileName>
<ProfileDescription>string</ProfileDescription>
<ProfileRegion>string</ProfileRegion>
<ProfileState>string</ProfileState>
<ProfileType>string</ProfileType>
<ProfileTypeDesc>string</ProfileTypeDesc>
<ProductList>
<anyType />
<anyType />
</ProductList>
</GetProductsCatalogResult>
</GetProductsCatalogResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetProductsCatalog HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&ProfileID=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<Catalog xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<ProfileID>int</ProfileID>
<ProfileName>string</ProfileName>
<ProfileDescription>string</ProfileDescription>
<ProfileRegion>string</ProfileRegion>
<ProfileState>string</ProfileState>
<ProfileType>string</ProfileType>
<ProfileTypeDesc>string</ProfileTypeDesc>
<ProductList>
<anyType />
<anyType />
</ProductList>
</Catalog>

Copyright 2008 Pinserve Technologies

Document Version 1.7

56

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

GetSinglePIN
Gets a single New PIN || Use TransactionMode=T for testing purposes.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
ProductMaincode:
ProductDenomination:
OrderID:
ProfileID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/GetSinglePIN"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetSinglePIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<ProductDenomination>decimal</ProductDenomination>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetSinglePIN>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<GetSinglePINResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetSinglePINResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetSinglePINResult>
<GetSinglePINResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>

Copyright 2008 Pinserve Technologies

Document Version 1.7

57

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetSinglePINResult>
</GetSinglePINResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetSinglePIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<ProductMaincode>string</ProductMaincode>
<ProductDenomination>decimal</ProductDenomination>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</GetSinglePIN>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<GetSinglePINResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<GetSinglePINResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetSinglePINResult>
<GetSinglePINResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>

Copyright 2008 Pinserve Technologies

Document Version 1.7

58

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
</GetSinglePINResult>
</GetSinglePINResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/GetSinglePIN HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&ProductMaincode=string&ProductDenomination=string&OrderID=string&ProfileID=string&TransactionMode=strin
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfAnyType xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<anyType />
<anyType />
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

59

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

VoidOrder
Voids a recent transaction based on client's own OrderID || Use TransactionMode=T for testing purposes.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
OrderID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/VoidOrder"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<VoidOrder xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<OrderID>int</OrderID>
<TransactionMode>string</TransactionMode>
</VoidOrder>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<VoidOrderResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<VoidOrderResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</VoidOrderResult>
</VoidOrderResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

Copyright 2008 Pinserve Technologies

Document Version 1.7

60

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<?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/
<soap12:Body>
<VoidOrder xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<OrderID>int</OrderID>
<TransactionMode>string</TransactionMode>
</VoidOrder>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<VoidOrderResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<VoidOrderResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</VoidOrderResult>
</VoidOrderResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/VoidOrder HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&OrderID=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>

Copyright 2008 Pinserve Technologies

Document Version 1.7

61

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

62

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

VoidTransaction
Voids a recent transaction || Use TransactionMode=T for testing purposes.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
TransactionID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/VoidTransaction"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<VoidTransaction xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionID>int</TransactionID>
<TransactionMode>string</TransactionMode>
</VoidTransaction>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<VoidTransactionResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<VoidTransactionResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</VoidTransactionResult>
</VoidTransactionResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/

Copyright 2008 Pinserve Technologies

Document Version 1.7

63

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<soap12:Body>
<VoidTransaction xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<TransactionID>int</TransactionID>
<TransactionMode>string</TransactionMode>
</VoidTransaction>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<VoidTransactionResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<VoidTransactionResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</VoidTransactionResult>
</VoidTransactionResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/VoidTransaction HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&TransactionID=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

64

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

PinlessRecharge
Performs a Recharge to a Blackstone Pinless Subscriber || Use TransactionMode=T for testing purposes

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
RechargeAmount:
PrimaryPhone:
OrderID:
ProfileID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessRecharge"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessRecharge xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<RechargeAmount>string</RechargeAmount>
<PrimaryPhone>string</PrimaryPhone>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</PinlessRecharge>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessRechargeResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessRechargeResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<AccountNumber>string</AccountNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessRechargeResult>
</PinlessRechargeResponse>
</soap:Body>

Copyright 2008 Pinserve Technologies

Document Version 1.7

65

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<PinlessRecharge xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<RechargeAmount>string</RechargeAmount>
<PrimaryPhone>string</PrimaryPhone>
<OrderID>int</OrderID>
<ProfileID>int</ProfileID>
<TransactionMode>string</TransactionMode>
</PinlessRecharge>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<PinlessRechargeResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessRechargeResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<AccountNumber>string</AccountNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessRechargeResult>
</PinlessRechargeResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/PinlessRecharge HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&RechargeAmount=string&PrimaryPhone=string&OrderID=string&ProfileID=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />

Copyright 2008 Pinserve Technologies

Document Version 1.7

66

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<AccountNumber>string</AccountNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

67

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

PinlessVoid
Voids a recent Blackstone Pinless transaction based on client's own OrderID || Use TransactionMode=T for testing purposes.

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
OrderID:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessVoid"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessVoid xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<OrderID>int</OrderID>
<TransactionMode>string</TransactionMode>
</PinlessVoid>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessVoidResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessVoidResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<AccountNumber>string</AccountNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessVoidResult>
</PinlessVoidResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8

Copyright 2008 Pinserve Technologies

Document Version 1.7

68

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Content-Length: length
<?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/
<soap12:Body>
<PinlessVoid xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<OrderID>int</OrderID>
<TransactionMode>string</TransactionMode>
</PinlessVoid>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<PinlessVoidResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessVoidResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<AccountNumber>string</AccountNumber>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessVoidResult>
</PinlessVoidResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/PinlessVoid HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&OrderID=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PIN xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<TransactionID>string</TransactionID>
<PinID>string</PinID>
<ProductMainCode>string</ProductMainCode>
<ProductDenomination>string</ProductDenomination>
<PinNumber>string</PinNumber>
<ControlNumber>string</ControlNumber>
<Language>string</Language>
<ProductSBT>string</ProductSBT>
<Conn800English>string</Conn800English>
<CustomerServiceEnglish>string</CustomerServiceEnglish>
<LocalAccessPhones>
<anyType />
<anyType />
</LocalAccessPhones>
<ItemFK>string</ItemFK>
<TransactionMode>string</TransactionMode>
<ProductDescription>string</ProductDescription>
<Batch>string</Batch>
<ExpirationDate>string</ExpirationDate>
<ProductType>string</ProductType>
<Barcode>string</Barcode>
<Instructions>string</Instructions>
<PrinterDisclaimer>string</PrinterDisclaimer>
<ToppedUpNumber>string</ToppedUpNumber>
<AccountNumber>string</AccountNumber>

Copyright 2008 Pinserve Technologies

Document Version 1.7

69

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

70

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

PinlessBalance
Gets the current balance of a Blackstone Pinless Subscriber || Use TransactionMode=T for testing purposes

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
AccountNumber:
PrimaryPhone:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessBalance"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessBalance xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<AccountNumber>string</AccountNumber>
<PrimaryPhone>string</PrimaryPhone>
<TransactionMode>string</TransactionMode>
</PinlessBalance>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessBalanceResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessBalanceResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessBalanceResult>
</PinlessBalanceResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<PinlessBalance xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<AccountNumber>string</AccountNumber>
<PrimaryPhone>string</PrimaryPhone>
<TransactionMode>string</TransactionMode>
</PinlessBalance>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

Copyright 2008 Pinserve Technologies

Document Version 1.7

71

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<?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/
<soap12:Body>
<PinlessBalanceResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessBalanceResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessBalanceResult>
</PinlessBalanceResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/PinlessBalance HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&AccountNumber=string&PrimaryPhone=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PinlessTransactionResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessTransactionResponse>

Copyright 2008 Pinserve Technologies

Document Version 1.7

72

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

PinlessAddPhone
Adds a new secondary phone number to Blackstone Pinless subscriber's account || Use TransactionMode=T for testing purposes

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
AccountNumber:
SecondaryPhone:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessAddPhone"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessAddPhone xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<AccountNumber>string</AccountNumber>
<SecondaryPhone>string</SecondaryPhone>
<TransactionMode>string</TransactionMode>
</PinlessAddPhone>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessAddPhoneResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessAddPhoneResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessAddPhoneResult>
</PinlessAddPhoneResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<PinlessAddPhone xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<AccountNumber>string</AccountNumber>
<SecondaryPhone>string</SecondaryPhone>
<TransactionMode>string</TransactionMode>
</PinlessAddPhone>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

Copyright 2008 Pinserve Technologies

Document Version 1.7

73

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<?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/
<soap12:Body>
<PinlessAddPhoneResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessAddPhoneResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessAddPhoneResult>
</PinlessAddPhoneResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/PinlessAddPhone HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&AccountNumber=string&SecondaryPhone=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PinlessTransactionResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessTransactionResponse>

Copyright 2008 Pinserve Technologies

Document Version 1.7

74

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Broker
Click here for a complete list of operations.

PinlessDeletePhone
Removes a secondary phone number from Blackstone Pinless subscriber's account || Use TransactionMode=T for testing purposes

Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter

Value

MID:
TID:
Password:
Cashier:
AccountNumber:
SecondaryPhone:
TransactionMode:
Invoke

SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://services.blackstoneonline.com/TransactionBroker/Broker/PinlessDeletePhone"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessDeletePhone xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<AccountNumber>string</AccountNumber>
<SecondaryPhone>string</SecondaryPhone>
<TransactionMode>string</TransactionMode>
</PinlessDeletePhone>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soa
<soap:Body>
<PinlessDeletePhoneResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessDeletePhoneResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessDeletePhoneResult>
</PinlessDeletePhoneResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?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/
<soap12:Body>
<PinlessDeletePhone xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<MID>string</MID>
<TID>string</TID>
<Password>string</Password>
<Cashier>string</Cashier>
<AccountNumber>string</AccountNumber>
<SecondaryPhone>string</SecondaryPhone>
<TransactionMode>string</TransactionMode>
</PinlessDeletePhone>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

Copyright 2008 Pinserve Technologies

Document Version 1.7

75

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<?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/
<soap12:Body>
<PinlessDeletePhoneResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<PinlessDeletePhoneResult>
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessDeletePhoneResult>
</PinlessDeletePhoneResponse>
</soap12:Body>
</soap12:Envelope>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /TransactionBroker/Broker.asmx/PinlessDeletePhone HTTP/1.1


Host: localhost
Content-Type: application/x-www-form-urlencoded
Content-Length: length
MID=string&TID=string&Password=string&Cashier=string&AccountNumber=string&SecondaryPhone=string&TransactionMode=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PinlessTransactionResponse xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>string</ErrorCode>
<ErrorMessage>string</ErrorMessage>
<Balance>string</Balance>
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PinlessTransactionResponse>

Copyright 2008 Pinserve Technologies

Document Version 1.7

76

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.01:
Test Execution: DoTopUp

Copyright 2008 Pinserve Technologies

Document Version 1.7

77

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PIN xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>511</TransactionID>
<ProductDenomination>12.34</ProductDenomination>
<ProductSBT>106569</ProductSBT>
<ItemFK>320005-000</ItemFK>
<TransactionMode>T</TransactionMode>
<ProductDescription>DIGICEL HAITI TOP-UP $ (EP)</ProductDescription>
<ProductType>1</ProductType>
<Barcode>100320005003</Barcode>
<Instructions>1) Text this PIN number to your family or friend in Haiti. 2) Tell them to topup as normal.</Instructions>
<PrinterDisclaimer>Customer service number: (509) 711-7626</PrinterDisclaimer>
<ToppedUpNumber>5091234567</ToppedUpNumber>
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Blackstone Calling Card, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For more
detail on rates and other charges, please consult the customer service. Blackstone is
not responsible for lost or stolen pins and changes in the rates by service provider.
Safeguard your PIN; you are responsible for any unauthorized use, loss or theft. Card
is not rechargeable. Card is not refundable or exchangeable (ALL SALES ARE FINAL)
unless defective. Network services are provided by unaffiliated carriers in accordance
with tariffs on file with appropriate government agencies. Blackstone Calling Card, Inc.
does not provide telecommunications services and operates as a distributor of
discount calling cards and other pre-paid products. Neither card provider, network
provider nor Blackstone ('Distributor') make any warranty, express or implied,
regarding the condition or fitness of the services offered for any particular use or
purpose. The Distributors liability shall be limited to: direct damages for personal or
property injury, and for all other claims, an amount equal to the value of this Card. In
no event will the Distributor be liable for PUNITIVE, SPECIAL, INDIRECT, RELIANCE,
INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive remedy for all disputes
against Distributor arising out of purchase or use of Card, except for matters taken to
small claims court, is arbitration by a single arbitrator under the Consumer Arbitration
Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR WILL NOT BE HEARD BY A JURY
OR IN A COURT AND MAY NOT BE MADE PART OF A CLASS ACTION. Card may be
deactivated without notice if fraud is reasonably suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

78

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.02:
Test Execution: GetAllDestinations

Copyright 2008 Pinserve Technologies

Document Version 1.7

79

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <ArrayOfAnyType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
+ <anyType xsi:type="Destination">
+ <anyType xsi:type="Destination">
- <anyType xsi:type="Destination">
<DestinationID>7</DestinationID>
<CountryName>ALBANIA</CountryName>
<CityName />
<CountrySpanish>ALBANIA</CountrySpanish>
<CitySpanish />
<DestinationType>1</DestinationType>
<DestinationTypeDesc>COUNTRY</DestinationTypeDesc>
<DestinationTypeOrder>1</DestinationTypeOrder>
</anyType>
- <anyType xsi:type="Destination">
<DestinationID>791</DestinationID>
<CountryName>ALBANIA</CountryName>
<CityName>CELLULAR</CityName>
<CountrySpanish>ALBANIA</CountrySpanish>
<CitySpanish>CELULAR</CitySpanish>
<DestinationType>4</DestinationType>
<DestinationTypeDesc>CELLULAR</DestinationTypeDesc>
<DestinationTypeOrder>2</DestinationTypeOrder>
</anyType>
- <anyType xsi:type="Destination">
<DestinationID>836</DestinationID>
<CountryName>ALBANIA</CountryName>
<CityName>TIRANA</CityName>
<CountrySpanish>ALBANIA</CountrySpanish>
<CitySpanish>TIRANA</CitySpanish>
<DestinationType>2</DestinationType>
<DestinationTypeDesc>MAJOR CITY</DestinationTypeDesc>
<DestinationTypeOrder>3</DestinationTypeOrder>
</anyType>
- <anyType xsi:type="Destination">
<DestinationID>8</DestinationID>
<CountryName>ALGERIA</CountryName>
<CityName />
<CountrySpanish>ARGELIA</CountrySpanish>
<CitySpanish />
<DestinationType>1</DestinationType>
<DestinationTypeDesc>COUNTRY</DestinationTypeDesc>
<DestinationTypeOrder>1</DestinationTypeOrder>
</anyType>
- <anyType xsi:type="Destination">
<DestinationID>9</DestinationID>
<CountryName>ALGERIA</CountryName>
<CityName>ALGIERS</CityName>
<CountrySpanish>ARGELIA</CountrySpanish>
<CitySpanish>ALGER</CitySpanish>
<DestinationType>2</DestinationType>
<DestinationTypeDesc>MAJOR CITY</DestinationTypeDesc>
<DestinationTypeOrder>3</DestinationTypeOrder>
</anyType>
- <anyType xsi:type="Destination">
<DestinationID>10</DestinationID>
Copyright 2008 Pinserve Technologies

Document Version 1.7

80

Pinserve Web Services API Implementation Guide.

+
+
+
+
+
+
+
+
+
+
+
-

API Version 2.3.3

<CountryName>AMERICAN SAMOA</CountryName>
<CityName />
<CountrySpanish>SAMOA AMERICANA</CountrySpanish>
<CitySpanish />
<DestinationType>1</DestinationType>
<DestinationTypeDesc>COUNTRY</DestinationTypeDesc>
<DestinationTypeOrder>1</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>837</DestinationID>
<CountryName>AMERICAN SAMOA</CountryName>
<CityName>CELLULAR</CityName>
<CountrySpanish>SAMOA AMERICANA</CountrySpanish>
<CitySpanish>CELULAR</CitySpanish>
<DestinationType>4</DestinationType>
<DestinationTypeDesc>CELLULAR</DestinationTypeDesc>
<DestinationTypeOrder>2</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<DestinationID>18</DestinationID>
<CountryName>ARGENTINA</CountryName>
<CityName />
<CountrySpanish>ARGENTINA</CountrySpanish>
<CitySpanish />
<DestinationType>1</DestinationType>
<DestinationTypeDesc>COUNTRY</DestinationTypeDesc>
<DestinationTypeOrder>1</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>19</DestinationID>
<CountryName>ARGENTINA</CountryName>
<CityName>BUENOS AIRES</CityName>
<CountrySpanish>ARGENTINA</CountrySpanish>
<CitySpanish>BUENOS AIRES</CitySpanish>
<DestinationType>2</DestinationType>
<DestinationTypeDesc>MAJOR CITY</DestinationTypeDesc>
<DestinationTypeOrder>3</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>21</DestinationID>
<CountryName>ARGENTINA</CountryName>
<CityName>CELLULAR</CityName>
<CountrySpanish>ARGENTINA</CountrySpanish>
<CitySpanish>CELULAR</CitySpanish>
<DestinationType>4</DestinationType>
<DestinationTypeDesc>CELLULAR</DestinationTypeDesc>

Copyright 2008 Pinserve Technologies

Document Version 1.7

81

Pinserve Web Services API Implementation Guide.

+
+
+
+
+
+
+
+
+
-

API Version 2.3.3

<DestinationTypeOrder>2</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>23</DestinationID>
<CountryName>ARGENTINA</CountryName>
<CityName>MENDOZA</CityName>
<CountrySpanish>ARGENTINA</CountrySpanish>
<CitySpanish>MENDOZA</CitySpanish>
<DestinationType>2</DestinationType>
<DestinationTypeDesc>MAJOR CITY</DestinationTypeDesc>
<DestinationTypeOrder>3</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<DestinationID>32</DestinationID>
<CountryName>AUSTRALIA</CountryName>
<CityName />
<CountrySpanish>AUSTRALIA</CountrySpanish>
<CitySpanish />
<DestinationType>1</DestinationType>
<DestinationTypeDesc>COUNTRY</DestinationTypeDesc>
<DestinationTypeOrder>1</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>36</DestinationID>
<CountryName>AUSTRALIA</CountryName>
<CityName>CELLULAR</CityName>
<CountrySpanish>AUSTRALIA</CountrySpanish>
<CitySpanish>CELULAR</CitySpanish>
<DestinationType>4</DestinationType>
<DestinationTypeDesc>CELLULAR</DestinationTypeDesc>
<DestinationTypeOrder>2</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>37</DestinationID>
<CountryName>AUSTRALIA</CountryName>
<CityName>MELBOURNE</CityName>
<CountrySpanish>AUSTRALIA</CountrySpanish>
<CitySpanish>MELBOURNE</CitySpanish>
<DestinationType>3</DestinationType>
<DestinationTypeDesc>CITY</DestinationTypeDesc>
<DestinationTypeOrder>4</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>40</DestinationID>
<CountryName>AUSTRALIA</CountryName>
<CityName>SYDNEY</CityName>
<CountrySpanish>AUSTRALIA</CountrySpanish>
<CitySpanish>SYDNEY</CitySpanish>

Copyright 2008 Pinserve Technologies

Document Version 1.7

82

Pinserve Web Services API Implementation Guide.

+
+
+
+
-

API Version 2.3.3

<DestinationType>2</DestinationType>
<DestinationTypeDesc>MAJOR CITY</DestinationTypeDesc>
<DestinationTypeOrder>3</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>41</DestinationID>
<CountryName>AUSTRIA</CountryName>
<CityName />
<CountrySpanish>AUSTRIA</CountrySpanish>
<CitySpanish />
<DestinationType>1</DestinationType>
<DestinationTypeDesc>COUNTRY</DestinationTypeDesc>
<DestinationTypeOrder>1</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>42</DestinationID>
<CountryName>AUSTRIA</CountryName>
<CityName>CELLULAR</CityName>
<CountrySpanish>AUSTRIA</CountrySpanish>
<CitySpanish>CELULAR</CitySpanish>
<DestinationType>4</DestinationType>
<DestinationTypeDesc>CELLULAR</DestinationTypeDesc>
<DestinationTypeOrder>2</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>44</DestinationID>
<CountryName>AUSTRIA</CountryName>
<CityName>VIENNA</CityName>
<CountrySpanish>AUSTRIA</CountrySpanish>
<CitySpanish>VIENA</CitySpanish>
<DestinationType>2</DestinationType>
<DestinationTypeDesc>MAJOR CITY</DestinationTypeDesc>
<DestinationTypeOrder>3</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<anyType xsi:type="Destination">
<DestinationID>48</DestinationID>
<CountryName>BAHAMAS</CountryName>
<CityName />
<CountrySpanish>BAHAMAS</CountrySpanish>
<CitySpanish />
<DestinationType>1</DestinationType>
<DestinationTypeDesc>COUNTRY</DestinationTypeDesc>
<DestinationTypeOrder>1</DestinationTypeOrder>
</anyType>
<anyType xsi:type="Destination">
<DestinationID>980</DestinationID>
<CountryName>BAHAMAS</CountryName>
<CityName>CELLULAR</CityName>
<CountrySpanish>BAHAMAS</CountrySpanish>
<CitySpanish>CELULAR</CitySpanish>
<DestinationType>4</DestinationType>
<DestinationTypeDesc>CELLULAR</DestinationTypeDesc>
<DestinationTypeOrder>2</DestinationTypeOrder>

Copyright 2008 Pinserve Technologies

Document Version 1.7

83

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.03:
Test Execution: GetLegalInformation

Copyright 2008 Pinserve Technologies

Document Version 1.7

84

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <Legal xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Blackstone Calling Card, Inc. All Rights Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to change
without prior notice at the discretion of the network service provider. For more detail on
rates and other charges, please consult the customer service. Blackstone is not
responsible for lost or stolen pins and changes in the rates by service provider. Safeguard
your PIN; you are responsible for any unauthorized use, loss or theft. Card is not
rechargeable. Card is not refundable or exchangeable (ALL SALES ARE FINAL) unless
defective. Network services are provided by unaffiliated carriers in accordance with tariffs
on file with appropriate government agencies. Blackstone Calling Card, Inc. does not
provide telecommunications services and operates as a distributor of discount calling
cards and other pre-paid products. Neither card provider, network provider nor
Blackstone ('Distributor') make any warranty, express or implied, regarding the condition
or fitness of the services offered for any particular use or purpose. The Distributors
liability shall be limited to: direct damages for personal or property injury, and for all
other claims, an amount equal to the value of this Card. In no event will the Distributor be
liable for PUNITIVE, SPECIAL, INDIRECT, RELIANCE, INCIDENTAL OR CONSEQUENTIAL
DAMAGES. The exclusive remedy for all disputes against Distributor arising out of
purchase or use of Card, except for matters taken to small claims court, is arbitration by a
single arbitrator under the Consumer Arbitration Rules of the AAA. DISPUTES AGAINST
DISTRIBUTOR WILL NOT BE HEARD BY A JURY OR IN A COURT AND MAY NOT BE MADE
PART OF A CLASS ACTION. Card may be deactivated without notice if fraud is reasonably
suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</Legal>

Copyright 2008 Pinserve Technologies

Document Version 1.7

85

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.04:
Test Execution: GetMultiplePIN

Copyright 2008 Pinserve Technologies

Document Version 1.7

86

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <ArrayOfAnyType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>245</TransactionID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
<ControlNumber>331052/1234567890</ControlNumber>
<ProductSBT>106163</ProductSBT>
<Conn800English>1877-493-9973</Conn800English>
<CustomerServiceEnglish>1877-493-9974</CustomerServiceEnglish>
+ <LocalAccessPhones>
<ItemFK>300930-005</ItemFK>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE FL $ 5 (EP)</ProductDescription>
<Batch>331052</Batch>
<ExpirationDate>06/19/09</ExpirationDate>
<ProductType>0</ProductType>
<Barcode>100300930059</Barcode>
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Blackstone Calling Card, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For
more detail on rates and other charges, please consult the customer service.
Blackstone is not responsible for lost or stolen pins and changes in the rates by
service provider. Safeguard your PIN; you are responsible for any unauthorized use,
loss or theft. Card is not rechargeable. Card is not refundable or exchangeable (ALL
SALES ARE FINAL) unless defective. Network services are provided by unaffiliated
carriers in accordance with tariffs on file with appropriate government agencies.
Blackstone Calling Card, Inc. does not provide telecommunications services and
operates as a distributor of discount calling cards and other pre-paid products. Neither
card provider, network provider nor Blackstone ('Distributor') make any warranty,
express or implied, regarding the condition or fitness of the services offered for any
particular use or purpose. The Distributors liability shall be limited to: direct damages
for personal or property injury, and for all other claims, an amount equal to the value
of this Card. In no event will the Distributor be liable for PUNITIVE, SPECIAL,
INDIRECT, RELIANCE, INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive
remedy for all disputes against Distributor arising out of purchase or use of Card,
except for matters taken to small claims court, is arbitration by a single arbitrator
under the Consumer Arbitration Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR
WILL NOT BE HEARD BY A JURY OR IN A COURT AND MAY NOT BE MADE PART OF A
CLASS ACTION. Card may be deactivated without notice if fraud is reasonably
suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
<Instructions>Call provided toll free or local access number, enter PIN when prompted,
follow instructions; or call customer service for further help.</Instructions>
<PrinterDisclaimer>Prices, fees, availability, terms of use and rates are subject to change

Copyright 2008 Pinserve Technologies

Document Version 1.7

87

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

without prior notice at the discretion of the network service provider. For more detail on
rates and other charges, please consult the customer service.</PrinterDisclaimer>
</anyType>
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>245</TransactionID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
<ControlNumber>331052/1234567890</ControlNumber>
<ProductSBT>106163</ProductSBT>
<Conn800English>1877-493-9973</Conn800English>
<CustomerServiceEnglish>1877-493-9974</CustomerServiceEnglish>
+ <LocalAccessPhones>
<ItemFK>300930-005</ItemFK>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE FL $ 5 (EP)</ProductDescription>
<Batch>331052</Batch>
<ExpirationDate>06/19/09</ExpirationDate>
<ProductType>0</ProductType>
<Barcode>100300930059</Barcode>
+ <LegalInfo>
<Instructions>Call provided toll free or local access number, enter PIN when prompted,
follow instructions; or call customer service for further help.</Instructions>
<PrinterDisclaimer>Prices, fees, availability, terms of use and rates are subject to change
without prior notice at the discretion of the network service provider. For more detail on
rates and other charges, please consult the customer service.</PrinterDisclaimer>
</anyType>
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

88

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.05:
Test Execution: GetMultiplePINLite

Copyright 2008 Pinserve Technologies

Document Version 1.7

89

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <ArrayOfAnyType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>1045</TransactionID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
<ControlNumber>13405/1234567890</ControlNumber>
<Conn800English>1800-710-6229</Conn800English>
<CustomerServiceEnglish>1866-221-3028</CustomerServiceEnglish>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE #1 ADMA $ 5</ProductDescription>
</anyType>
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>1045</TransactionID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
<ControlNumber>13405/1234567890</ControlNumber>
<Conn800English>1800-710-6229</Conn800English>
<CustomerServiceEnglish>1866-221-3028</CustomerServiceEnglish>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE #1 ADMA $ 5</ProductDescription>
</anyType>
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>1045</TransactionID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
<ControlNumber>13405/1234567890</ControlNumber>
<Conn800English>1800-710-6229</Conn800English>
<CustomerServiceEnglish>1866-221-3028</CustomerServiceEnglish>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE #1 ADMA $ 5</ProductDescription>
</anyType>
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>1045</TransactionID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
<ControlNumber>13405/1234567890</ControlNumber>
<Conn800English>1800-710-6229</Conn800English>
<CustomerServiceEnglish>1866-221-3028</CustomerServiceEnglish>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE #1 ADMA $ 5</ProductDescription>
</anyType>
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>1045</TransactionID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
Copyright 2008 Pinserve Technologies

Document Version 1.7

90

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<ControlNumber>13405/1234567890</ControlNumber>
<Conn800English>1800-710-6229</Conn800English>
<CustomerServiceEnglish>1866-221-3028</CustomerServiceEnglish>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE #1 ADMA $ 5</ProductDescription>
</anyType>
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

91

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.06:
Test Execution: GetProductAccessPhones

Copyright 2008 Pinserve Technologies

Document Version 1.7

92

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <ArrayOfAnyType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
- <anyType xsi:type="AccessPhone">
<State />
<City>NATIONWIDE TOLL FREE</City>
<Phone>8774939973</Phone>
<AccessLanguage />
<AccessType>NATIONWIDE 800 ACCESS</AccessType>
<AreaCode>877</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>BIG PINE</City>
<Phone>3056472024</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>305</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>BOCA RATON</City>
<Phone>5618071086</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>561</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>CLEARWATER</City>
<Phone>7272131097</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>727</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>COCOA BEACH</City>
<Phone>3218062011</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>321</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>FORT LAUDERDALE</City>
<Phone>9543430927</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>954</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>FORT LAUDERDALE</City>
<Phone>9546781335</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
Copyright 2008 Pinserve Technologies

Document Version 1.7

93

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<AreaCode>954</AreaCode>
</anyType>
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>GAINESVILLE</City>
<Phone>3525057921</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>352</AreaCode>
</anyType>
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>INDIANTOWN</City>
<Phone>7729330023</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>772</AreaCode>
</anyType>
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>JACKSONVILLE</City>
<Phone>9043025933</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>904</AreaCode>
</anyType>
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>KEY LARGO</City>
<Phone>3057355102</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>305</AreaCode>
</anyType>
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>KEY WEST</City>
<Phone>3056472024</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>305</AreaCode>
</anyType>
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>KISSIMMEE</City>
<Phone>4077053319</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>407</AreaCode>
</anyType>
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>LAKE CITY</City>
<Phone>3862694343</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>386</AreaCode>

Copyright 2008 Pinserve Technologies

Document Version 1.7

94

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>LAKELAND</City>
<Phone>8638080516</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>863</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>MIAMI</City>
<Phone>3053570257</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>305</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>NAPLES</City>
<Phone>2399632104</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>239</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>ORANGE CITY</City>
<Phone>3869513987</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>386</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>ORLANDO</City>
<Phone>3214736125</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>321</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>PORT SAINT LUCIE</City>
<Phone>7729050044</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>772</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>SAINT PETERSBURG</City>
<Phone>7272141395</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>727</AreaCode>
</anyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

95

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>SARASOTA</City>
<Phone>9418661275</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>941</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>TALLAHASSEE</City>
<Phone>5803912516</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>580</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>TAMPA</City>
<Phone>8132831497</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>813</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>TOLL FREE</City>
<Phone>8774939973</Phone>
<AccessLanguage />
<AccessType>STATEWIDE 800 ACCESS</AccessType>
<AreaCode>877</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>VERO BEACH</City>
<Phone>7729070033</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>772</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>WEST PALM BEACH</City>
<Phone>5612821227</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>561</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>WINTER HAVEN</City>
<Phone>8638771607</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>863</AreaCode>
</anyType>
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

96

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.07:
Test Execution: GetProductProfiles

Copyright 2008 Pinserve Technologies

Document Version 1.7

97

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <ArrayOfAnyType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
- <anyType xsi:type="Catalog">
<ProfileID>24</ProfileID>
<ProfileName>ATLANTA</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>ATLANTA</ProfileRegion>
<ProfileState>GA</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>69</ProfileID>
<ProfileName>BOSTON, MA</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>BOSTON</ProfileRegion>
<ProfileState>MA</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>62</ProfileID>
<ProfileName>CALIFORNIA</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>CA</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>91</ProfileID>
<ProfileName>CAROLINA, N/S</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion>NORTH, SOUTH</ProfileRegion>
<ProfileState />
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>29</ProfileID>
<ProfileName>CHICAGO</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>CHICAGO</ProfileRegion>
<ProfileState>IL</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>95</ProfileID>
<ProfileName>CONNECTICUT</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>CT</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
Copyright 2008 Pinserve Technologies

Document Version 1.7

98

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

- <anyType xsi:type="Catalog">
<ProfileID>67</ProfileID>
<ProfileName>DALLAS, TX</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>DALLAS</ProfileRegion>
<ProfileState>TX</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>61</ProfileID>
<ProfileName>DC-MD & VA</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>WASHINGTON AREA</ProfileRegion>
<ProfileState>DC</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>39</ProfileID>
<ProfileName>FLORIDA</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>FL</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>15</ProfileID>
<ProfileName>GENERIC</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>US</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>16</ProfileID>
<ProfileName>LAS VEGAS, NV</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>LAS VEGAS</ProfileRegion>
<ProfileState>NV</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>64</ProfileID>
<ProfileName>LOS ANGELES, CA</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>LOS ANGELES</ProfileRegion>
<ProfileState>CA</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>87</ProfileID>
<ProfileName>MICHIGAN</ProfileName>

Copyright 2008 Pinserve Technologies

Document Version 1.7

99

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<ProfileDescription>W/ 1-800</ProfileDescription>
<ProfileRegion />
<ProfileState>MI</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
<anyType xsi:type="Catalog">
<ProfileID>18</ProfileID>
<ProfileName>NAPLES-FL</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>NAPLES</ProfileRegion>
<ProfileState>FL</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
<anyType xsi:type="Catalog">
<ProfileID>20</ProfileID>
<ProfileName>NEW JERSEY</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion />
<ProfileState>NJ</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
<anyType xsi:type="Catalog">
<ProfileID>12</ProfileID>
<ProfileName>NEW ORLEANS, LA</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>LA</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
<anyType xsi:type="Catalog">
<ProfileID>17</ProfileID>
<ProfileName>NEW YORK CITY</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>NEW YORK CITY</ProfileRegion>
<ProfileState>NY</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
<anyType xsi:type="Catalog">
<ProfileID>108</ProfileID>
<ProfileName>OH / KY</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>OH</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
<anyType xsi:type="Catalog">
<ProfileID>9</ProfileID>
<ProfileName>ORLANDO-FL</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>ORLANDO</ProfileRegion>
<ProfileState>FL</ProfileState>

Copyright 2008 Pinserve Technologies

Document Version 1.7

100

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>4</ProfileID>
<ProfileName>PENNSYLVANIA</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>PA</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>104</ProfileID>
<ProfileName>RHODE ISLAND</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>RI</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>7</ProfileID>
<ProfileName>SOUTH FLORIDA</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>SOUTH FLORIDA</ProfileRegion>
<ProfileState>FL</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>25</ProfileID>
<ProfileName>TAMPA</ProfileName>
<ProfileDescription>W/LOCAL ACCESS</ProfileDescription>
<ProfileRegion>TAMPA</ProfileRegion>
<ProfileState>FL</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
- <anyType xsi:type="Catalog">
<ProfileID>56</ProfileID>
<ProfileName>TEXAS</ProfileName>
<ProfileDescription>W/1-800"S</ProfileDescription>
<ProfileRegion />
<ProfileState>TX</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
</anyType>
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

101

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.08:
Test Execution: GetProductsCatalog

Copyright 2008 Pinserve Technologies

Document Version 1.7

102

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <Catalog xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<ProfileID>15</ProfileID>
<ProfileName>GENERIC</ProfileName>
<ProfileDescription>W/1-800'S</ProfileDescription>
<ProfileRegion />
<ProfileState>US</ProfileState>
<ProfileType>5</ProfileType>
<ProfileTypeDesc>TOUCH & BUY</ProfileTypeDesc>
- <ProductList>
- <anyType xsi:type="Product">
<CardID>2283</CardID>
<ProductMaincode>300384</ProductMaincode>
<AvailableDenominations>$5, $10, $20</AvailableDenominations>
- <Denominations>
- <anyType xsi:type="Denomination">
<DenominationID>103992</DenominationID>
<DenominationCode>300384-005</DenominationCode>
<DenominationValue>5.0000</DenominationValue>
<DenominationBarcode>035770070052</DenominationBarcode>
</anyType>
- <anyType xsi:type="Denomination">
<DenominationID>103994</DenominationID>
<DenominationCode>300384-010</DenominationCode>
<DenominationValue>10.0000</DenominationValue>
<DenominationBarcode>035770070106</DenominationBarcode>
</anyType>
- <anyType xsi:type="Denomination">
<DenominationID>103996</DenominationID>
<DenominationCode>300384-020</DenominationCode>
<DenominationValue>20.0000</DenominationValue>
<DenominationBarcode>035770070205</DenominationBarcode>
</anyType>
</Denominations>
<ProductName>10-17-007</ProductName>
<ProductType>0</ProductType>
<ProductTypeDesc>LONG DISTANCE</ProductTypeDesc>
<Disclaimer>Blackstone Calling Card, Inc. does not provide telecommunications
services and operates as a distributor of discount calling cards and other pre-paid
products. Minutes advertised based on one time use. Rates shown for calls
originated in the continental 48 states; calls made from AE, AK, HI, GU, PR, VI may
be charged at higher rates. For the most up to date rates and information please
call customer service for this product at: 1888-622-0387. Your phone company
may charge you for dialing local access. Total number of announced minutes is
based on a single call. No connection fee. Calls are billed in one minute upward
rounding. A maintenance fee of: $0.69 is applied after the first completed call and
every 7 days thereafter. If card is used from a payphone a compensation fee of:
$1.00 is applied. Calls made using a toll free number are billed an additional of:
$0.015 per minute. Intl rates may vary by city or cellular network. Service
provided by ADMA TELECOM Inc. Card expires on the earlier of stated expiration
date or 60 days from first use. Service only available from 48 states in US
continent. No refund for lost or stolen cards. For rate or fee inquiries, please call to
the customer service toll free number indicated in the back of the
card.</Disclaimer>
<DisclaimerSpanish>Blackstone Calling Card, Inc. no provee servicios de
Copyright 2008 Pinserve Technologies

Document Version 1.7

103

Pinserve Web Services API Implementation Guide.

+
+
+
+
+
+
+
+
+
+
+
-

API Version 2.3.3

telecomunicaciones y opera como distribuidor de tarjetas de llamadas de descuento y


otros productos prepagados. Los minutos mostrados corresponden a una sola
llamada. Las tarifas mostradas son para llamadas originadas desde los 48 estados
continentales; las llamadas hechas desde AE, AK, HI, GU, PR, VI puedes ser
cobradas a mayor tarifa. Para la informacin y tarifas ms actualizadas, por favor
comunquese con el servicio al cliente para este producto llamando a: 1888-6220387. Su compaa telefnica podra cobrarle por marcar con acceso local. El total
del nmero de minutos anunciados esta basado en una sola llamada. No hay cargos
de conexin. Las llamadas se redondean al minuto. Cargo de $0.69 aplicar al
finalizar la primera llamada y cada 7 das de ah en adelante. Un cargo de $1.00
aplicar a cada llamada de un telfono pblico. Llamadas efectuadas desde un
nmero de acceso gratuito sern sujetas a un cargo adicional de $0.015 por
minuto. Tarifas internacionales varan de acuerdo a la ciudad o red celular. Servicio
prestado por ADMA TELECOM, Inc. La tarjeta expira en la fecha de caducidad o
despus de 60 das de haber efectuado la primera llamada. Servicio solo disponible
desde los 48 estados del continente americano. No hay reembolsos por tarjetas
perdidas o robadas. Para informacin sobre cargos o tarifas, favor contactar al
servicio de atencin al cliente al nmero gratuito indicado en el respaldo de la
tarjeta.</DisclaimerSpanish>
<Carrier>ADMA TELECOM INC</Carrier>
<RecommendedUse>S</RecommendedUse>
<Searchable>Y</Searchable>
<AccessType>28</AccessType>
<AccessTypeDesc>LOCAL & TOLL FREE ACCESS</AccessTypeDesc>
<Instructions>Call provided toll free number or local access number, enter PIN when
prompted, follow instructions; or call customer service for
assistance.</Instructions>
<PrinterDisclaimer>Services provided by ADMA TELECOM INC. For complete rates and
disclaimers call customer service 1888-622-0387</PrinterDisclaimer>
<ProductBarcode>100300384005</ProductBarcode>
<TargetCountry>UNITED STATES</TargetCountry>
<CountryCode>US</CountryCode>
<TopUpMinAmount>0.0000</TopUpMinAmount>
<TopUpMaxAmount>0.0000</TopUpMaxAmount>
</anyType>
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<CardID>3111</CardID>
<ProductMaincode>320081</ProductMaincode>
<AvailableDenominations />
<ProductName>ACOS TOPUP RUSSIA</ProductName>
<ProductType>1</ProductType>
<ProductTypeDesc>TOP-UP</ProductTypeDesc>
<Disclaimer>Please Note: Load amount must be in these amounts only: $5, $9, $15,
$20, $25, $30, $50, or $99 otherwise the transaction will not complete. This TopUp will only add value and airtime (Balance) to a pre-paid phone in designated
country that you have selected under Transfer To. Cellular service, charges, and
rates are established and provided by the operator in the selected country. Top-Up
funds are non-refundable. You are solely responsible for lost, stolen or

Copyright 2008 Pinserve Technologies

Document Version 1.7

104

Pinserve Web Services API Implementation Guide.

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-

API Version 2.3.3

inappropriate use of this Top-Up. Upon activation, any promotional balance on Top-Up
is valid for period of time described by each operator. Number of minutes and text
messages may vary according to the combination of destinations. Caller pays for all
calls made via the balance contained on Top-Up. Vierge Group and Transfer To
reserves the right to change or terminate these terms at any time without notice.
2008 Vierge Telecom Corp & Transfer To. All rights reserved. Complete terms
and conditions are available at 1866-687-2160 and Technical support toll free
1866-687-2160</Disclaimer>
<DisclaimerSpanish>Please Note: Load amount must be in these amounts only: $5, $9,
$15, $20, $25, $30, $50, or $99 otherwise the transaction will not complete. This
Top-Up will only add value and airtime (Balance) to a pre-paid phone in
designated country that you have selected under Transfer To. Cellular service,
charges, and rates are established and provided by the operator in the selected
country. Top-Up funds are non-refundable. You are solely responsible for lost,
stolen or inappropriate use of this Top-Up. Upon activation, any promotional
balance on Top-Up is valid for period of time described by each operator. Number
of minutes and text messages may vary according to the combination of
destinations. Caller pays for all calls made via the balance contained on Top-Up.
Vierge Group and Transfer To reserves the right to change or terminate these
terms at any time without notice. 2008 Vierge Telecom Corp & Transfer To. All
rights reserved. Complete terms and conditions are available at 1866-687-2160
and Technical support toll free 1866-687-2160</DisclaimerSpanish>
<Carrier>ACOS</Carrier>
<RecommendedUse>S</RecommendedUse>
<Searchable>N</Searchable>
<AccessType>27</AccessType>
<AccessTypeDesc>TOLL FREE ACCESS</AccessTypeDesc>
<Instructions>Call provided toll free number or local access number, enter PIN when
prompted, follow instructions; or call customer service for
assistance.</Instructions>
<PrinterDisclaimer>Services provided by ACOS. For complete rates and disclaimers call
customer service 1866-687-2160</PrinterDisclaimer>
<ProductBarcode>100320081007</ProductBarcode>
<TargetCountry>RUSSIAN FEDERATION</TargetCountry>
<CountryCode>RU</CountryCode>
<TopUpMinAmount>3.0000</TopUpMinAmount>
<TopUpMaxAmount>70.0000</TopUpMaxAmount>
</anyType>
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<CardID>2428</CardID>
<ProductMaincode>300549</ProductMaincode>

Copyright 2008 Pinserve Technologies

Document Version 1.7

105

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<AvailableDenominations>$5, $10, $20</AvailableDenominations>


- <Denominations>
- <anyType xsi:type="Denomination">
<DenominationID>104949</DenominationID>
<DenominationCode>300549-005</DenominationCode>
<DenominationValue>5.0000</DenominationValue>
<DenominationBarcode>086140302051</DenominationBarcode>
</anyType>
- <anyType xsi:type="Denomination">
<DenominationID>104951</DenominationID>
<DenominationCode>300549-010</DenominationCode>
<DenominationValue>10.0000</DenominationValue>
<DenominationBarcode>086140302105</DenominationBarcode>
</anyType>
- <anyType xsi:type="Denomination">
<DenominationID>104953</DenominationID>
<DenominationCode>300549-020</DenominationCode>
<DenominationValue>20.0000</DenominationValue>
<DenominationBarcode>086140302204</DenominationBarcode>
</anyType>
</Denominations>
<ProductName>BLACKSTONE #1</ProductName>
<ProductType>0</ProductType>
<ProductTypeDesc>LONG DISTANCE</ProductTypeDesc>
<Disclaimer>Blackstone Calling Card, Inc. does not provide telecommunications
services and operates as a distributor of discount calling cards and other pre-paid
products. Minutes advertised based on one time use. Rates shown for calls
originated in the continental 48 states; calls made from AE, AK, HI, GU, PR, VI may
be charged at higher rates. For the most up to date rates and information please
call customer service for this product at: 1866-221-3028. Your phone company
may charge you for dialing local access. Total number of announced minutes is
based on a single call. $0.39 connection fee. Calls are billed in one minute upward
rounding. A maintenance fee of $0.69 is applied after the first completed call and
every 7 days thereafter. If card is used from a payphone a compensation fee of
$1.00 is applied. Calls made using a toll free number are billed an additional of:
$0.015 per minute. Intl rates may vary by city or cellular network. Service
provided by ADMA TELECOM Inc. Card expires on the earlier of stated expiration
date or 60 days from first use. Service only available from 48 states in US
continent. No refund for lost or stolen cards. For rate or fee inquiries, please call to
the customer service toll free number indicated in the back of the
card.</Disclaimer>
<DisclaimerSpanish>Blackstone Calling Card, Inc. no provee servicios de
telecomunicaciones y opera como distribuidor de tarjetas de llamadas de
descuento y otros productos prepagados. Los minutos mostrados corresponden a
una sola llamada. Las tarifas mostradas son para llamadas originadas desde los 48
estados continentales; las llamadas hechas desde AE, AK, HI, GU, PR, VI puedes
ser cobradas a mayor tarifa. Para la informacin y tarifas ms actualizadas, por
favor comunquese con el servicio al cliente para este producto llamando a: 1866221-3028. Su compaa telefnica podra cobrarle por marcar con acceso local. El
total del nmero de minutos anunciados esta basado en una sola llamada. Cargo de
conexin $0.39. Las llamadas se redondean al minuto. Cargo de mantenimiento de
$0.69 aplicar al finalizar la primera llamada y cada 7 das de ah en adelante. Un
cargo de $1.00 aplicar a cada llamada de un telfono pblico. Llamadas
efectuadas desde un nmero de acceso gratuito sern sujetas a un cargo adicional
de $0.015 por minuto. Tarifas internacionales varan de acuerdo a la ciudad o red
celular. Servicio prestado por ADMA TELECOM, Inc. La tarjeta expira en la fecha de
caducidad o despus de 60 das de haber efectuado la primera llamada. Servicio
solo disponible desde los 48 estados del continente americano. No hay reembolsos
por tarjetas perdidas o robadas. Para informacin sobre cargos o tarifas, favor
contactar al servicio de atencin al cliente al nmero gratuito indicado en el
Copyright 2008 Pinserve Technologies

Document Version 1.7

106

Pinserve Web Services API Implementation Guide.

+
+
+
+
-

API Version 2.3.3

respaldo de la tarjeta.</DisclaimerSpanish>
<Carrier>ADMA TELECOM INC</Carrier>
<RecommendedUse>L</RecommendedUse>
<Searchable>Y</Searchable>
<AccessType>27</AccessType>
<AccessTypeDesc>TOLL FREE ACCESS</AccessTypeDesc>
<Instructions>Call provided toll free number or local access number, enter PIN when
prompted, follow instructions; or call customer service for
assistance.</Instructions>
<PrinterDisclaimer>Services provided by ADMA TELECOM INC. For complete rates and
disclaimers call customer service 1866-221-3028</PrinterDisclaimer>
<ProductBarcode>086140302006</ProductBarcode>
<TargetCountry>UNITED STATES</TargetCountry>
<CountryCode>US</CountryCode>
<TopUpMinAmount>0.0000</TopUpMinAmount>
<TopUpMaxAmount>0.0000</TopUpMaxAmount>
</anyType>
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<CardID>2391</CardID>
<ProductMaincode>300468</ProductMaincode>
<AvailableDenominations>$20, $30, $50</AvailableDenominations>
- <Denominations>
- <anyType xsi:type="Denomination">
<DenominationID>104504</DenominationID>
<DenominationCode>300468-020</DenominationCode>
<DenominationValue>20.0000</DenominationValue>
<DenominationBarcode>040300530203</DenominationBarcode>
</anyType>
- <anyType xsi:type="Denomination">
<DenominationID>104506</DenominationID>
<DenominationCode>300468-030</DenominationCode>
<DenominationValue>30.0000</DenominationValue>
<DenominationBarcode>040300530302</DenominationBarcode>
</anyType>
- <anyType xsi:type="Denomination">
<DenominationID>104508</DenominationID>
<DenominationCode>300468-050</DenominationCode>
<DenominationValue>50.0000</DenominationValue>
<DenominationBarcode>040300530500</DenominationBarcode>
</anyType>
</Denominations>
<ProductName>BOOST</ProductName>
<ProductType>1</ProductType>
<ProductTypeDesc>CELLULAR CARD</ProductTypeDesc>
<Disclaimer>You will be charged for your use of the Service in accordance with the
terms of the Boost Mobile Rate Plan, as found in your Boost Mobile handset kit or
online at www.boostmobile.com. You may request a copy of this document from
Boost Mobile at any time. Customer agrees to pay Company, on a prepay basis, for
charges by Company for the Service. Customer acknowledges that chargeable time
for telephone calls and Boost 2WAY call transmissions originated by a handset
begins, when a connection is established with Company facilities. A new Boost
2WAY call is initiated by a call participant if that participant responds more than
six (6) seconds after the other party finishes its Boost Connect transmission.
Customer accepts responsibility for Airtime charges from incoming telephone calls

Copyright 2008 Pinserve Technologies

Document Version 1.7

107

Pinserve Web Services API Implementation Guide.

+
+
+
+
+
+

API Version 2.3.3

to its handset from the time that Customer responds to the call. Service charges may
apply to some service options when Customer calls the Boost Mobile Customer
Service number 1-888-BOOST-4U (1-888-266-7848). If Customer disputes any
Service charges, Customer must submit a written explanation within forty five (45)
days from the date Company charges Customer for the disputed Service. If
Company determines that an error was made with respect to any disputed Service
charges, Company shall credit Customers account in the amount of the error. If
Customer does not pay the amount in dispute owed to Company, Company may
exercise any remedies it may have under this Agreement for non-payment of
Service charges. Company reserves the right to modify any and all elements of the
Service charges at any time and each such modification shall be effective
immediately upon the Companys communication thereof to Customer, unless the
Companys communication indicates a later effective date with respect to such
modification.</Disclaimer>
<DisclaimerSpanish>You will be charged for your use of the Service in accordance with
the terms of the Boost Mobile Rate Plan, as found in your Boost Mobile handset kit
or online at www.boostmobile.com. You may request a copy of this document from
Boost Mobile at any time. Customer agrees to pay Company, on a prepay basis, for
charges by Company for the Service. Customer acknowledges that chargeable time
for telephone calls and Boost 2WAY call transmissions originated by a handset
begins, when a connection is established with Company facilities. A new Boost
2WAY call is initiated by a call participant if that participant responds more than
six (6) seconds after the other party finishes its Boost Connect transmission.
Customer accepts responsibility for Airtime charges from incoming telephone calls
to its handset from the time that Customer responds to the call. Service charges
may apply to some service options when Customer calls the Boost Mobile Customer
Service number 1-888-BOOST-4U (1-888-266-7848). If Customer disputes any
Service charges, Customer must submit a written explanation within forty five (45)
days from the date Company charges Customer for the disputed Service. If
Company determines that an error was made with respect to any disputed Service
charges, Company shall credit Customers account in the amount of the error. If
Customer does not pay the amount in dispute owed to Company, Company may
exercise any remedies it may have under this Agreement for non-payment of
Service charges. Company reserves the right to modify any and all elements of the
Service charges at any time and each such modification shall be effective
immediately upon the Companys communication thereof to Customer, unless the
Companys communication indicates a later effective date with respect to such
modification.</DisclaimerSpanish>
<Carrier>BOOST</Carrier>
<RecommendedUse>S</RecommendedUse>
<Searchable>Y</Searchable>
<AccessType>27</AccessType>
<AccessTypeDesc>TOLL FREE ACCESS</AccessTypeDesc>
<Instructions>1. Dial ADD (233) from your mobile phone 2. Press Send 3. Enter
PIN</Instructions>
<PrinterDisclaimer>Customer Service: 1-888-266-7848. Service subject to Boost
Mobile terms & conditions. See www.boostmobile.com or contact customer service
for more info. ABSOLUTELY NO REFUNDS</PrinterDisclaimer>
<ProductBarcode>040300530005</ProductBarcode>
<TargetCountry>UNITED STATES</TargetCountry>
<CountryCode>US</CountryCode>
<TopUpMinAmount>0.0000</TopUpMinAmount>
<TopUpMaxAmount>0.0000</TopUpMaxAmount>
</anyType>
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">
<anyType xsi:type="Product">

Copyright 2008 Pinserve Technologies

Document Version 1.7

108

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.09:
Test Execution: GetSinglePIN

Copyright 2008 Pinserve Technologies

Document Version 1.7

109

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <ArrayOfAnyType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
- <anyType xsi:type="PIN">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>244</TransactionID>
<PinID>77090060</PinID>
<ProductDenomination>5</ProductDenomination>
<PinNumber>111111-222222-333333</PinNumber>
<ControlNumber>331052/1234567890</ControlNumber>
<ProductSBT>106163</ProductSBT>
<Conn800English>1877-493-9973</Conn800English>
<CustomerServiceEnglish>1877-493-9974</CustomerServiceEnglish>
- <LocalAccessPhones>
- <anyType xsi:type="AccessPhone">
<State />
<City>NATIONWIDE TOLL FREE</City>
<Phone>8774939973</Phone>
<AccessLanguage />
<AccessType>NATIONWIDE 800 ACCESS</AccessType>
<AreaCode>877</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>BIG PINE</City>
<Phone>3056472024</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>305</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>BOCA RATON</City>
<Phone>5618071086</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>561</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>CLEARWATER</City>
<Phone>7272131097</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>727</AreaCode>
</anyType>
- <anyType xsi:type="AccessPhone">
<State>FL</State>
<City>COCOA BEACH</City>
<Phone>3218062011</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>321</AreaCode>
</anyType>
+ <anyType xsi:type="AccessPhone">
+ <anyType xsi:type="AccessPhone">
+ <anyType xsi:type="AccessPhone">

Copyright 2008 Pinserve Technologies

Document Version 1.7

110

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<anyType xsi:type="AccessPhone">
<State>FL</State>
<City>WINTER HAVEN</City>
<Phone>8638771607</Phone>
<AccessLanguage />
<AccessType>LOCAL ACCESS</AccessType>
<AreaCode>863</AreaCode>
</anyType>
</LocalAccessPhones>
<ItemFK>300930-005</ItemFK>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE FL $ 5 (EP)</ProductDescription>
<Batch>331052</Batch>
<ExpirationDate>06/19/09</ExpirationDate>
<ProductType>0</ProductType>
<Barcode>100300930059</Barcode>
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Blackstone Calling Card, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For
more detail on rates and other charges, please consult the customer service.
Blackstone is not responsible for lost or stolen pins and changes in the rates by
service provider. Safeguard your PIN; you are responsible for any unauthorized use,
loss or theft. Card is not rechargeable. Card is not refundable or exchangeable (ALL
SALES ARE FINAL) unless defective. Network services are provided by unaffiliated
carriers in accordance with tariffs on file with appropriate government agencies.
Blackstone Calling Card, Inc. does not provide telecommunications services and
operates as a distributor of discount calling cards and other pre-paid products. Neither
card provider, network provider nor Blackstone ('Distributor') make any warranty,
express or implied, regarding the condition or fitness of the services offered for any
particular use or purpose. The Distributors liability shall be limited to: direct damages
for personal or property injury, and for all other claims, an amount equal to the value
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-

Copyright 2008 Pinserve Technologies

Document Version 1.7

111

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

of this Card. In no event will the Distributor be liable for PUNITIVE, SPECIAL, INDIRECT,
RELIANCE, INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive remedy for all
disputes against Distributor arising out of purchase or use of Card, except for matters
taken to small claims court, is arbitration by a single arbitrator under the Consumer
Arbitration Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR WILL NOT BE HEARD
BY A JURY OR IN A COURT AND MAY NOT BE MADE PART OF A CLASS ACTION. Card
may be deactivated without notice if fraud is reasonably
suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
<Instructions>Call provided toll free or local access number, enter PIN when prompted,
follow instructions; or call customer service for further help.</Instructions>
<PrinterDisclaimer>Prices, fees, availability, terms of use and rates are subject to change
without prior notice at the discretion of the network service provider. For more detail on
rates and other charges, please consult the customer service.</PrinterDisclaimer>
</anyType>
</ArrayOfAnyType>

Copyright 2008 Pinserve Technologies

Document Version 1.7

112

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.10:
Test Execution: VoidOrder

Copyright 2008 Pinserve Technologies

Document Version 1.7

113

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PIN xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Blackstone Calling Card, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For more
detail on rates and other charges, please consult the customer service. Blackstone is
not responsible for lost or stolen pins and changes in the rates by service provider.
Safeguard your PIN; you are responsible for any unauthorized use, loss or theft. Card
is not rechargeable. Card is not refundable or exchangeable (ALL SALES ARE FINAL)
unless defective. Network services are provided by unaffiliated carriers in accordance
with tariffs on file with appropriate government agencies. Blackstone Calling Card, Inc.
does not provide telecommunications services and operates as a distributor of
discount calling cards and other pre-paid products. Neither card provider, network
provider nor Blackstone ('Distributor') make any warranty, express or implied,
regarding the condition or fitness of the services offered for any particular use or
purpose. The Distributors liability shall be limited to: direct damages for personal or
property injury, and for all other claims, an amount equal to the value of this Card. In
no event will the Distributor be liable for PUNITIVE, SPECIAL, INDIRECT, RELIANCE,
INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive remedy for all disputes
against Distributor arising out of purchase or use of Card, except for matters taken to
small claims court, is arbitration by a single arbitrator under the Consumer Arbitration
Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR WILL NOT BE HEARD BY A JURY
OR IN A COURT AND MAY NOT BE MADE PART OF A CLASS ACTION. Card may be
deactivated without notice if fraud is reasonably suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

114

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.11:
Test Execution: VoidTransaction

Copyright 2008 Pinserve Technologies

Document Version 1.7

115

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PIN xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Blackstone Calling Card, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For more
detail on rates and other charges, please consult the customer service. Blackstone is
not responsible for lost or stolen pins and changes in the rates by service provider.
Safeguard your PIN; you are responsible for any unauthorized use, loss or theft. Card
is not rechargeable. Card is not refundable or exchangeable (ALL SALES ARE FINAL)
unless defective. Network services are provided by unaffiliated carriers in accordance
with tariffs on file with appropriate government agencies. Blackstone Calling Card, Inc.
does not provide telecommunications services and operates as a distributor of
discount calling cards and other pre-paid products. Neither card provider, network
provider nor Blackstone ('Distributor') make any warranty, express or implied,
regarding the condition or fitness of the services offered for any particular use or
purpose. The Distributors liability shall be limited to: direct damages for personal or
property injury, and for all other claims, an amount equal to the value of this Card. In
no event will the Distributor be liable for PUNITIVE, SPECIAL, INDIRECT, RELIANCE,
INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive remedy for all disputes
against Distributor arising out of purchase or use of Card, except for matters taken to
small claims court, is arbitration by a single arbitrator under the Consumer Arbitration
Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR WILL NOT BE HEARD BY A JURY
OR IN A COURT AND MAY NOT BE MADE PART OF A CLASS ACTION. Card may be
deactivated without notice if fraud is reasonably suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

116

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.12:
Test Execution: PinlessRecharge

Copyright 2008 Pinserve Technologies

Document Version 1.7

117

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PIN xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage />
<TransactionID>0</TransactionID>
<ProductDenomination>10</ProductDenomination>
<ProductSBT>107147</ProductSBT>
<ItemFK>320092-000</ItemFK>
<TransactionMode>T</TransactionMode>
<ProductDescription>BLACKSTONE PINLESS (EP)</ProductDescription>
<ProductType>1</ProductType>
<Barcode>100320092003</Barcode>
<ToppedUpNumber>3053053055</ToppedUpNumber>
<AccountNumber>77371</AccountNumber>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

118

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.13:
Test Execution: PinlessVoid

Copyright 2008 Pinserve Technologies

Document Version 1.7

119

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PIN xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage>Transaction Successful</ErrorMessage>
</PIN>

Copyright 2008 Pinserve Technologies

Document Version 1.7

120

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.14:
Test Execution: PinlessBalance

Copyright 2008 Pinserve Technologies

Document Version 1.7

121

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PinlessTransactionResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage>Transaction Successful</ErrorMessage>
<Balance>166.00</Balance>
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Pinserve Technologies, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For more
detail on rates and other charges, please consult the customer service. Blackstone is
not responsible for lost or stolen pins and changes in the rates by service provider.
Safeguard your PIN; you are responsible for any unauthorized use, loss or theft. Card
is not rechargeable. Card is not refundable or exchangeable (ALL SALES ARE FINAL)
unless defective. Network services are provided by unaffiliated carriers in accordance
with tariffs on file with appropriate government agencies. Blackstone Calling Card, Inc.
does not provide telecommunications services and operates as a distributor of
discount calling cards and other pre-paid products. Neither card provider, network
provider nor Blackstone ('Distributor') make any warranty, express or implied,
regarding the condition or fitness of the services offered for any particular use or
purpose. The Distributors liability shall be limited to: direct damages for personal or
property injury, and for all other claims, an amount equal to the value of this Card. In
no event will the Distributor be liable for PUNITIVE, SPECIAL, INDIRECT, RELIANCE,
INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive remedy for all disputes
against Distributor arising out of purchase or use of Card, except for matters taken to
small claims court, is arbitration by a single arbitrator under the Consumer Arbitration
Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR WILL NOT BE HEARD BY A JURY
OR IN A COURT AND MAY NOT BE MADE PART OF A CLASS ACTION. Card may be
deactivated without notice if fraud is reasonably suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
</PinlessTransactionResponse>

Copyright 2008 Pinserve Technologies

Document Version 1.7

122

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.15:
Test Execution: PinlessAddPhone

Copyright 2008 Pinserve Technologies

Document Version 1.7

123

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PinlessTransactionResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage>Transaction Successful</ErrorMessage>
<Balance />
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Pinserve Technologies, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For more
detail on rates and other charges, please consult the customer service. Blackstone is
not responsible for lost or stolen pins and changes in the rates by service provider.
Safeguard your PIN; you are responsible for any unauthorized use, loss or theft. Card
is not rechargeable. Card is not refundable or exchangeable (ALL SALES ARE FINAL)
unless defective. Network services are provided by unaffiliated carriers in accordance
with tariffs on file with appropriate government agencies. Blackstone Calling Card, Inc.
does not provide telecommunications services and operates as a distributor of
discount calling cards and other pre-paid products. Neither card provider, network
provider nor Blackstone ('Distributor') make any warranty, express or implied,
regarding the condition or fitness of the services offered for any particular use or
purpose. The Distributors liability shall be limited to: direct damages for personal or
property injury, and for all other claims, an amount equal to the value of this Card. In
no event will the Distributor be liable for PUNITIVE, SPECIAL, INDIRECT, RELIANCE,
INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive remedy for all disputes
against Distributor arising out of purchase or use of Card, except for matters taken to
small claims court, is arbitration by a single arbitrator under the Consumer Arbitration
Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR WILL NOT BE HEARD BY A JURY
OR IN A COURT AND MAY NOT BE MADE PART OF A CLASS ACTION. Card may be
deactivated without notice if fraud is reasonably suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
</PinlessTransactionResponse>

Copyright 2008 Pinserve Technologies

Document Version 1.7

124

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix C.16:
Test Execution: PinlessDeletePhone

Copyright 2008 Pinserve Technologies

Document Version 1.7

125

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

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


- <PinlessTransactionResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://services.blackstoneonline.com/TransactionBroker/Broker">
<ErrorCode>0</ErrorCode>
<ErrorMessage>Transaction Successful</ErrorMessage>
<Balance />
- <LegalInfo>
<Version>2.3.3</Version>
<Copyright>Copyright 2008 Pinserve Technologies, Inc. All Rights
Reserved</Copyright>
<Disclaimer>Blackstone is a patented distributor of phone cards & calling cards for the
purpose of international & domestic long distance phone calls. This service provides
instant calling card, phone card, and wireless recharge PINs delivered via email.
Blackstone is a pioneer in the prepaid industry and developed the Touch-n-buy
(www.touch-n-buy.com), a instant calling card & prepaid wireless delivery machine. If
you have any questions or concerns regarding your instant international phone cards,
calling cards or prepaid wireless product please contact us.</Disclaimer>
<PrivacyURL>http://www.blackstoneonline.com/contactus/privacypolicy</PrivacyURL>
<TermsAndConditions>Prices, fees, availability, terms of use and rates are subject to
change without prior notice at the discretion of the network service provider. For more
detail on rates and other charges, please consult the customer service. Blackstone is
not responsible for lost or stolen pins and changes in the rates by service provider.
Safeguard your PIN; you are responsible for any unauthorized use, loss or theft. Card
is not rechargeable. Card is not refundable or exchangeable (ALL SALES ARE FINAL)
unless defective. Network services are provided by unaffiliated carriers in accordance
with tariffs on file with appropriate government agencies. Blackstone Calling Card, Inc.
does not provide telecommunications services and operates as a distributor of
discount calling cards and other pre-paid products. Neither card provider, network
provider nor Blackstone ('Distributor') make any warranty, express or implied,
regarding the condition or fitness of the services offered for any particular use or
purpose. The Distributors liability shall be limited to: direct damages for personal or
property injury, and for all other claims, an amount equal to the value of this Card. In
no event will the Distributor be liable for PUNITIVE, SPECIAL, INDIRECT, RELIANCE,
INCIDENTAL OR CONSEQUENTIAL DAMAGES. The exclusive remedy for all disputes
against Distributor arising out of purchase or use of Card, except for matters taken to
small claims court, is arbitration by a single arbitrator under the Consumer Arbitration
Rules of the AAA. DISPUTES AGAINST DISTRIBUTOR WILL NOT BE HEARD BY A JURY
OR IN A COURT AND MAY NOT BE MADE PART OF A CLASS ACTION. Card may be
deactivated without notice if fraud is reasonably suspected.</TermsAndConditions>
<ContactPhone>1800-639-9590</ContactPhone>
</LegalInfo>
</PinlessTransactionResponse>

Copyright 2008 Pinserve Technologies

Document Version 1.7

126

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix D:
Error Codes
Error
Code
0
1

Error Getting PIN Information

Error Connecting to PINs Host

Error Initiating PIN Request Transaction

Error: Over Credit Limit.

Error: Over Maximum Daily Activity.

Invalid OrderID

Merchant is closed.

96
97
98

Error: Merchant is suspended.


Suspicious Activity.
Error: Merchant is suspended. Bad
Check.
Error: Terminal Serial Number Has
Changed
Transaction Rejected
Transaction Rejected
Transaction Rejected
Error: Merchant can not sell the
selected product.
Top Up Error (varies by product)
Invalid Product Code
Error: Invalid Terminal ID or Terminal is
not assigned to Merchant
Multiple reasons.
Invalid amount.
Error: Pin Not Available

NN

Any other error code not listed above

9
12
17
19
31
40
51
76
89

Error Description

Copyright 2008 Pinserve Technologies

Retry?

N
N
Y
Y
Y
Y
Y
Y
N
Y
Y
N
N

Document Version 1.7

Solution
OK, No error
Communication error when trying to
process PIN request, please try again
Communication error when trying to
process PIN request, please try again
Communication error when trying to
process PIN request, please try again
Problem with your Merchant account,
please contact Pinserve
Problem with your Merchant account,
please contact Pinserve
Check your own Order Identification
number passed in to the PIN request
Problem with your Merchant account,
please contact Pinserve
Problem with your Merchant account,
please contact Pinserve
Problem with your Merchant account,
please contact Pinserve
Problem with your Merchant account,
please contact Pinserve
Check request parameters
Check request parameters
Check request parameters
Product not available, please try
another
Check returned message
Check product code
Problem with your Merchant account,
please contact Pinserve
Check message
Check requested products amount
No more PINs available for requested
product, try another product
Please contact Pinserve IT
Department

127

Pinserve Web Services API Implementation Guide.

API Version 2.3.3

Appendix E:
Country Codes for Top Up Products
This is a subset of ISO 3166 country code standard. For more information and a complete
list of country codes not shown here, please refer to:
http://en.wikipedia.org/wiki/ISO_3166
CountryCode
AI
AG
AW
BB
BM
VG
BI
KY
CN
CO
DM
DR
SV
FJ
GF
GD
GP
GY
HT
HN
IN
ID
JM
LR
MQ
MX
MS
AN
NI
PK
PA
PG
PH
RU
WS
LK
KN
LC
VC

Copyright 2008 Pinserve Technologies

Country Name
ANGUILLA
ANTIGUA
ARUBA
BARBADOS
BERMUDA
BRITISH VIRGIN ISLANDS
BURUNDI
CAYMAN ISLANDS
CHINA
COLOMBIA
DOMINICA
DOMINICAN REPUBLIC
EL SALVADOR
FIJI ISLANDS
FRENCH GUIANA
GRENADA
GUADELOUPE
GUYANA
HAITI
HONDURAS
INDIA
INDONESIA
JAMAICA
LIBERIA
MARTINIQUE
MEXICO
MONTSERRAT
NETHERLANDS ANTILLES
NICARAGUA
PAKISTAN
PANAMA
PAPUA NEW GUINEA
PHILIPPINES
RUSSIAN FEDERATION
SAMOA
SRI LANKA
ST KITTS
ST LUCIA
ST VINCENT AND GRENADES

Document Version 1.7

128

Pinserve Web Services API Implementation Guide.

SR
TO
TT
TR
TC
US
VU
VN

Copyright 2008 Pinserve Technologies

API Version 2.3.3

SURINAME
TONGA ISLANDS
TRINIDAD AND TOBAGO
TURKEY
TURKS AND CAICOS ISLES
UNITED STATES
VANUATU REPUBLIC
VIETNAM

Document Version 1.7

129

You might also like