@meawallet/react-native-mpp

1.7.0

MeaPushProvisioningInterface

Provides API for interaction with the MeaPushProvisioning library.

MeaPushProvisioningInterface
Instance Members
initialize(configFileName?)
getTokenRequestors(accountRanges)
getTokenRequestorsWithEncryptedPan(encryptedData, publicKeyFingerprint, encryptedKey, initialVector)
getTokenizationReceipt(tokenRequestorId, cardData)
getAsset(assetId)
sendUserToTokenRequestor(applicationUri, webUri, pushAccountReceiptParameter, callbackUrlParameter, completeIssuerAppActivationParameter, completeWebsiteActivationParameter)
getTokenUniqueReference(payload)
GooglePay
SamsungPay
IssuerPay
ApplePay
Configuration

GooglePay

Methods which can be used to simplify Google Pay Push Provisioning flow.

https://developers.google.com/pay/issuers/apis/push-provisioning/android

GooglePay
Instance Members
pushCard(cardData, cardDisplayName, userAddress)
checkWalletForCardToken(cardData)
checkWalletForToken(paymentNetwork, tokenId)
checkWalletForCardSuffix(cardSuffix)
tokenize(googlePayTokenInfo, cardDisplayName)
getActivationCode(cardData, walletId?, deviceId?)
activate(activationCode)
getTokenInfo(payload)
activateWithTokenUniqueReference(tokenUniqueReference, paymentNetwork)
activateWithTokenInfo(tokenInfo)
declineActivation(activationResult)
isTokenized(tokenId, issuerName, paymentNetwork)
viewToken(tokenId, paymentNetwork)
getRegisteredTokens()
getTokens(cardData, walletId, deviceId)
getTokenizationData(cardData, walletId, deviceId)
registerDataChangedListener(listener)
removeDataChangedListener(emitterSubscription)
requestTokenDeleteDialog(googlePayTokenInfo)
requestTokenSelectDialog(googlePayTokenInfo)
isDefaultPaymentApplication()
setAsDefaultPaymentApplication(requestCode)
sendUserToGooglePay()
isWalletAvailable(context)

SamsungPay

Methods which can be used to simplify Samsung Pay Push Provisioning flow.

https://pay.samsung.com/developers

SamsungPay
Instance Members
setServiceId(serviceId)
getStatus()
activatePay()
update()
pushCard(cardData)
getActivationCode(cardData, walletId?, deviceId?)
verifyCardIdv(cardId, activationCode, cardInfoData)
activate(activationCode)
getCard(payload)
activateWithTokenUniqueReference(tokenUniqueReference, paymentNetwork)
activateWithCard(card)
declineActivation(activationResult)
checkWalletForToken(tokenId)
checkWalletForCardToken(cardData)
getRegisteredTokens()
checkWalletForCardSuffix(cardSuffix)
getWalletInfo()
isDefaultPaymentApplication()
setAsDefaultPaymentApplication(requestCode)
getTokens(cardData, walletId, deviceId)
getTokenizationData(cardData, walletId, deviceId)
sendUserToSamsungPay()
isWalletAvailable(context)

SamsungPayWalletInfo

Samsung Pay Wallet info.

SamsungPayWalletInfo

Type: {deviceManagementId: string, deviceId: string, userId: string}

Properties
deviceManagementId (string)
deviceId (string)
userId (string)
Static Members
deviceManagementId
deviceId
userId

IssuerPay

Methods which can be used to simplify Issuer Pay Push Provisioning flow.

https://dev.meawallet.com/mtp/overview/

IssuerPay
Instance Members
pushCard(cardData, title)
isPushAvailable()
getPushApps()
getPushAppsCount()
getRegisteredTokens(packageName)

Configuration

MeaPushProvisioning library configuration information.

Configuration
Instance Members
versionCode()
versionName()
buildType()
loadConfig(configFileName)
hash()

MppCardDataType

Get Tokenization Receipt parameter type.

