PrimerHeadlessUniversalCheckoutRawDataManagerListener

Overview

Set the PrimerHeadlessUniversalCheckoutRawDataManagerListener in order to receive different callbacks from Primer SDK.

onValidationChanged

KOTLIN

fun onValidationChanged(isValid: Boolean, errors: List<PrimerInputValidationError>)

Returns whether the rawData set by setRawData is valid, and all the errors that occurred during validation.

Parameters

Hide Parameters

isValid

Boolean

required

Returns true in case raw data is valid, otherwise false.

errors

List<PrimerInputValidationError>

required

Returns all of the validation errors for a raw data.

Show PrimerInputValidationError

Show Properties

errorId

String

required

A unique error identifier.

description

String

required

An error description.

inputElementType

PrimerInputElementType

required

A input element associated with the error returned.

diagnosticsId

String

required

A unique diagnostics id for the given error.

onMetadataChanged

Returns metadata for the current data set by using the setRawData. This synchronous callback provides immediate metadata updates based on internal SDK calculations. Check the section below for the metadata types that can be returned.

KOTLIN

fun onMetadataChanged(metadata: PrimerPaymentMethodMetadata)

Parameters

Hide Parameters

metadata

PrimerPaymentMethodMetadata

Show Direct Subclasses

PrimerCardMetadata

Hide Properties

cardNetwork

CardNetwork.Type

required

onMetadataStateChanged

Returns metadata state for the current data set by using the setRawData. In contrast to onMetadataChanged, this callback involves internal asynchronous operations, offering a broader and more accurate dataset that can be fetched remotely. Its dynamic nature enables you to access the current state of SDK operations, providing an opportunity to tailor the UI accordingly. Check the section below for the metadata state types that can be returned.

KOTLIN

fun onMetadataStateChanged(metadataState: PrimerPaymentMethodMetadataState)

Parameters

Hide Parameters

metadataState

PrimerPaymentMethodMetadataState

Show Direct Subclasses

sealed class PrimerCardMetadataState

Show States

Fetching

Hide Properties

cardNumberEntryState

PrimerCardNumberEntryState

required

The state of card number entry triggered the metadata fetch.

Hide Properties

cardNumber

String

required

The entered card number.

Fetched

Hide Properties

cardNumberEntryState

PrimerCardNumberEntryState

required

The state of card number entry triggered the metadata fetch.

Hide Properties

cardNumber

String

required

The entered card number.

cardNumberEntryMetadata

PrimerCardNumberEntryMetadata

required

Represents metadata for PrimerCardNumberEntry, including selectable (co-badged) and detected card networks.

Hide Properties

selectableCardNetworks

PrimerCardNetworksMetadata?

Selectable card networks for a given card number, will be null in case card network is not co-badged.

Show Properties

items

List<PrimerCardNetwork>

Show PrimerCardNetwork

cardNetwork

PrimerCardNetwork

Represents a card network with metadata including display name, network type, and whether it is allowed.

Show Properties

network

CardNetwork.Type

The type of card network (e.g., VISA, MASTERCARD).

displayName

String

The human-readable name of the card network (e.g., Visa, Mastercard).

allowed

Boolean

required

A boolean indicating whether this card network is allowed.

preferred

PrimerCardNetwork?

Show PrimerCardNetwork

cardNetwork

PrimerCardNetwork

Represents a card network with metadata including display name, network type, and whether it is allowed.

Show Properties

network

CardNetwork.Type

The type of card network (e.g., VISA, MASTERCARD).

displayName

String

The human-readable name of the card network (e.g., Visa, Mastercard).

allowed

Boolean

required

A boolean indicating whether this card network is allowed.

detectedCardNetworks

PrimerCardNetworksMetadata

required

All detected card networks for a given card number.

Show Properties

items

List<PrimerCardNetwork>

Show PrimerCardNetwork

cardNetwork

PrimerCardNetwork

Represents a card network with metadata including display name, network type, and whether it is allowed.

Show Properties

network

CardNetwork.Type

The type of card network (e.g., VISA, MASTERCARD).

displayName

String

The human-readable name of the card network (e.g., Visa, Mastercard).

allowed

Boolean

required

A boolean indicating whether this card network is allowed.

preferred

PrimerCardNetwork?

Show PrimerCardNetwork

cardNetwork

PrimerCardNetwork

Represents a card network with metadata including display name, network type, and whether it is allowed.

Show Properties

network

CardNetwork.Type

The type of card network (e.g., VISA, MASTERCARD).

displayName

String

The human-readable name of the card network (e.g., Visa, Mastercard).

allowed

Boolean

required

A boolean indicating whether this card network is allowed.

source

enum ValidationSource

required

Enum class representing the source of validation for card metadata.

Hide cases

ValidationSource.REMOTE

The data comes from Primer API.

ValidationSource.LOCAL_FALLBACK

The data comes from the SDK if Primer’s server fails to be reached. This works similarly to LOCAL.

ValidationSource.LOCAL

The data comes from the SDK, usually by levering the first few digits.

Android SDK

​Overview

​onValidationChanged

​Parameters

​onMetadataChanged

​Parameters

​onMetadataStateChanged

​Parameters

Overview

onValidationChanged

Parameters

onMetadataChanged

Parameters

onMetadataStateChanged

Parameters