Constructor Detail

Method Detail

• withRawResponse

   abstract CardServiceAsync.WithRawResponse withRawResponse()

  Returns a view of this service that provides access to raw HTTP responses for each method.

• withOptions

   abstract CardServiceAsync withOptions(Consumer<ClientOptions.Builder> modifier)

  Returns a view of this service with the given option modifications applied.

  The original service is not modified.

• aggregateBalances

   abstract AggregateBalanceServiceAsync aggregateBalances()

• balances

   abstract BalanceServiceAsync balances()

• financialTransactions

   abstract FinancialTransactionServiceAsync financialTransactions()

• create

   CompletableFuture<Card> create(CardCreateParams params)

  Create a new virtual or physical card. Parameters shipping_address and product_id only apply to physical cards.

• create

   abstract CompletableFuture<Card> create(CardCreateParams params, RequestOptions requestOptions)

• retrieve

   CompletableFuture<Card> retrieve(String cardToken)

  Get card configuration such as spend limit and state.

• retrieve

   CompletableFuture<Card> retrieve(String cardToken, CardRetrieveParams params, RequestOptions requestOptions)

• retrieve

   CompletableFuture<Card> retrieve(String cardToken, CardRetrieveParams params)

• retrieve

   abstract CompletableFuture<Card> retrieve(CardRetrieveParams params, RequestOptions requestOptions)

• retrieve

   CompletableFuture<Card> retrieve(CardRetrieveParams params)

• retrieve

   CompletableFuture<Card> retrieve(String cardToken, RequestOptions requestOptions)

• update

   CompletableFuture<Card> update(String cardToken)

  Update the specified properties of the card. Unsupplied properties will remain unchanged.

  Note: setting a card to a CLOSED state is a final action that cannot be undone.

• update

   CompletableFuture<Card> update(String cardToken, CardUpdateParams params, RequestOptions requestOptions)

• update

   CompletableFuture<Card> update(String cardToken, CardUpdateParams params)

• update

   abstract CompletableFuture<Card> update(CardUpdateParams params, RequestOptions requestOptions)

• update

   CompletableFuture<Card> update(CardUpdateParams params)

• update

   CompletableFuture<Card> update(String cardToken, RequestOptions requestOptions)

• list

   CompletableFuture<CardListPageAsync> list()

  List cards.

• list

   abstract CompletableFuture<CardListPageAsync> list(CardListParams params, RequestOptions requestOptions)

• list

   CompletableFuture<CardListPageAsync> list(CardListParams params)

• list

   CompletableFuture<CardListPageAsync> list(RequestOptions requestOptions)

• convertPhysical

   CompletableFuture<Card> convertPhysical(String cardToken, CardConvertPhysicalParams params)

  Convert a virtual card into a physical card and manufacture it. Customer must supply relevant fields for physical card creation including product_id, carrier, shipping_method, and shipping_address. The card token will be unchanged. The card's type will be altered to PHYSICAL. The card will be set to state PENDING_FULFILLMENT and fulfilled at next fulfillment cycle. Virtual cards created on card programs which do not support physical cards cannot be converted. The card program cannot be changed as part of the conversion. Cards must be in an OPEN state to be converted. Only applies to cards of type VIRTUAL (or existing cards with deprecated types of DIGITAL_WALLET and UNLOCKED).

• convertPhysical

   CompletableFuture<Card> convertPhysical(String cardToken, CardConvertPhysicalParams params, RequestOptions requestOptions)

• convertPhysical

   CompletableFuture<Card> convertPhysical(CardConvertPhysicalParams params)

• convertPhysical

   abstract CompletableFuture<Card> convertPhysical(CardConvertPhysicalParams params, RequestOptions requestOptions)

• embed

   CompletableFuture<String> embed(CardEmbedParams params)

  Handling full card PANs and CVV codes requires that you comply with the Payment Card Industry Data Security Standards (PCI DSS). Some clients choose to reduce their compliance obligations by leveraging our embedded card UI solution documented below.

  In this setup, PANs and CVV codes are presented to the end-user via a card UI that we provide, optionally styled in the customer's branding using a specified css stylesheet. A user's browser makes the request directly to api.lithic.com, so card PANs and CVVs never touch the API customer's servers while full card data is displayed to their end-users. The response contains an HTML document (see Embedded Card UI or Changelog for upcoming changes in January). This means that the url for the request can be inserted straight into the src attribute of an iframe.

  <iframe id="card-iframe"
          src="https://sandbox.lithic.com/v1/embed/card?embed_request=eyJjc3MiO...;hmac=r8tx1..."
          allow="clipboard-write" class="content"></iframe>

  You should compute the request payload on the server side. You can render it (or the whole iframe) on the server or make an ajax call from your front end code, but do not ever embed your API key into front end code, as doing so introduces a serious security vulnerability.

• embed

   abstract CompletableFuture<String> embed(CardEmbedParams params, RequestOptions requestOptions)

• provision

   CompletableFuture<CardProvisionResponse> provision(String cardToken)

  Allow your cardholders to directly add payment cards to the device's digital wallet (e.g. Apple Pay) with one touch from your app.

  This requires some additional setup and configuration. Please Contact Us or your Customer Success representative for more information.

