Payment

Overview

The Playground Payment service provides access to simple payment of mobile subscribers.

The service can be used as a standalone service or it can be bundled with other Playground services. Please note that playground billing APIs are available through a simulator and not a real billing system.

Features

The Playground Payment Service currently has the following features:

• Payment reservation
• Pre-paid payments
• Charging of currency amounts
• Refund of currencly amounts

Usage Examples

An example of an application scenario could be a content service. Assume a subscriber is interested in receiving information from a live event, say a world cup soccer match. The subscriber selects a match and establishes a trusted relation with the provider. The subscriber wants to know what the service will cost and the provider interacts with the operators rating engine. The subscriber accepts the cost and decides to get the service. Subsequently, the provider will reserve the appropriate amount with the operator. The match starts and the provider periodically charges against the reservation. The match ends in a draw and is extended with a 'sudden death' phase. The subscriber continues getting match updates, so the existing reservation is enlarged. Suddenly, one of the teams scores a goal, so the match abruptly ends, leaving part of the reserved amount unused. The provider now releases the reservation, and the remaining amount is available for future use by the subscriber.

Now we can extend this scenario by having the subscriber participate in a game of chance in which the provider refunds a percentage of the usage costs based on the ranking of a particular team in this tournament. For example, the subscriber gambling on the team that wins the tournament receives a full refund, while for gambling on the team that finishes in second place, the refund is 50 %, etc.

Java Code Sample:

// The example below shows how to use the charging interface
// by invoking the AmountCharging web service.
AmountChargingService amountChargingService = new AmountChargingServiceLocator();
amountCharging = amountChargingService.getAmountCharging();

// Prepare the ChargingInformation object that is used for 
// passing the charging information - this charging object will charge 20 NOK
ChargingInformation ci = new ChargingInformation();
BigDecimal bd = new BigDecimal(20.00);
ci.setAmount(bd);
ci.setCurrency("NOK");
ci.setDescription("charging description");

// Define the subscriber phone number to be charged. Phone number is passed
// to the amount charging service as an URI
String msisdn1 = "tel:[phone number]";
org.apache.axis.types.URI uri = new org.apache.axis.types.URI(msisdn1);

// Perform the charging	by passing an URI containing 
// the phone number of the subscriber to be charged, the 
// charging information and a descriptive text
amountCharging.chargeAmount(uri, ci, "charging test");

Resources

playground Tutorials

API descriptions