@projektionisten/capacitor-braintree v0.0.4

@projektionisten/capacitor-braintree

Braintree is a payment platform many developers use to facilitate specifically paypal payments in their apps, but other payment methods like Google/Apple Pay and credit cards are available through the Braintree SDK. This Capacitor plugin is meant to provide ways to use that SDK for different platforms through a web app

Install

NPM

npm i @projektionisten/capacitor-braintree
npx cap sync

YARN

yarn add @projektionisten/capacitor-braintree
npx cap sync

Android

For the paypal browser flow to work, you need to add this overload to the MainActivity of your android project

@Override
protected void onNewIntent(Intent newIntent) {
    super.onNewIntent(newIntent);

    setIntent(newIntent);
}

Also, an intent-filter for returning into the app needs to be defined. The ${applicationId} does not need to be replaced by anything, it automatically inserts the package name of the application

Beware: If your package name includes special characters like an _underscore, the intent filter is not going to work and you have to replace ${applicationId} with a version of your package name with the special characters removed. For example, if your package name is com.package_name.example, the scheme would have to be com.packagename.example.braintree

<intent-filter >
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="${applicationId}.braintree" />
</intent-filter>

If you want to enable GooglePay, you also need to add this meta tag to the application element in your Manifest file

<meta-data android:name="com.google.android.gms.wallet.api.enabled" android:value="true"/>

API

• setClientToken(...)
• startPaypalPayment(...)
• startApplePayPayment(...)
• startGooglePayPayment(...)
• isGooglePayReady()
• isApplePayReady()
• Interfaces
• Enums

setClientToken(...)

setClientToken(options: TokenOptions) => Promise<void>

This updates the plugin with a new auth token.

This needs to be called before the SDK can be used.

startPaypalPayment(...)

startPaypalPayment(options: PaypalPaymentOptions) => Promise<PaymentUIResult>

Starts a transaction with the paypal sdk. Will open a seperate browser window or similar to complete and return with information about the used account and the payment nonce

Returns: Promise<PaymentUIResult>

startApplePayPayment(...)

startApplePayPayment(options: ApplePaymentOptions) => Promise<PaymentUIResult>

Starts a transaction with the apple pay sdk. Will open a seperate browser window or similar to complete and return with information about the used account and the payment nonce

Returns: Promise<PaymentUIResult>

startGooglePayPayment(...)

startGooglePayPayment(options: GooglePaymentOptions) => Promise<PaymentUIResult>

Starts a transaction with the google pay sdk. Will open a seperate browser window or similar to complete and return with information about the used account and the payment nonce

Returns: Promise<PaymentUIResult>

isGooglePayReady()

isGooglePayReady() => Promise<PaymentMethodReadyResult>

Google pay specifically offers a method to wait for it to be ready to use. Returns a promise that resolves when it is ready.

Returns: Promise<PaymentMethodReadyResult>

isApplePayReady()

isApplePayReady() => Promise<PaymentMethodReadyResult>

Check if apple pay is available on this device

Returns: Promise<PaymentMethodReadyResult>

Interfaces

TokenOptions

Options for setting up payment tokens

PaymentUIResult

Successful callback result for the payment methods.

PaypalPaymentOptions

Options for the payment methods.

ApplePaymentOptions

Options for the payment methods.

GooglePaymentOptions

Options for the payment methods.

PaymentMethodReadyResult

Result for a method that checks if a given payment method is ready to be used

Enums

CREDIT_CARD_NETWORK

PAYPAL_PAYMENT_FLOW

PAYPAL_USER_ACTION