• provision

   CompletableFuture<CardProvisionResponse> provision(String cardToken, CardProvisionParams params, RequestOptions requestOptions)

• provision

   CompletableFuture<CardProvisionResponse> provision(String cardToken, CardProvisionParams params)

• provision

   abstract CompletableFuture<CardProvisionResponse> provision(CardProvisionParams params, RequestOptions requestOptions)

• provision

   CompletableFuture<CardProvisionResponse> provision(CardProvisionParams params)

• provision

   CompletableFuture<CardProvisionResponse> provision(String cardToken, RequestOptions requestOptions)

• reissue

   CompletableFuture<Card> reissue(String cardToken)

  Initiate print and shipment of a duplicate physical card (e.g. card is physically damaged). The PAN, expiry, and CVC2 will remain the same and the original card can continue to be used until the new card is activated. Only applies to cards of type PHYSICAL. A card can be reissued or renewed a total of 8 times.

• reissue

   CompletableFuture<Card> reissue(String cardToken, CardReissueParams params, RequestOptions requestOptions)

• reissue

   CompletableFuture<Card> reissue(String cardToken, CardReissueParams params)

• reissue

   abstract CompletableFuture<Card> reissue(CardReissueParams params, RequestOptions requestOptions)

• reissue

   CompletableFuture<Card> reissue(CardReissueParams params)

• reissue

   CompletableFuture<Card> reissue(String cardToken, RequestOptions requestOptions)

• renew

   CompletableFuture<Card> renew(String cardToken, CardRenewParams params)

  Applies to card types PHYSICAL and VIRTUAL. For PHYSICAL, creates a new card with the same card token and PAN, but updated expiry and CVC2 code. The original card will keep working for card-present transactions until the new card is activated. For card-not-present transactions, the original card details (expiry, CVC2) will also keep working until the new card is activated. A PHYSICAL card can be reissued or renewed a total of 8 times. For VIRTUAL, the card will retain the same card token and PAN and receive an updated expiry and CVC2 code. product_id, shipping_method, shipping_address, carrier are only relevant for renewing PHYSICAL cards.

• renew

   CompletableFuture<Card> renew(String cardToken, CardRenewParams params, RequestOptions requestOptions)

• renew

   CompletableFuture<Card> renew(CardRenewParams params)

• renew

   abstract CompletableFuture<Card> renew(CardRenewParams params, RequestOptions requestOptions)

• retrieveSpendLimits

   CompletableFuture<CardSpendLimits> retrieveSpendLimits(String cardToken)

  Get a Card's available spend limit, which is based on the spend limit configured on the Card and the amount already spent over the spend limit's duration. For example, if the Card has a monthly spend limit of

  $1000 configured, and has spent $

  600 in the last month, the available spend limit returned would be $400.

• retrieveSpendLimits

   CompletableFuture<CardSpendLimits> retrieveSpendLimits(String cardToken, CardRetrieveSpendLimitsParams params, RequestOptions requestOptions)

• retrieveSpendLimits

   CompletableFuture<CardSpendLimits> retrieveSpendLimits(String cardToken, CardRetrieveSpendLimitsParams params)

• retrieveSpendLimits

   abstract CompletableFuture<CardSpendLimits> retrieveSpendLimits(CardRetrieveSpendLimitsParams params, RequestOptions requestOptions)

• retrieveSpendLimits

   CompletableFuture<CardSpendLimits> retrieveSpendLimits(CardRetrieveSpendLimitsParams params)

• retrieveSpendLimits

   CompletableFuture<CardSpendLimits> retrieveSpendLimits(String cardToken, RequestOptions requestOptions)

• searchByPan

   CompletableFuture<Card> searchByPan(CardSearchByPanParams params)

  Get card configuration such as spend limit and state. Customers must be PCI compliant to use this endpoint. Please contact [email protected] for questions. Note: this is a POST endpoint because it is more secure to send sensitive data in a request body than in a URL.

• searchByPan

   abstract CompletableFuture<Card> searchByPan(CardSearchByPanParams params, RequestOptions requestOptions)

• webProvision

   CompletableFuture<CardWebProvisionResponse> webProvision(String cardToken)

  Allow your cardholders to directly add payment cards to the device's digital wallet from a browser on the web. Currently only suported for Apple Pay.

  This requires some additional setup and configuration. Please Contact Us or your Customer Success representative for more information.

• webProvision

   CompletableFuture<CardWebProvisionResponse> webProvision(String cardToken, CardWebProvisionParams params, RequestOptions requestOptions)

• webProvision

   CompletableFuture<CardWebProvisionResponse> webProvision(String cardToken, CardWebProvisionParams params)

• webProvision

   abstract CompletableFuture<CardWebProvisionResponse> webProvision(CardWebProvisionParams params, RequestOptions requestOptions)

• webProvision

   CompletableFuture<CardWebProvisionResponse> webProvision(CardWebProvisionParams params)

• webProvision

   CompletableFuture<CardWebProvisionResponse> webProvision(String cardToken, RequestOptions requestOptions)

• getEmbedHtml

   abstract CompletableFuture<String> getEmbedHtml(CardGetEmbedHtmlParams params, RequestOptions requestOptions)

• getEmbedUrl

   abstract String getEmbedUrl(CardGetEmbedUrlParams params, RequestOptions requestOptions)