BraintreeFragment (Braintree API)

java.lang.Object
- BrowserSwitchFragment
- - com.braintreepayments.api.BraintreeFragment

```
public class BraintreeFragment
extends BrowserSwitchFragment
```
Core Braintree class that handles network requests and managing callbacks.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`EXTRA_WAS_BROWSER_SWITCH_RESULT`
`protected BraintreeApiHttpClient`	`mBraintreeApiClient`
`protected android.content.Context`	`mContext`
`protected GoogleApiClient`	`mGoogleApiClient`
`protected BraintreeGraphQLHttpClient`	`mGraphQLHttpClient`
`protected BraintreeHttpClient`	`mHttpClient`
`static java.lang.String`	`TAG` Deprecated. This constant is no longer used and will be removed in a future release. If you were using this constant to retrieve an instance of `BraintreeFragment`, you should instead call `BraintreeFragment.newInstance` with the authorization string. It will return an existing instance if one is present.

Constructor Summary

Constructors
Constructor and Description

BraintreeFragment()

Constructors
Constructor and Description
`BraintreeFragment()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<T extends BraintreeListener> void`	`addListener(T listener)` Adds a listener.
`protected void`	`fetchConfiguration()`
`protected void`	`flushCallbacks()`
`protected android.content.Context`	`getApplicationContext()`
`protected Authorization`	`getAuthorization()`
`protected BraintreeApiHttpClient`	`getBraintreeApiHttpClient()`
`java.util.List<PaymentMethodNonce>`	`getCachedPaymentMethodNonces()` After fetching the current customer's `PaymentMethodNonce`s using `PaymentMethod.getPaymentMethodNonces(BraintreeFragment)`, the `PaymentMethodNonce`s will be cached for the life time of this instance of `BraintreeFragment` and can be returned without additional network requests using this method.
`protected Configuration`	`getConfiguration()`
`protected GoogleApiClient`	`getGoogleApiClient()`
`void`	`getGoogleApiClient(BraintreeResponseListener<GoogleApiClient> listener)` Obtain an instance of a `GoogleApiClient` that is connected or connecting to be used for Android Pay.
`protected BraintreeGraphQLHttpClient`	`getGraphQLHttpClient()`
`protected BraintreeHttpClient`	`getHttpClient()`
`protected java.lang.String`	`getIntegrationType()`
`java.util.List<BraintreeListener>`	`getListeners()`
`java.lang.String`	`getReturnUrlScheme()`
`protected java.lang.String`	`getSessionId()`
`boolean`	`hasFetchedPaymentMethodNonces()` A boolean indicating whether the current customer's payment methods have been fetched with `PaymentMethod.getPaymentMethodNonces(BraintreeFragment)` yet.
`boolean`	`isActive()` Check if this Braintree fragment is still active.
`static BraintreeFragment`	`newInstance(AppCompatActivity activity, java.lang.String authorization)` NEXT_MAJOR_VERSION: remove this method in favor of BraintreeFragment#(FragmentActivity, String) Create a new instance of `BraintreeFragment` using the tokenization key or client token and add it to the `AppCompatActivity`'s `FragmentManager`.
`static BraintreeFragment`	`newInstance(FragmentActivity activity, java.lang.String authorization)` Create a new instance of `BraintreeFragment` using the tokenization key or client token and add it to the `FragmentActivity`'s `FragmentManager`.
`static BraintreeFragment`	`newInstance(Fragment fragment, java.lang.String authorization)` Create a new instance of `BraintreeFragment` using the tokenization key or client token and add it to the `Fragment`'s child `FragmentManager`.
`void`	`onActivityResult(int requestCode, int resultCode, android.content.Intent data)`
`void`	`onAttach(android.app.Activity activity)`
`void`	`onAttach(android.content.Context context)`
`void`	`onBrowserSwitchResult(int requestCode, BrowserSwitchResult browserSwitchResult, android.net.Uri uri)`
`void`	`onCreate(android.os.Bundle savedInstanceState)`
`void`	`onDestroy()`
`void`	`onDetach()`
`void`	`onPause()`
`void`	`onResume()`
`void`	`onSaveInstanceState(android.os.Bundle outState)`
`void`	`onStop()`
`protected void`	`postAmericanExpressCallback(AmericanExpressRewardsBalance rewardsBalance)`
`protected void`	`postCallback(BraintreePaymentResult result)`
`protected void`	`postCallback(java.lang.Exception error)`
`protected void`	`postCallback(java.util.List<PaymentMethodNonce> paymentMethodNonceList)`
`protected void`	`postCallback(PaymentMethodNonce paymentMethodNonce)`
`protected void`	`postCallback(UnionPayCapabilities capabilities)`
`protected void`	`postCancelCallback(int requestCode)`
`protected void`	`postConfigurationCallback()`
`protected void`	`postOrQueueCallback(QueuedCallback callback)`
`protected void`	`postPaymentMethodDeletedCallback(PaymentMethodNonce paymentMethodNonce)`
`protected void`	`postUnionPayCallback(java.lang.String enrollmentId, boolean smsCodeRequired)`
`<T extends BraintreeListener> void`	`removeListener(T listener)` Removes a previously added listener.
`void`	`sendAnalyticsEvent(java.lang.String eventFragment)`
`protected void`	`setConfiguration(Configuration configuration)`
`protected void`	`setConfigurationErrorListener(BraintreeResponseListener<java.lang.Exception> listener)`
`void`	`startActivityForResult(android.content.Intent intent, int requestCode)`
`protected void`	`waitForConfiguration(ConfigurationListener listener)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - TAG
```
@Deprecated
public static final java.lang.String TAG
```
    Deprecated. This constant is no longer used and will be removed in a future release. If you were using this constant to retrieve an instance of `BraintreeFragment`, you should instead call `BraintreeFragment.newInstance` with the authorization string. It will return an existing instance if one is present.
    
    See Also:
    
    Constant Field Values
  - EXTRA_WAS_BROWSER_SWITCH_RESULT
```
public static final java.lang.String EXTRA_WAS_BROWSER_SWITCH_RESULT
```
    See Also:
    
    Constant Field Values
  - mHttpClient
```
protected BraintreeHttpClient mHttpClient
```
  - mBraintreeApiClient
```
protected BraintreeApiHttpClient mBraintreeApiClient
```
  - mGraphQLHttpClient
```
protected BraintreeGraphQLHttpClient mGraphQLHttpClient
```
  - mGoogleApiClient
```
protected GoogleApiClient mGoogleApiClient
```
  - mContext
```
protected android.content.Context mContext
```
- Constructor Detail
  - BraintreeFragment
```
public BraintreeFragment()
```
- Method Detail
  - newInstance
```
public static BraintreeFragment newInstance(AppCompatActivity activity,
                                            java.lang.String authorization)
                                     throws InvalidArgumentException
