com.stripe.android.net

Class StripeApiHandler

java.lang.Object

com.stripe.android.net.StripeApiHandler

public class StripeApiHandler
extends java.lang.Object

Handler for calls to the Stripe API.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CHARSET
static java.lang.String	LIVE_API_BASE
static java.lang.String	TOKENS
static java.lang.String	VERSION

Constructor Summary

Constructors

Constructor and Description
StripeApiHandler()

Method Summary

Modifier and Type	Method and Description
static Token	createToken(java.util.Map<java.lang.String,java.lang.Object> cardParams, RequestOptions options) Create a Token using the input card parameters.
static Token	retrieveToken(RequestOptions options, java.lang.String tokenId) Retrieve a Token by its ID.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LIVE_API_BASE

public static final java.lang.String LIVE_API_BASE

See Also:

Constant Field Values

CHARSET

public static final java.lang.String CHARSET

See Also:

Constant Field Values

TOKENS

public static final java.lang.String TOKENS

See Also:

Constant Field Values

VERSION

public static final java.lang.String VERSION

See Also:

Constant Field Values

Constructor Detail

StripeApiHandler

public StripeApiHandler()

Method Detail

createToken

@Nullable
public static Token createToken(@NonNull
                                          java.util.Map<java.lang.String,java.lang.Object> cardParams,
                                          @NonNull
                                          RequestOptions options)
                                   throws AuthenticationException,
                                          InvalidRequestException,
                                          APIConnectionException,
                                          CardException,
                                          APIException

Create a Token using the input card parameters.

Parameters:

cardParams - a mapped set of parameters representing the object for which this token is being created

options - a RequestOptions object that contains connection data like the api key, api version, etc

Returns:

a Token that can be used to perform other operations with this card

Throws:

AuthenticationException - if there is a problem authenticating to the Stripe API

InvalidRequestException - if one or more of the parameters is incorrect

APIConnectionException - if there is a problem connecting to the Stripe API

CardException - if there is a problem with the card information

APIException - for unknown Stripe API errors. These should be rare.

retrieveToken

@Nullable
public static Token retrieveToken(@NonNull
                                            RequestOptions options,
                                            @NonNull
                                            java.lang.String tokenId)
                                     throws AuthenticationException,
                                            InvalidRequestException,
                                            APIConnectionException,
                                            APIException

Retrieve a Token by its ID.

Parameters:

options - a RequestOptions object that contains

tokenId - the id of the token that you're looking for

Returns:

a Token if one exists and you have the permissions to access it

Throws:

AuthenticationException - if there is a problem authenticating to the Stripe API

InvalidRequestException - if the token ID parameter is invalid

APIConnectionException - if there is a problem connecting to the Stripe API

APIException - for unknown Stripe API errors. These should be rare.