1.0.2 • Published 10 months ago

capacitor-sumup v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
10 months ago

Capacitor.js SumUp plugin

A Capacitor.js bridge to SumUp native SDKs.

Install

npm install capacitor-sumup
npx cap sync

Import it into your project and enjoy the ride.

import { SumUp } from 'capacitor-sumup'

await SumUp.login({
    affiliateKey: 'YOUR-AFFILIATE-KEY',
    accessToken: 'YOUR-ACCESS-TOKEN'
})

Setup

iOS (update your Info.plist file)

NSLocationWhenInUseUsageDescription
NSBluetoothAlwaysUsageDescription
NSBluetoothPeripheralUsageDescription (unless your deployment target is at least iOS 13)

Android

Add the repository to your gradle dependencies (to your root build.gradle file)

allprojects {
   repositories {
      maven { url 'https://maven.sumup.com/releases' }
   }
}

Add the dependency to a module (to your module's build.gradle file)

implementation 'com.sumup:merchant-sdk:5.0.1'

Also, the minSdkVersion must be at least 26 in your Capacitor.js project.

API

login(...)

login(options: LoginOptions) => Promise<void>

Login to a SumUp account.

ParamType
optionsLoginOptions

checkout(...)

checkout(options: CheckoutOptions) => Promise<CheckoutResult>

Make a payment on a card reader. Everything is handled by the internal SDKs.

ParamType
optionsCheckoutOptions

Returns: Promise<CheckoutResult>


wakeUp()

wakeUp() => Promise<void>

Prepare the connected card reader for a possible upcoming checkout.


logout()

logout() => Promise<void>

Disconnect and logout.


Interfaces

LoginOptions

PropTypeDescription
affiliateKeystringAffiliate key generated on the SumUp dev portal
accessTokenstringAccess token retrieved from SumUp API

CheckoutResult

PropTypeDescription
transactionCodestringUnique SumUp transaction ID of successful payment
additionalInfo{ key: string: any; }Additional infos returned by the SDKs

CheckoutOptions

PropTypeDescription
amountnumberAmount to be charged
currencyCodestring | nullISO 4217 currency code. Defaults to HUF
titlestring | nullMessage to be shown on specific card readers. Defaults to "Time to Pay"
foreignTransactionIDstring | nullUnique ID of the transaction on client side (optional)
tipAmountnumber | nullAmount to tip, works only on specific card readers
skipReceiptScreenboolean | nullWhether to skip the receipt screen on successful payment
1.0.2

10 months ago

1.0.1

12 months ago

1.0.0

12 months ago

0.0.3

12 months ago

0.0.2

12 months ago

0.0.1

12 months ago