Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fresha/capacitor-plugin-applepay
Capacitor plugin for Apple Pay payments
https://github.com/fresha/capacitor-plugin-applepay
applepay capacitor capacitor-community capacitor-ios capacitor-plugin capacitorjs
Last synced: 3 months ago
JSON representation
Capacitor plugin for Apple Pay payments
- Host: GitHub
- URL: https://github.com/fresha/capacitor-plugin-applepay
- Owner: fresha
- License: mit
- Archived: true
- Created: 2022-07-07T09:49:13.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-07-27T14:47:15.000Z (over 1 year ago)
- Last Synced: 2024-04-28T09:31:20.440Z (6 months ago)
- Topics: applepay, capacitor, capacitor-community, capacitor-ios, capacitor-plugin, capacitorjs
- Language: Swift
- Homepage:
- Size: 200 KB
- Stars: 16
- Watchers: 2
- Forks: 9
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-capacitor - Apple Pay - Get Apple Pay payments in your app. (Other plugins)
README
# @fresha/capacitor-plugin-applepay
[](https://www.npmjs.com/package/@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
```bash
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
## API
* [`canMakePayments()`](#canmakepayments)
* [`canMakePayments(...)`](#canmakepayments)
* [`initiatePayment(...)`](#initiatepayment)
* [`completeLastPayment(...)`](#completelastpayment)
* [Interfaces](#interfaces)
* [Type Aliases](#type-aliases)
### canMakePayments()
```typescript
canMakePayments() => Promise
```
Indicates whether the device supports Apple Pay.
**Returns:** Promise<CanMakePaymentsResponse>
--------------------
### canMakePayments(...)
```typescript
canMakePayments(options: CanMakePaymentsRequest) => Promise
```
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:** Promise<CanMakePaymentsResponse>
--------------------
### initiatePayment(...)
```typescript
initiatePayment(request: InitiatePaymentRequest) => Promise
```
Initiates a payment base on PaymentRequest object.
| Param | Type | Description |
| ------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **`request`** | InitiatePaymentRequest | - PaymentRequest object that will be used for the payment. |
**Returns:** Promise<InitiatePaymentResponse>
--------------------
### completeLastPayment(...)
```typescript
completeLastPayment(request: CompletePaymentRequest) => Promise
```
Completes current payment
| Param | Type | Description |
| ------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **`request`** | CompletePaymentRequest | - CompletePaymentRequest object containing status |
--------------------
### Interfaces
#### CanMakePaymentsResponse
| Prop | Type |
| --------------------- | -------------------- |
| **`canMakePayments`** | boolean |
#### CanMakePaymentsRequest
| Prop | Type |
| ------------------ | --------------------------------- |
| **`networks`** | PaymentNetwork[] |
| **`capabilities`** | MerchantCapability[] |
#### 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 |
#### 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 |
#### InitiatePaymentRequest
| Prop | Type |
| ----------------------------------- | --------------------------------------------------------- |
| **`merchantIdentifier`** | string |
| **`countryCode`** | string |
| **`currencyCode`** | string |
| **`supportedCountries`** | string[] |
| **`supportedNetworks`** | PaymentNetwork[] |
| **`summaryItems`** | PaymentSummaryItem[] |
| **`requiredShippingContactFields`** | ContactField[] |
| **`requiredBillingContactFields`** | ContactField[] |
| **`merchantCapabilities`** | MerchantCapability[] |
| **`billingContact`** | PaymentContact |
| **`shippingContact`** | PaymentContact |
#### PaymentSummaryItem
| Prop | Type |
| ------------ | ------------------------------------------------------------------------- |
| **`label`** | string |
| **`amount`** | string |
| **`type`** | PaymentSummaryItemType |
#### CompletePaymentRequest
| Prop | Type |
| ------------ | --------------------------------------------------------------------------- |
| **`status`** | PaymentCompletionStatus |
### Type Aliases
#### PaymentNetwork
'amex' | 'chinaUnionPay' | 'cartesBancaires' | 'discover' | 'eftpos' | 'electron' | 'idCredit' | 'interac' | 'JCB' | 'maestro' | 'masterCard' | 'privateLabel' | 'quicPay' | 'suica' | 'visa' | 'vPay'
#### MerchantCapability
'capability3DS' | 'capabilityCredit' | 'capabilityDebit' | 'capabilityEMV'
#### PaymentSummaryItemType
'pending' | 'final'
#### ContactField
'emailAddress' | 'name' | 'phoneNumber' | 'phoneticName' | 'postalAddress'
#### PaymentCompletionStatus
'success' | 'failure'