Zeply.applepay-capacitor-plugin NPM

zeply.applepay-capacitor-plugin

@fresha/capacitor-plugin-applepay

This Apple Pay plugin provides interfaces that allow you to initiate an Apple Pay payment sheet based on provided PaymentRequest. When transaction is authorized, Payment response is returned along with payment details and more importantly- a payment token that you should pass to your backend.

For Capacitor 4 please use version 4.0.0+ For Capacitor 3 please use lower versions.

Install

npm install @fresha/capacitor-plugin-applepay
npx cap sync

Configuration

Before using this plugin, make sure that your project is correctly configured. Usually your Payment Services Processor will provide detailed instructions, so please read their docs first.

Apple Developer Portal:

Add your Merchant identifier
Contact with your PSP who will generate CSR that you should pass into Apple Pay Payment Processing Certificate
Send the generated certificate to your PSP
Edit your App Identifier, add Apple Pay Payment Processing capability, select previously created merchant ID.
Renew your provisioning profiles

Xcode

Add Apple Pay capability
Select previously created merchant identifier
Make sure you are using renewed provisioning profiles

canMakePayments()

canMakePayments() => any

Indicates whether the device supports Apple Pay.

Returns: any

canMakePayments(...)

canMakePayments(options: CanMakePaymentsRequest) => any

Indicates whether the device supports Apple Pay and whether the user has an active card. This allows more granular control than regular canMakePayments()

Param	Type	Description
`options`	CanMakePaymentsRequest	- Supported networks and capabilities

Returns: any

initiatePayment(...)

initiatePayment(request: InitiatePaymentRequest) => any

Initiates a payment base on PaymentRequest object.

Param	Type	Description
`request`	InitiatePaymentRequest	- PaymentRequest object that will be used for the payment.

Returns: any

completeLastPayment(...)

completeLastPayment(request: CompletePaymentRequest) => any

Completes current payment

Param	Type	Description
`request`	CompletePaymentRequest	- CompletePaymentRequest object containing status

Returns: any

Interfaces

CanMakePaymentsResponse

Prop	Type
`canMakePayments`	boolean

CanMakePaymentsRequest

Prop	Type
`networks`	{}
`capabilities`	{}

InitiatePaymentRequest

Prop	Type
`merchantIdentifier`	string
`countryCode`	string
`currencyCode`	string
`supportedCountries`	{}
`supportedNetworks`	{}
`summaryItems`	{}
`requiredShippingContactFields`	{}
`requiredBillingContactFields`	{}
`merchantCapabilities`	{}
`billingContact`	PaymentContact
`shippingContact`	PaymentContact

PaymentSummaryItem

Prop	Type
`label`	string
`amount`	string
`type`	PaymentSummaryItemType

PaymentContact

Prop	Type
`emailAddress`	string
`phoneNumber`	string
`name`	PersonNameComponents
`postalAddress`	{ street?: string; city?: string; postalCode?: string; country?: string; isoCountryCode?: string; subAdministrativeArea?: string; subLocality?: string; }

PersonNameComponents

Prop	Type
`familyName`	string
`givenName`	string
`namePrefix`	string
`middleName`	string
`nameSuffix`	string
`nickname`	string

InitiatePaymentResponse

Prop	Type
`token`	{ paymentData?: string; transactionIdentifier: string; paymentMethod: { displayName?: string; secureElementPass?: { deviceAccountNumberSuffix: string; deviceAccountIdentifier: string; primaryAccountIdentifier: string; primaryAccountNumberSuffix: string; devicePassIdentifier?: string; pairedTerminalIdentifier?: string; }; }; }
`billingContact`	PaymentContact
`shippingContact`	PaymentContact