```
    NEXT_MAJOR_VERSION: remove this method in favor of BraintreeFragment#(FragmentActivity, String) Create a new instance of BraintreeFragment using the tokenization key or client token and add it to the AppCompatActivity's FragmentManager. If a fragment has already been created with the provided authorization, the existing fragment will be returned.
    
    Parameters:
    
    activity - The AppCompatActivity to add the BraintreeFragment to.
    
    authorization - The tokenization key or client token to use.
    
    Returns:
    
    BraintreeFragment
    
    Throws:
    
    InvalidArgumentException - If the tokenization key or client token is not valid or cannot be parsed.
  - newInstance
```
public static BraintreeFragment newInstance(FragmentActivity activity,
                                            java.lang.String authorization)
                                     throws InvalidArgumentException
```
    Create a new instance of BraintreeFragment using the tokenization key or client token and add it to the FragmentActivity's FragmentManager. If a fragment has already been created with the provided authorization, the existing fragment will be returned.
    
    Parameters:
    
    activity - The FragmentActivity to add the BraintreeFragment to.
    
    authorization - The tokenization key or client token to use.
    
    Returns:
    
    BraintreeFragment
    
    Throws:
    
    InvalidArgumentException - If the tokenization key or client token is not valid or cannot be parsed.
  - newInstance
```
public static BraintreeFragment newInstance(Fragment fragment,
                                            java.lang.String authorization)
                                     throws InvalidArgumentException
