Refill a Prepaid Account

Business Context and Use

This operation is used to add some credit to the prepaid account. Then the credit can be used by the customer to purchase a service or goods (charging process). The refill types can vary from simple (only the prepaid account balance is credited) to complex when credit counters are also credited. The refilling logic computes:

• The credit to add (including or not the remaining one) and its validity period
• Some gifts, loyalty points, and so on and do some checks (for capping purposes for instance)

Related Service Operations

You can use the following operations to perform actions on prepaid accounts.

• Create or change a prepaid account
• Cancel a prepaid account
• Change the state of a prepaid account
• Find the prepaid accounts related to one user technical identifier

Error Handling

The following is a non-exhaustive list of errors:

• Refill item is not provided
• Bad amount is provided, which includes no amount, unknown currency or no amount value
• Usage unique identifier is not provided
• Subscriber account identifier is not provided
• Subscriber account identifier does not exist
• Prepaid account identifier is not provided
• No refill access is found
• A charging failure triggered by the charging engine occurred

The SAP CC system may return an error stack that details the issue.

Message Types

Consult the structures of the message types related to this operation:

• prepaidAccountRefillRequest
• prepaidAccountRefillResponse

Prerequisites

At least one subscriber account and one prepaid account included in this subscriber account must be created.

Integration

You can use this operation to refill the prepaid account you may have previously identified (see the operation Find the prepaid accounts related to a user technical identifier ).

Constraints and Integrity Conditions

There is no specific constraint.