org.wisepersist.pinpayments.api

Interface CardTokensApi

All Known Implementing Classes:

CardTokensApiImpl

public interface CardTokensApi

The card tokens API allows you to securely store credit card details in exchange for a card token. This card token can then be used to create a single charge with the charges API, or to create multiple charges over time using the customers API.

Returned card information contains a member called primary, which says whether the card is a customer’s primary card. Its value is true if the card is a customer’s primary card, false if it is a non-primary card of the customer, and null if it is not associated with a customer.

A card token can only be used once, to create either a charge or a customer. If no charge or customer is created within 1 month, the token is automatically expired.

See Also:

https://pin.net.au/docs/api/cards

Method Summary

Modifier and Type	Method and Description
CardResponse	create(Card card) Creates a card token and returns its details.

Method Detail

create

CardResponse create(Card card)
             throws java.io.IOException

Creates a card token and returns its details.

Parameters:

card - The card specified.

Returns:

The details of the card created.

Throws:

java.io.IOException - If IO errors occur while calling PinPayments REST API.