```
    Create a new instance of BraintreeFragment using the tokenization key or client token and add it to the Fragment's child FragmentManager. If a fragment has already been created with the provided authorization, the existing fragment will be returned.
    
    Parameters:
    
    fragment - The Fragment to add the BraintreeFragment to.
    
    authorization - The tokenization key or client token to use.
    
    Returns:
    
    BraintreeFragment
    
    Throws:
    
    InvalidArgumentException - If the tokenization key or client token is not valid or cannot be parsed.
  - onCreate
```
public void onCreate(android.os.Bundle savedInstanceState)
```
  - onAttach
```
public void onAttach(android.content.Context context)
```
  - onAttach
```
public void onAttach(android.app.Activity activity)
```
  - onResume
```
public void onResume()
```
  - onPause
```
public void onPause()
```
  - onSaveInstanceState
```
public void onSaveInstanceState(android.os.Bundle outState)
```
  - onStop
```
public void onStop()
```
  - onDetach
```
public void onDetach()
```
  - onDestroy
```
public void onDestroy()
```
  - startActivityForResult
```
public void startActivityForResult(android.content.Intent intent,
                                   int requestCode)
```
  - getReturnUrlScheme
```
public java.lang.String getReturnUrlScheme()
```
  - onBrowserSwitchResult
```
public void onBrowserSwitchResult(int requestCode,
                                  BrowserSwitchResult browserSwitchResult,
                                  android.net.Uri uri)
```
  - onActivityResult
```
public void onActivityResult(int requestCode,
                             int resultCode,
                             android.content.Intent data)
```
  - addListener
```
public <T extends BraintreeListener> void addListener(T listener)
```
    Adds a listener.
    
    Parameters:
    
    listener - the listener to add.
  - removeListener
```
public <T extends BraintreeListener> void removeListener(T listener)
```
    Removes a previously added listener.
    
    Parameters:
    
    listener - the listener to remove.
  - getListeners
```
public java.util.List<BraintreeListener> getListeners()
```
    Returns:
    
    ArrayList of the currently attached listeners
  - hasFetchedPaymentMethodNonces
```
public boolean hasFetchedPaymentMethodNonces()
```
    A boolean indicating whether the current customer's payment methods have been fetched with PaymentMethod.getPaymentMethodNonces(BraintreeFragment) yet.
    
    Returns:
    
    true if the current customer's payment methods have been fetched, false otherwise.
  - getCachedPaymentMethodNonces
```
public java.util.List<PaymentMethodNonce> getCachedPaymentMethodNonces()
```
    After fetching the current customer's PaymentMethodNonces using PaymentMethod.getPaymentMethodNonces(BraintreeFragment), the PaymentMethodNonces will be cached for the life time of this instance of BraintreeFragment and can be returned without additional network requests using this method.
    
    Returns:
    
    Lists for the current customer.
  - isActive
```
public boolean isActive()
```
    Check if this Braintree fragment is still active.
    
    Returns:
    
    true if still active and process can proceed, false otherwise.
  - sendAnalyticsEvent
```
public void sendAnalyticsEvent(java.lang.String eventFragment)
```
  - postConfigurationCallback
```
protected void postConfigurationCallback()
```
  - postCancelCallback
```
protected void postCancelCallback(int requestCode)
```
  - postCallback
```
protected void postCallback(PaymentMethodNonce paymentMethodNonce)
```
  - postCallback
```
protected void postCallback(UnionPayCapabilities capabilities)
```
  - postUnionPayCallback
```
protected void postUnionPayCallback(java.lang.String enrollmentId,
                                    boolean smsCodeRequired)
