PurchaseReply

#include <bb/platform/PurchaseReply>

To link against this class, add the following line to your .pro file: LIBS += -lbbplatform

Represents a response to PaymentManager::requestPurchase().

An instance of this class is returned when a PaymentManager::requestPurchase() is made. Initially, the returned object will be unfinished and not contain any valid information relating to the request (other than that it is unfinished). Once the request is finished, PaymentReply::isError() can be used to determine whether the request succeeded or failed. If the request was successful, then the receipt() method provides a purchase receipt with details of the purchase. If the request failed, then the error code and error text are included; these can be accessed on the PaymentReply base class.

The finished() signal can be used to determine when the request finishes. The PaymentManager::purchaseFinished() signal can also be used to determine when a request finishes.

Note:

Do not delete the object in a slot connected to any of the finished signals. Use QObject::deleteLater() instead.

Since:

BlackBerry 10.0.0

Inheritance

Public Functions Index

virtual ~PurchaseReply ()
bb::platform::PurchaseReceiptreceipt () const
QStringpurchaseMetadata () const
QStringdigitalGoodId () const Inherited
QStringdigitalGoodSku () const Inherited
interrorCode () const Inherited
QStringerrorText () const Inherited
boolisError () const Inherited
boolisFinished () const Inherited

Signals Index

Only has inherited signals

voidfinished ()Inherited

Public Functions

virtual~PurchaseReply ()

Destructor.

Destroys a PurchaseReply instance.

Since:

BlackBerry 10.0.0

bb::platform::PurchaseReceipt receipt ()

Gets the receipt from a successful purchase response.

If the request finished successfully, then the purchase receipt is returned. If the request failed or is unfinished, then an invalid purchase receipt is returned.

Return:

The purchase receipt.

Since:

BlackBerry 10.0.0

QString purchaseMetadata ()

Gets the purchase metadata from an error purchase response.

If the request finished successfully, then the purchase metadata is returned. If the request failed or is unfinished, then the empty string is returned.

If no metadata was provided in the request, then metadata is empty.

Return:

The purchase metadata, if passed in the request.

Since:

BlackBerry 10.0.0

QString digitalGoodId ()Inherited

Get the digital good ID.

If the request finished successfully, then this returns the digital good ID. If the request failed or is unfinished, then the empty string is returned.

If no digital good ID was provided in the request, then the digital good ID is empty.

Return:

The digital good ID.

Since:

BlackBerry 10.0.0

QString digitalGoodSku ()Inherited

Get the digital good SKU.

If the request finished successfully, then this returns the digital good SKU. If the request failed or is unfinished, then the empty string is returned.

If no digital good SKU was provided in the request, then digital good SKU is empty.

Return:

The digital good SKU.

Since:

BlackBerry 10.0.0

int errorCode ()Inherited

Get the error code.

If the request is unfinished or finished successfully, then this method returns 0. If the request failed, then this method returns the error code.

Return:

The error code.

Since:

BlackBerry 10.0.0

QString errorText ()Inherited

Get the error text.

If the request is unfinished or finished successfully, then this method returns an empty string. If the request failed, then this method returns the a description of the error that occurred.

Return:

A description of the error that occurred.

Since:

BlackBerry 10.0.0

bool isError ()Inherited

Whether the request failed.

If the request is unfinished or finished successfully, then this method returns false. If the request failed, then this method returns true.

Return:

Whether the request failed.

Since:

BlackBerry 10.0.0

bool isFinished ()Inherited

Whether the request is finished.

Return:

true if a result has been received, false otherwise.

Since:

BlackBerry 10.0.0

Signals

(Only has inherited signals)

void finished ()Inherited

Emitted when a result is received.

Since:

BlackBerry 10.0.0