Professional Documents
Culture Documents
Added SOAP request and responses, and Test Execution response for new
VoidOrder method.
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.
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
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.
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>
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
GetProductProfiles
Gets all available Profiles.
Parameter
Value
MID:
Numeric
TID:
Numeric
Password:
Cashier:
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:
Cashier:
ProfileID:
Numeric
TransactionMode:
GetAllDestinations
Gets the list of all destinations shown in rate decks.
Parameter
Value
MID:
Numeric
TID:
Numeric
Password:
Cashier:
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
Value
MID:
Numeric
TID:
Numeric
10
Password:
Cashier:
ProductMaincode:
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:
Cashier:
TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
11
GetSinglePIN
Gets a single new PIN.
Parameter
Value
MID:
Numeric
TID:
Numeric
Password:
Cashier:
ProductMaincode:
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:
Cashier:
ProductMaincode:
ProductDenomination:
Currency
QtyPINs:
OrderID:
Numeric
12
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:
Cashier:
ProductMaincode:
ProductDenomination:
Currency
QtyPINs:
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
Value
MID:
Numeric
TID:
Numeric
13
Password:
Cashier:
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:
Cashier:
OrderID:
Numeric
TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
14
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:
Cashier:
ProductMaincode:
TopUpAmount:
Currency
PhoneNumber
CountryCode
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.
15
Parameter
Value
MID:
Numeric
TID:
Numeric
Password:
Cashier:
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:
Cashier:
OrderID:
Numeric
TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
16
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:
Cashier:
RechargeAmount:
PrimaryPhone
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
Value
17
MID:
Numeric
TID:
Numeric
Password:
Cashier:
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:
Cashier:
AccountNumber:
Numeric
PrimaryPhone
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.
18
PinlessAddPhone
Adds a secondary phone number associated to the subscribers account.
Parameter
Value
MID:
Numeric
TID:
Numeric
Password:
Cashier:
AccountNumber:
Numeric
SecondaryPhone
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:
Cashier:
AccountNumber:
Numeric
SecondaryPhone
TransactionMode:
String: L (Live) or T (Test)
See Appendix B for complete SOAP request and response
19
20
21
22
23
24
25
- <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" />
26
27
</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">
28
29
30
31
32
<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"
33
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" />
34
</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"
35
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>
36
37
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.
38
</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.
39
<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>
40
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.
41
42
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.
43
</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.
44
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.
45
<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.
46
<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.
47
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.
48
<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.
49
<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.
50
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.
51
52
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.
53
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.
54
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.
55
<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.
56
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.
57
<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.
58
<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.
59
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.
60
61
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PIN>
62
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.
63
<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.
64
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.
65
</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.
66
</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>
67
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.
68
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.
69
<LegalInfo>
<Version>string</Version>
<Copyright>string</Copyright>
<Disclaimer>string</Disclaimer>
<PrivacyURL>string</PrivacyURL>
<TermsAndConditions>string</TermsAndConditions>
<ContactPhone>string</ContactPhone>
</LegalInfo>
</PIN>
70
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.
71
72
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.
73
74
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.
75
76
Appendix C.01:
Test Execution: DoTopUp
77
78
Appendix C.02:
Test Execution: GetAllDestinations
79
80
+
+
+
+
+
+
+
+
+
+
+
-
<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>
81
+
+
+
+
+
+
+
+
+
-
<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>
82
+
+
+
+
-
<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>
83
Appendix C.03:
Test Execution: GetLegalInformation
84
85
Appendix C.04:
Test Execution: GetMultiplePIN
86
87
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>
88
Appendix C.05:
Test Execution: GetMultiplePINLite
89
90
<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>
91
Appendix C.06:
Test Execution: GetProductAccessPhones
92
93
<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>
94
</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>
95
- <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>
96
Appendix C.07:
Test Execution: GetProductProfiles
97
98
- <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>
99
<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>
100
<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>
101
Appendix C.08:
Test Execution: GetProductsCatalog
102
103
+
+
+
+
+
+
+
+
+
+
+
-
104
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
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>
105
106
+
+
+
+
-
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
107
+
+
+
+
+
+
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">
108
Appendix C.09:
Test Execution: GetSinglePIN
109
110
<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
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
111
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>
112
Appendix C.10:
Test Execution: VoidOrder
113
114
Appendix C.11:
Test Execution: VoidTransaction
115
116
Appendix C.12:
Test Execution: PinlessRecharge
117
118
Appendix C.13:
Test Execution: PinlessVoid
119
120
Appendix C.14:
Test Execution: PinlessBalance
121
122
Appendix C.15:
Test Execution: PinlessAddPhone
123
124
Appendix C.16:
Test Execution: PinlessDeletePhone
125
126
Appendix D:
Error Codes
Error
Code
0
1
Invalid OrderID
Merchant is closed.
96
97
98
NN
9
12
17
19
31
40
51
76
89
Error Description
Retry?
N
N
Y
Y
Y
Y
Y
Y
N
Y
Y
N
N
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
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
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
128
SR
TO
TT
TR
TC
US
VU
VN
SURINAME
TONGA ISLANDS
TRINIDAD AND TOBAGO
TURKEY
TURKS AND CAICOS ISLES
UNITED STATES
VANUATU REPUBLIC
VIETNAM
129