Card Management
Card lifecycle operations — change the cardholder's PIN or activate a newly issued card using their dedicated APIs: changePin() and activateCard().
Overview
Card management operations are non-monetary transactions that manage the card lifecycle. Both operations have their own dedicated functions rather than passing through the standard purchase() API. They accept a List<String> of parameters needed for the operation.
Allow the cardholder to change their card PIN
Activate a newly issued card before first use
Dedicated APIs
Previously, these operations used the purchase() method. As of v1.0.5, changePin() and activateCard()are discrete functions, making the integration cleaner and more strongly typed.
Change PIN
Allow a cardholder to change their PIN on the device. The card must be tapped and the current PIN verified before the new PIN is accepted. Pass any required parameters as a list to changePin():
Loading...PIN Change Flow
- Cardholder taps card on device
- SDK prompts for new PIN only
onPaymentProcessCompletefires when complete
Activate Card
Activate a newly issued card before its first use. The cardholder taps the card and the SDK verifies with the issuer. Pass required activation data as a list to activateCard():
Loading...Card Must Be Inactive
Activation only succeeds when the card is in an inactive/unactivated state. Attempting to activate an already-active card will return an error response code.
PIN Change Flow
- Cardholder taps card on device
- SDK prompts for new PIN only
onPaymentProcessCompletefires when complete
Response Handling
Card management operations return the same callback signature as payment operations. Always check isFlowComplete === true before updating your UI — the callback may fire more than once depending on the FlowType.
| Parameter | Type | Description |
|---|---|---|
| status | Boolean | true if the operation was successful |
| code | String | Response code from the server |
| transaction | Transaction? | Transaction details (may be null for card ops) |
| isFlowComplete | Boolean | true when the UI flow has fully completed |
On this page
Downloads
Coming SoonSample apps, release bundles, and more content will be available here soon.