Manage card

Launch the Lib Lite card-management flow standalone — let customers add or remove cards without making a purchase.

The manage-card flow lets a customer add, view, or delete cards on their Scan to Pay profile from inside your app — without going through a checkout. Use it when you want a "My cards" section in your app's profile or settings area.

For payments themselves, see Payments.

Invoking the manage-card activity

Intent intent = new Intent(this, LibLiteWalletActivity.class);
intent.putExtra(LibLiteActivity.IN_API_KEY, "YOUR_API_KEY");
intent.putExtra(LibLiteActivity.IN_SYSTEM,  "LIVE");          // or "TEST"
// Optional:
intent.putExtra(LibLiteActivity.IN_SUGGESTED_MSISDN, "27832006283");

libLiteActivityLauncher.launch(intent);

Extras passed in

Extra	Type	Required	Description
`IN_API_KEY`	String	yes	Your Lib Lite API token from the Portal
`IN_SYSTEM`	String	yes	`LIVE` or `TEST`
`IN_SUGGESTED_MSISDN`	String	optional	Pre-fills the MSISDN on the registration screen

Note: no IN_CODE — the manage-card flow doesn't involve a transaction.

Result handling

The same ActivityResultLauncher you use for payments will also receive manage-card results. Use the result code to disambiguate:

private void handleLibLiteResult(int resultCode, Intent data) {
    if (resultCode == LibLiteActivity.LIBLITE_REGISTRATION_SUCCESS) {
        boolean silent = data.getBooleanExtra(LibLiteActivity.OUT_SILENT_REGISTRATION, false);
        // Customer finished — silent: they were already registered, no UI was shown
        //                   non-silent: they interacted with the wallet UI
        handleWalletFinished(silent);

    } else if (resultCode == LibLiteActivity.LIBLITE_USER_CANCELLED) {
        int location = data.getIntExtra(LibLiteActivity.OUT_LOCATION, -1);
        // Customer closed the wallet without finishing

    } else if (resultCode == LibLiteActivity.LIBLITE_ERROR) {
        int errorCode = data.getIntExtra(LibLiteActivity.OUT_ERROR_CODE, -1);
        int location  = data.getIntExtra(LibLiteActivity.OUT_LOCATION, -1);
        handleError(errorCode, location);
    }
}

Result codes

Result code	Meaning	Extras
`LIBLITE_REGISTRATION_SUCCESS`	Customer finished using the wallet	`OUT_SILENT_REGISTRATION`
`LIBLITE_USER_CANCELLED`	Customer closed the wallet	`OUT_LOCATION`
`LIBLITE_ERROR`	An error occurred	`OUT_ERROR_CODE`, `OUT_LOCATION`

📘
Note on OUT_SILENT_REGISTRATION: true means the customer's MSISDN was already registered with a valid card on file and the SDK returned without showing any UI. false means the customer interacted with the UI to add / remove cards.

For the full error reference, see Errors.

What's next

Take a payment → Payments
Pre-register a card before the first purchase → Pre-registration
Card-management is also available via API → Card provisioning (for wallet providers; not typically used by merchants)

Updated 2 days ago