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 http://www.braintreepayments.com/gateway/credit-card-api
For more detailed information on credit card verifications, see http://www.braintreepayments.com/gateway/credit-card- verification-api

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.
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) Returns a PaymentMethodNonce which can be used by another merchant
CreditCard	fromNonce(String nonce) Exchanges a payment method nonce for a CreditCard.
String	transparentRedirectURLForCreate() Deprecated.
String	transparentRedirectURLForUpdate() Deprecated.
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.

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

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

public Result<PaymentMethodNonce> forward(PaymentMethodForwardRequest forwardRequest)

Returns a PaymentMethodNonce which can be used by another merchant

Parameters:

token - the token representing the CreditCard to forward

receiving_merchant_id - the public ID of the merchant to forward to

Returns:

a Result containing a PaymentMethodNonce or raises a NotFoundException.

transparentRedirectURLForCreate

@Deprecated
public String transparentRedirectURLForCreate()

Deprecated.

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

transparentRedirectURLForUpdate

@Deprecated
public String transparentRedirectURLForUpdate()

Deprecated.

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

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.

Returns:

a ResourceCollection.

fetchExpiringCreditCards

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

dateQueryString

private String dateQueryString(Calendar start,
                               Calendar end)