MppCardDataType
Static Members
SECRET
ENCRYPTED_PAN

MppCardDataParameters

Card data parameters.

new MppCardDataParameters(type: MppCardDataType)
Parameters
Static Members
withCardSecret(cardId, cardSecret)
withEncryptedPan(encryptedCardData, publicKeyFingerprint, encryptedKey, initialVector)

UserAddress

The user's address. Push token'ization takes a UserAddress that must be provided in order to skip manual address entry. The issuer application should provide the entire address and phone number on file. Missing or invalid address information may result in the user being prompted to complete or correct the address. The address should be the correct address of the issuer's knowledge. Using a fake or intentionally incorrect addresses is not permitted by the Push Provisioning API terms of service.

UserAddress

Type: {address1: string?, address2: string?, administrativeArea: string?, countryCode: string?, locality: string?, name: string?, phoneNumber: string?, postalCode: string?}

Properties
address1 (string?)
address2 (string?)
administrativeArea (string?)
countryCode (string?)
locality (string?)
name (string?)
phoneNumber (string?)
postalCode (string?)
Static Members
address1
address2
administrativeArea
countryCode
locality
name
phoneNumber
postalCode

GooglePayTokenInfo

Card token added to the Google Pay Wallet.

GooglePayTokenInfo

Type: {tokenId: string, tokenState: GooglePayTokenState, paymentNetwork: string, isSelectedAsDefault: string}

Properties
tokenId (string)
tokenState (GooglePayTokenState)
paymentNetwork (string)
isSelectedAsDefault (string)
Static Members
tokenId
tokenState
paymentNetwork
isSelectedAsDefault

GooglePayTokenState

Google Pay token state.

GooglePayTokenState
Static Members
TOKEN_STATE_NOT_FOUND
TOKEN_STATE_UNTOKENIZED
TOKEN_STATE_PENDING
TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION
TOKEN_STATE_SUSPENDED
TOKEN_STATE_ACTIVE
TOKEN_STATE_FELICA_PENDING_PROVISIONING

PushCardInfo

Push Card Info

PushCardInfo
Instance Members
tokenId
cardLastFourDigits
cardNetwork

MppTokenRequestor

Token requestor that is eligible for the account ranges in the request.

MppTokenRequestor
Instance Members
tokenRequestorId
name
consumerFacingEntityName
imageAssetId
tokenRequestorType
walletId
enabledAccountRanges
supportedPushMethods
supportsMultiplePushedCards

SamsungPayStatus

Samsung Pay Status.

SamsungPayStatus
Static Members
SAMSUNG_PAY_READY
SAMSUNG_PAY_UNEXPECTED_STATUS
SAMSUNG_PAY_NOT_SUPPORTED
SAMSUNG_PAY_NOT_READY
SAMSUNG_PAY_SETUP_NOT_COMPLETED
SAMSUNG_PAY_APP_NEED_TO_UPDATE

TokenizationResult

Tokenization result.

TokenizationResult
Instance Members
receipt
availablePushMethods

MppPaymentNetwork

Card payment network.

MppPaymentNetwork
Static Members
CARD_NETWORK_NOT_FOUND
AMEX
MAESTRO
MASTERCARD
VISA
MIR

TokenInfo

Token Info.

TokenInfo
Instance Members
paymentNetwork
tokenState
dpanLastFour
fpanLastFour
issuerName
issuerTokenId
portfolioName
isDefaultToken

MppGetTokensResponseData

Token Response Data.

MppGetTokensResponseData

Type: {paymentNetwork: MppPaymentNetwork, lastFourDigits: string?, tokens: Array<string>?}

Properties
paymentNetwork (MppPaymentNetwork)
lastFourDigits (string?)
tokens (Array<string>?)
Static Members
paymentNetwork
lastFourDigits
tokens

MppGetOemTokenizationDataResponseData

OEM Tokenization Data.

MppGetOemTokenizationDataResponseData

