mp

Class PaymentRequest.PaymentRequestBuilder

java.lang.Object

mp.PaymentRequest.PaymentRequestBuilder

Enclosing class:

PaymentRequest

public static class PaymentRequest.PaymentRequestBuilder
extends java.lang.Object

A builder class to make PaymentRequest objects.

Typical usage for a consumable payment:
PaymentRequest.PaymentRequestBuilder builder = new PaymentRequest.PaymentRequestBuilder(); PaymentRequest request = builder.setConsumable(true).setDisplayString("Skip a level").build();

Typical usage for a non consumable payment:
PaymentRequest.PaymentRequestBuilder builder = new PaymentRequest.PaymentRequestBuilder(); PaymentRequest request = builder.setConsumable(false).setDisplayString("Ancient shield").setProductName("ANCSHIELD1").build();

Constructor Summary

Constructors

Constructor and Description
PaymentRequestBuilder()

Method Summary

Modifier and Type	Method and Description
PaymentRequest	build() Generates a PaymentRequest object using the data specified.
PaymentRequest.PaymentRequestBuilder	setColours(CustomDialogColours dialogColours)
PaymentRequest.PaymentRequestBuilder	setCreditsMultiplier(double multiplier) Multiplies amount of credits by some coefficient.
PaymentRequest.PaymentRequestBuilder	setDisplayString(java.lang.String displayString) Allows you to display a specific string to the user in the payment dialog.
PaymentRequest.PaymentRequestBuilder	setIcon(int resourceId) Allows you to change icon at payment dialog.
PaymentRequest.PaymentRequestBuilder	setMsisdn(java.lang.String msisdn) Allows to prefill customer's phone number.
PaymentRequest.PaymentRequestBuilder	setPriceAmount(java.lang.String priceAmount) Allows you to override the price amount.
PaymentRequest.PaymentRequestBuilder	setPriceCurrency(java.lang.String priceCurrency) Allows you to override the price currency.
PaymentRequest.PaymentRequestBuilder	setProductName(java.lang.String productName) Use this method to specify your product identification for the nonconsumable payment.
PaymentRequest.PaymentRequestBuilder	setService(java.lang.String serviceId, java.lang.String inAppSecret)
PaymentRequest.PaymentRequestBuilder	setType(int type) Specify the product type.
PaymentRequest.PaymentRequestBuilder	setWebPaymentTheme(java.lang.String theme) Allows to set a custom theme (appearance) for the web payment flow.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PaymentRequestBuilder

public PaymentRequestBuilder()

Method Detail

setService

public PaymentRequest.PaymentRequestBuilder setService(java.lang.String serviceId,
                                                       java.lang.String inAppSecret)

Parameters:

serviceId - A service id (from Fortumo dashboard).

inAppSecret - The in-app secret of the service.

setType

public PaymentRequest.PaymentRequestBuilder setType(int type)

Specify the product type. NB: Non-consumable payments can be only purchased once.

Parameters:

type - Either MpUtils.TYPE_CONSUMABLE, MpUtils.TYPE_NON_CONSUMABLE or MpUtils.TYPE_SUBSCRIPTIONS

setProductName

public PaymentRequest.PaymentRequestBuilder setProductName(java.lang.String productName)

Use this method to specify your product identification for the nonconsumable payment.

Parameters:

productName - Product name desired. NB: Only latin alphanumeric characters, dash ('-', hyphen-minus, U+002D) and underscore ('_', low line, U+005F) are supported and the value is truncated to 32 characters.

setDisplayString

public PaymentRequest.PaymentRequestBuilder setDisplayString(java.lang.String displayString)

Allows you to display a specific string to the user in the payment dialog.

Parameters:

displayString - String to display in the payment dialog.

setIcon

public PaymentRequest.PaymentRequestBuilder setIcon(int resourceId)

Allows you to change icon at payment dialog.

Parameters:

resourceId - resource id (for example R.drawable.icon_payment_dialog).

setCreditsMultiplier

public PaymentRequest.PaymentRequestBuilder setCreditsMultiplier(double multiplier)

Multiplies amount of credits by some coefficient. For example, if by default user gets 100 credits for 1.00EUR, then with setCreditsMultiplier(1.5d) he will get 150 credits for the same price.

Parameters:

multiplier - Multiplier by which the credit amount will be multiplied with.

setPriceAmount

public PaymentRequest.PaymentRequestBuilder setPriceAmount(java.lang.String priceAmount)

Allows you to override the price amount. Only applicable for credit card payments.

Parameters:

priceAmount - A price amount (eg "10.50")

setPriceCurrency

public PaymentRequest.PaymentRequestBuilder setPriceCurrency(java.lang.String priceCurrency)

Allows you to override the price currency. Only applicable for credit card payments (NOOK services).

Parameters:

priceCurrency - A price currency (eg "USD" or "EUR")

setMsisdn

public PaymentRequest.PaymentRequestBuilder setMsisdn(java.lang.String msisdn)

Allows to prefill customer's phone number. Should be in international format without + sign or spaces.

Parameters:

msisdn - The enduser's msisdn.

setWebPaymentTheme

public PaymentRequest.PaymentRequestBuilder setWebPaymentTheme(java.lang.String theme)

Allows to set a custom theme (appearance) for the web payment flow. Will be used in case payment is completed using a web flow instead of Android native payment flow. The option to use of dynamic themes needs to be enabled for your account.

Parameters:

theme - Name of the theme to be used.

build

public PaymentRequest build()

Generates a PaymentRequest object using the data specified.

Returns:

A PaymentRequest object

Throws:

java.lang.IllegalStateException - if product name is not specified for a non-consumable payment

setColours

public PaymentRequest.PaymentRequestBuilder setColours(CustomDialogColours dialogColours)