```
  - postCallback
```
protected void postCallback(BraintreePaymentResult result)
```
  - postAmericanExpressCallback
```
protected void postAmericanExpressCallback(AmericanExpressRewardsBalance rewardsBalance)
```
  - postCallback
```
protected void postCallback(java.util.List<PaymentMethodNonce> paymentMethodNonceList)
```
  - postPaymentMethodDeletedCallback
```
protected void postPaymentMethodDeletedCallback(PaymentMethodNonce paymentMethodNonce)
```
  - postCallback
```
protected void postCallback(java.lang.Exception error)
```
  - postOrQueueCallback
```
protected void postOrQueueCallback(QueuedCallback callback)
```
  - flushCallbacks
```
protected void flushCallbacks()
```
  - fetchConfiguration
```
protected void fetchConfiguration()
```
  - setConfigurationErrorListener
```
protected void setConfigurationErrorListener(BraintreeResponseListener<java.lang.Exception> listener)
```
  - waitForConfiguration
```
protected void waitForConfiguration(ConfigurationListener listener)
```
  - getAuthorization
```
protected Authorization getAuthorization()
```
  - getApplicationContext
```
protected android.content.Context getApplicationContext()
```
  - getConfiguration
```
protected Configuration getConfiguration()
```
  - setConfiguration
```
protected void setConfiguration(Configuration configuration)
```
  - getHttpClient
```
protected BraintreeHttpClient getHttpClient()
```
  - getBraintreeApiHttpClient
```
protected BraintreeApiHttpClient getBraintreeApiHttpClient()
```
  - getGraphQLHttpClient
```
protected BraintreeGraphQLHttpClient getGraphQLHttpClient()
```
  - getSessionId
```
protected java.lang.String getSessionId()
```
  - getIntegrationType
```
protected java.lang.String getIntegrationType()
```
  - getGoogleApiClient
```
public void getGoogleApiClient(BraintreeResponseListener<GoogleApiClient> listener)
```
    Obtain an instance of a GoogleApiClient that is connected or connecting to be used for Android Pay. This instance will be automatically disconnected in onStop() and automatically connected in onResume().
    Connection failed and connection suspended errors will be sent to BraintreeErrorListener.onError(Exception).
    
    Parameters:
    
    listener - BraintreeResponseListener to receive the GoogleApiClient in BraintreeResponseListener#onResponse(GoogleApiClient).
  - getGoogleApiClient
```
protected GoogleApiClient getGoogleApiClient()
```

Class BraintreeFragment

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TAG

EXTRA_WAS_BROWSER_SWITCH_RESULT

mHttpClient

mBraintreeApiClient

mGraphQLHttpClient

mGoogleApiClient

mContext

Constructor Detail

BraintreeFragment

Method Detail

newInstance

newInstance

newInstance

onCreate

onAttach

onAttach

onResume

onPause

onSaveInstanceState

onStop

onDetach

onDestroy

startActivityForResult

getReturnUrlScheme

onBrowserSwitchResult

onActivityResult

addListener

removeListener

getListeners

hasFetchedPaymentMethodNonces

getCachedPaymentMethodNonces

isActive

sendAnalyticsEvent

postConfigurationCallback

postCancelCallback

postCallback

postCallback

postUnionPayCallback

postCallback

postAmericanExpressCallback

postCallback

postPaymentMethodDeletedCallback

postCallback

postOrQueueCallback

flushCallbacks

fetchConfiguration

setConfigurationErrorListener

waitForConfiguration

getAuthorization

getApplicationContext

getConfiguration

setConfiguration

getHttpClient

getBraintreeApiHttpClient

getGraphQLHttpClient

getSessionId

getIntegrationType

getGoogleApiClient

getGoogleApiClient