Type: {opaquePaymentCard: string?, lastFourDigits: string?, paymentNetwork: MppPaymentNetwork, billingAddress: MppBilingAddress?, tokens: Array<string>?}

Properties
opaquePaymentCard (string?)
lastFourDigits (string?)
paymentNetwork (MppPaymentNetwork)
billingAddress (MppBilingAddress?)
tokens (Array<string>?)
Static Members
opaquePaymentCard
lastFourDigits
paymentNetwork
billingAddress
tokens

SamsungPayTokenInfo

Data class describing card token added to the Samsung Pay Wallet.

SamsungPayTokenInfo

Type: {tokenId: string, tokenState: string, paymentNetwork: string, isSelectedAsDefault: string}

Properties
tokenId (string)
tokenState (string)
paymentNetwork (string)
isSelectedAsDefault (string)
Static Members
tokenId
tokenState
paymentNetwork
isSelectedAsDefault

SamsungPayRegisteredToken

Card information related to the Samsung Pay card management operations.

SamsungPayRegisteredToken

Type: {cardId: string, cardBrand: string, cardStatus: string, last4FPan: string?, last4DPan: string?, cardType: string?, cardIssuerName: string?}

Properties
cardId (string)
cardBrand (string)
cardStatus (string)
last4FPan (string?)
last4DPan (string?)
cardType (string?)
cardIssuerName (string?)
Static Members
cardId
cardBrand
cardStatus
last4FPan
last4DPan
cardType
cardIssuerName

IssuerPayTokenInfo

Card token added to the Issuer Pay Wallet.

IssuerPayTokenInfo

Type: {cardId: string, tokenState: IssuerPayTokenState, tokenPanSuffix: string, accountPanSuffix: string, tokenExpiry: string}

Properties
cardId (string)
tokenState (IssuerPayTokenState)
tokenPanSuffix (string)
accountPanSuffix (string)
tokenExpiry (string)
Static Members
cardId
tokenState
tokenPanSuffix
accountPanSuffix
tokenExpiry

IssuerPayTokenState

Issuer Pay token state.

IssuerPayTokenState
Static Members
UNKNOWN
DIGITIZATION_STARTED
DIGITIZED
PROVISIONED
ACTIVE
SUSPENDED
PROVISION_FAILED
DEACTIVATED
MARKED_FOR_DELETION

MppBilingAddress

Billing address info used for Google Pay Push Provisioning.

MppBilingAddress

Type: {line1: string, line2: string, city: string, countrySubdivision: string, postalCode: string, country: string}

Properties
line1 (string)
line2 (string)
city (string)
countrySubdivision (string)
postalCode (string)
country (string)
Static Members
line1
line2
city
countrySubdivision
postalCode
country

MppAvailablePushMethod

Available push methods.

MppAvailablePushMethod
Instance Members
type
uri

MppMediaContent

Media content

MppMediaContent
Instance Members
type
data
width
height

MppMediaType

Media types

MppMediaType
Static Members
PDF
PNG
PLAIN_TEXT
HTML_TEXT
SVG

MppPushMethod

Push method types.

MppPushMethod
Static Members
ANDROID
IOS
WEB

ApplePay

Methods which can be used to simplify Apple Pay Push Provisioning flow.

https://developer.apple.com/documentation/passkit

