com.braintreegateway

Class CreditCardGateway

java.lang.Object

com.braintreegateway.CreditCardGateway

public class CreditCardGateway
extends Object

Provides methods to create, delete, find, and update CreditCard objects. This class does not need to be instantiated directly. Instead, use BraintreeGateway.creditCard() to get an instance of this class:

 BraintreeGateway gateway = new BraintreeGateway(...);
 gateway.creditCard().create(...)
 

For more detailed information on CreditCards, see https://developers.braintreepayments.com/reference/response/credit-card/java
For more detailed information on credit card verifications, see https://developers.braintreepayments.com/reference/response/credit-card-verification/java

Field Summary

Fields

Modifier and Type	Field and Description
private Configuration	configuration
private Http	http

Constructor Summary

Constructors

Constructor and Description
CreditCardGateway(Http http, Configuration configuration)

Method Summary

Modifier and Type	Method and Description
Result<CreditCard>	confirmTransparentRedirect(String queryString) Deprecated. see TransparentRedirectGateway#confirmCreditCard(String)
Result<CreditCard>	create(CreditCardRequest request) Creates an CreditCard.
private String	dateQueryString(Calendar start, Calendar end)
Result<CreditCard>	delete(String token) Deletes a CreditCard.
ResourceCollection<CreditCard>	expired() Returns a ResourceCollection of all expired credit cards.
ResourceCollection<CreditCard>	expiringBetween(Calendar start, Calendar end) Returns a ResourceCollection of all credit cards expiring between the given calendars.
(package private) List<CreditCard>	fetchExpiredCreditCards(List<String> ids)
(package private) List<CreditCard>	fetchExpiringCreditCards(List<String> ids, String queryString)
CreditCard	find(String token) Finds a CreditCard.
Result<PaymentMethodNonce>	forward(PaymentMethodForwardRequest forwardRequest) Deprecated. use the Grant API instead
CreditCard	fromNonce(String nonce) Exchanges a payment method nonce for a CreditCard.
String	transparentRedirectURLForCreate() Deprecated. see TransparentRedirectGateway#url()
String	transparentRedirectURLForUpdate() Deprecated. see TransparentRedirectGateway#url()
Result<CreditCard>	update(String token, CreditCardRequest request) Updates a CreditCard.

Methods inherited from class java.lang.Object

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

Field Detail

configuration

private Configuration configuration

http

private Http http

Constructor Detail

CreditCardGateway

public CreditCardGateway(Http http,
                         Configuration configuration)

Method Detail

confirmTransparentRedirect

@Deprecated
public Result<CreditCard> confirmTransparentRedirect(String queryString)

Deprecated. see TransparentRedirectGateway#confirmCreditCard(String)

Please use gateway.transparentRedirect().confirmCreditCard() instead

Parameters:

queryString - the query string

Returns:

the credit card

create

public Result<CreditCard> create(CreditCardRequest request)

Creates an CreditCard.

Parameters:

request - the request.

Returns:

a Result.

delete

public Result<CreditCard> delete(String token)

Deletes a CreditCard.

Parameters:

token - the CreditCard's token.

Returns:

a Result.

find

public CreditCard find(String token)

Finds a CreditCard.

Parameters:

token - the CreditCard's token.

Returns:

the CreditCard or raises a NotFoundException.

fromNonce

public CreditCard fromNonce(String nonce)

Exchanges a payment method nonce for a CreditCard.

Parameters:

nonce - a payment method nonce.

Returns:

the CreditCard or raises a NotFoundException.

forward

@Deprecated
public Result<PaymentMethodNonce> forward(PaymentMethodForwardRequest forwardRequest)
                                               throws NotFoundException

Deprecated. use the Grant API instead

Please use the Grant API instead.

Parameters:

forwardRequest - the request

Returns:

the payment method nonce

Throws:

NotFoundException

transparentRedirectURLForCreate

@Deprecated
public String transparentRedirectURLForCreate()

Deprecated. see TransparentRedirectGateway#url()

Please use gateway.transparentRedirect().url() instead

Returns:

the redirect URL for create

transparentRedirectURLForUpdate

@Deprecated
public String transparentRedirectURLForUpdate()

Deprecated. see TransparentRedirectGateway#url()

Please use gateway.transparentRedirect().url() instead

Returns:

the redirect URL for update

update

public Result<CreditCard> update(String token,
                                 CreditCardRequest request)

Updates a CreditCard.

Parameters:

token - the CreditCard's token.

request - the request.

Returns:

a Result.

expired

public ResourceCollection<CreditCard> expired()

Returns a ResourceCollection of all expired credit cards.

Returns:

a ResourceCollection.

fetchExpiredCreditCards

List<CreditCard> fetchExpiredCreditCards(List<String> ids)

expiringBetween

public ResourceCollection<CreditCard> expiringBetween(Calendar start,
                                                      Calendar end)

Returns a ResourceCollection of all credit cards expiring between the given calendars.

Parameters:

start - the start date

end - the end date

Returns:

a ResourceCollection.

fetchExpiringCreditCards

List<CreditCard> fetchExpiringCreditCards(List<String> ids,
                                          String queryString)

dateQueryString

private String dateQueryString(Calendar start,
                               Calendar end)