ApplePay
Instance Members
setDebugLoggingEnabled(enabled)
isPassLibraryAvailable()
canAddPaymentPass()
initializeOemTokenization(cardDataParameters)
getActivationData(cardDataParameters)
activate(secureElementPass, activationData)
secureElementPassWithSerialNumber(serialNumber, primaryAccountNumberSuffix)
showAddPaymentPassView(mppInitializeOemTokenizationResponseData)
canAddPaymentPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
canAddPaymentPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
canAddPaymentPassWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
paymentPassExistsWithPrimaryAccountIdentifier(primaryAccountIdentifier)
remotePaymentPassExistsWithPrimaryAccountIdentifier(primaryAccountIdentifier)
paymentPassExistsWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
remotePaymentPassExistsWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
canAddSecureElementPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
canAddSecureElementPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
canAddSecureElementPassWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
canAddRemoteSecureElementPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
canAddRemoteSecureElementPassWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
secureElementPassExistsWithPrimaryAccountIdentifier(primaryAccountIdentifier)
remoteSecureElementPassExistsWithPrimaryAccountIdentifier(primaryAccountIdentifier)
secureElementPassExistsWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
remoteSecureElementPassExistsWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
presentSecureElementPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
presentSecureElementPassWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
secureElementPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
secureElementPassWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
remoteSecureElementPassWithPrimaryAccountIdentifier(primaryAccountIdentifier)
remoteSecureElementPassWithPrimaryAccountNumberSuffix(primaryAccountNumberSuffix)
passes()
remoteSecureElementPasses()
registerDataChangedListener(listener)
removeDataChangedListener(emitterSubscription)
AddPassButton
PaymentButton
AddPassView
IssuerNonUIExtension
IssuerUIExtension

IssuerNonUIExtension

Interface for an app extension to add a payment card to Wallet.

IssuerNonUIExtension
Instance Members
start()
completeStatus(status)
completePassEntries(passEntries)
completeRemotePassEntries(remotePassEntries)
addListener(eventName)
removeListeners(count)

IssuerUIExtension

Interface for a UI app extension to authorize a user to add a payment card to Wallet.

IssuerUIExtension
Instance Members
completeAuthentication(userAuthenticated)

AddPassButtonProps

AddPassButton Props.

AddPassButtonProps

Extends ViewProps

Instance Members
onPress
addPassButtonStyle

MppPassActivationState

The activation state of the pass.

MppPassActivationState
Static Members
ACTIVATED
REQUIRES_ACTIVATION
ACTIVATING
SUSPENDED
DEACTIVATED
UNDEFINED

MppInitializeOemTokenizationResponseData

Class describing initialize oem tokenization response.

MppInitializeOemTokenizationResponseData
Instance Members
tokenizationReceipt
primaryAccountSuffix
networkName
cardholderName
localizedDescription
primaryAccountIdentifier
validFor

PaymentButtonProps

PaymentButton Props.

PaymentButtonProps

Extends ViewProps

Instance Members
onPress
paymentButtonStyle
paymentButtonType

IssuerExtensionPaymentPassEntry

An object that represents a payment card available to add as a payment pass.

IssuerExtensionPaymentPassEntry
Instance Members
identifier
art
title
addRequestConfiguration

IssuerExtensionStatus

Issuer extension status: passes availability and authorization status.

IssuerExtensionStatus
Instance Members
passEntriesAvailable
remotePassEntriesAvailable
requiresAuthentication

IssuerExtensionHandler

An abstract superclass for an app extension to add a payment card to Apple Wallet.

new IssuerExtensionHandler()
Instance Members
status()
passEntries()
remotePassEntries()

MppAddPaymentPassRequestConfiguration

Configuration data for a view controller that lets the user add a payment pass.

MppAddPaymentPassRequestConfiguration
Instance Members
style
cardholderName
primaryAccountSuffix
cardDetails
primaryAccountIdentifier
paymentNetwork
productIdentifiers
requiresFelicaSecureElement

MppSecureElementPass

A pass with a credential that the device stores in a certified payment information chip.

MppSecureElementPass

Extends MppPass

Instance Members
primaryAccountIdentifier
primaryAccountNumberSuffix
deviceAccountIdentifier
deviceAccountNumberSuffix
passActivationState
devicePassIdentifier
pairedTerminalIdentifier

MppPass

An object that represents a single pass.

MppPass
Instance Members
passType
serialNumber
passTypeIdentifier
webServiceURL
authenticationToken
icon
localizedName
localizedDescription
organizationName
relevantDate
userInfo
passURL
remotePass
deviceName

MppPassType

Types of passes.

MppPassType
Static Members
ANY
BARCODE
SECURE_ELEMENT