com.squareup.square.api

Class DefaultSubscriptionsApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultSubscriptionsApi

All Implemented Interfaces:

SubscriptionsApi

public final class DefaultSubscriptionsApi
extends BaseApi
implements SubscriptionsApi

This class lists all the endpoints of the groups.

Nested Class Summary

Nested classes/interfaces inherited from class com.squareup.square.api.BaseApi

BaseApi.RequestExecutor, BaseApi.RequestSupplier, BaseApi.ResponseHandler<T>

Field Summary

Fields inherited from class com.squareup.square.api.BaseApi

authManagers, config, httpCallback, internalUserAgent

Constructor Summary

Constructors

Constructor and Description
DefaultSubscriptionsApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers) Initializes the controller.
DefaultSubscriptionsApi(Configuration config, HttpClient httpClient, Map<String,AuthManager> authManagers, HttpCallback httpCallback) Initializes the controller with HTTPCallback.

Method Summary

Modifier and Type	Method and Description
CancelSubscriptionResponse	cancelSubscription(String subscriptionId) Schedules a `CANCEL` action to cancel an active subscription by setting the `canceled_date` field to the end of the active billing period and changing the subscription status from ACTIVE to CANCELED after this date.
CompletableFuture<CancelSubscriptionResponse>	cancelSubscriptionAsync(String subscriptionId) Schedules a `CANCEL` action to cancel an active subscription by setting the `canceled_date` field to the end of the active billing period and changing the subscription status from ACTIVE to CANCELED after this date.
CreateSubscriptionResponse	createSubscription(CreateSubscriptionRequest body) Creates a subscription to a subscription plan by a customer.
CompletableFuture<CreateSubscriptionResponse>	createSubscriptionAsync(CreateSubscriptionRequest body) Creates a subscription to a subscription plan by a customer.
DeleteSubscriptionActionResponse	deleteSubscriptionAction(String subscriptionId, String actionId) Deletes a scheduled action for a subscription.
CompletableFuture<DeleteSubscriptionActionResponse>	deleteSubscriptionActionAsync(String subscriptionId, String actionId) Deletes a scheduled action for a subscription.
ListSubscriptionEventsResponse	listSubscriptionEvents(String subscriptionId, String cursor, Integer limit) Lists all events for a specific subscription.
CompletableFuture<ListSubscriptionEventsResponse>	listSubscriptionEventsAsync(String subscriptionId, String cursor, Integer limit) Lists all events for a specific subscription.
PauseSubscriptionResponse	pauseSubscription(String subscriptionId, PauseSubscriptionRequest body) Schedules a `PAUSE` action to pause an active subscription.
CompletableFuture<PauseSubscriptionResponse>	pauseSubscriptionAsync(String subscriptionId, PauseSubscriptionRequest body) Schedules a `PAUSE` action to pause an active subscription.
ResumeSubscriptionResponse	resumeSubscription(String subscriptionId, ResumeSubscriptionRequest body) Schedules a `RESUME` action to resume a paused or a deactivated subscription.
CompletableFuture<ResumeSubscriptionResponse>	resumeSubscriptionAsync(String subscriptionId, ResumeSubscriptionRequest body) Schedules a `RESUME` action to resume a paused or a deactivated subscription.
RetrieveSubscriptionResponse	retrieveSubscription(String subscriptionId, String include) Retrieves a subscription.
CompletableFuture<RetrieveSubscriptionResponse>	retrieveSubscriptionAsync(String subscriptionId, String include) Retrieves a subscription.
SearchSubscriptionsResponse	searchSubscriptions(SearchSubscriptionsRequest body) Searches for subscriptions.
CompletableFuture<SearchSubscriptionsResponse>	searchSubscriptionsAsync(SearchSubscriptionsRequest body) Searches for subscriptions.
SwapPlanResponse	swapPlan(String subscriptionId, SwapPlanRequest body) Schedules a `SWAP_PLAN` action to swap a subscription plan in an existing subscription.
CompletableFuture<SwapPlanResponse>	swapPlanAsync(String subscriptionId, SwapPlanRequest body) Schedules a `SWAP_PLAN` action to swap a subscription plan in an existing subscription.
UpdateSubscriptionResponse	updateSubscription(String subscriptionId, UpdateSubscriptionRequest body) Updates a subscription.
CompletableFuture<UpdateSubscriptionResponse>	updateSubscriptionAsync(String subscriptionId, UpdateSubscriptionRequest body) Updates a subscription.

Methods inherited from class com.squareup.square.api.BaseApi

getClientInstance, getHttpCallback, makeHttpCallAsync, validateResponse

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultSubscriptionsApi

public DefaultSubscriptionsApi(Configuration config,
                               HttpClient httpClient,
                               Map<String,AuthManager> authManagers)

Initializes the controller.

Parameters:

config - Configurations added in client.

httpClient - Send HTTP requests and read the responses.

authManagers - Apply authorization to requests.

DefaultSubscriptionsApi

public DefaultSubscriptionsApi(Configuration config,
                               HttpClient httpClient,
                               Map<String,AuthManager> authManagers,
                               HttpCallback httpCallback)

Initializes the controller with HTTPCallback.

Parameters:

config - Configurations added in client.

httpClient - Send HTTP requests and read the responses.

authManagers - Apply authorization to requests.

httpCallback - Callback to be called before and after the HTTP call.

Method Detail

createSubscription

public CreateSubscriptionResponse createSubscription(CreateSubscriptionRequest body)
                                              throws ApiException,
                                                     IOException

Creates a subscription to a subscription plan by a customer. If you provide a card on file in the request, Square charges the card for the subscription. Otherwise, Square bills an invoice to the customer's email address. The subscription starts immediately, unless the request includes the optional `start_date`. Each individual subscription is associated with a particular location.

Specified by:

createSubscription in interface SubscriptionsApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the CreateSubscriptionResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

createSubscriptionAsync

public CompletableFuture<CreateSubscriptionResponse> createSubscriptionAsync(CreateSubscriptionRequest body)

Creates a subscription to a subscription plan by a customer. If you provide a card on file in the request, Square charges the card for the subscription. Otherwise, Square bills an invoice to the customer's email address. The subscription starts immediately, unless the request includes the optional `start_date`. Each individual subscription is associated with a particular location.

Specified by:

createSubscriptionAsync in interface SubscriptionsApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the CreateSubscriptionResponse response from the API call

searchSubscriptions

public SearchSubscriptionsResponse searchSubscriptions(SearchSubscriptionsRequest body)
                                                throws ApiException,
                                                       IOException

Searches for subscriptions. Results are ordered chronologically by subscription creation date. If the request specifies more than one location ID, the endpoint orders the result by location ID, and then by creation date within each location. If no locations are given in the query, all locations are searched. You can also optionally specify `customer_ids` to search by customer. If left unset, all customers associated with the specified locations are returned. If the request specifies customer IDs, the endpoint orders results first by location, within location by customer ID, and within customer by subscription creation date. For more information, see [Retrieve subscriptions](https://developer.squareup.com/docs/subscriptions-api/overview#retrieve-subscriptions).

Specified by:

searchSubscriptions in interface SubscriptionsApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the SearchSubscriptionsResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

searchSubscriptionsAsync

public CompletableFuture<SearchSubscriptionsResponse> searchSubscriptionsAsync(SearchSubscriptionsRequest body)

Searches for subscriptions. Results are ordered chronologically by subscription creation date. If the request specifies more than one location ID, the endpoint orders the result by location ID, and then by creation date within each location. If no locations are given in the query, all locations are searched. You can also optionally specify `customer_ids` to search by customer. If left unset, all customers associated with the specified locations are returned. If the request specifies customer IDs, the endpoint orders results first by location, within location by customer ID, and within customer by subscription creation date. For more information, see [Retrieve subscriptions](https://developer.squareup.com/docs/subscriptions-api/overview#retrieve-subscriptions).

Specified by:

searchSubscriptionsAsync in interface SubscriptionsApi

Parameters:

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the SearchSubscriptionsResponse response from the API call

retrieveSubscription

public RetrieveSubscriptionResponse retrieveSubscription(String subscriptionId,
                                                         String include)
                                                  throws ApiException,
                                                         IOException

Retrieves a subscription.

Specified by:

retrieveSubscription in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to retrieve.

include - Optional parameter: A query parameter to specify related information to be included in the response. The supported query parameter values are: - `actions`: to include scheduled actions on the targeted subscription.

Returns:

Returns the RetrieveSubscriptionResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

retrieveSubscriptionAsync

public CompletableFuture<RetrieveSubscriptionResponse> retrieveSubscriptionAsync(String subscriptionId,
                                                                                 String include)

Retrieves a subscription.

Specified by:

retrieveSubscriptionAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to retrieve.

include - Optional parameter: A query parameter to specify related information to be included in the response. The supported query parameter values are: - `actions`: to include scheduled actions on the targeted subscription.

Returns:

Returns the RetrieveSubscriptionResponse response from the API call

updateSubscription

public UpdateSubscriptionResponse updateSubscription(String subscriptionId,
                                                     UpdateSubscriptionRequest body)
                                              throws ApiException,
                                                     IOException

Updates a subscription. You can set, modify, and clear the `subscription` field values.

Specified by:

updateSubscription in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to update.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the UpdateSubscriptionResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

updateSubscriptionAsync

public CompletableFuture<UpdateSubscriptionResponse> updateSubscriptionAsync(String subscriptionId,
                                                                             UpdateSubscriptionRequest body)

Updates a subscription. You can set, modify, and clear the `subscription` field values.

Specified by:

updateSubscriptionAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to update.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the UpdateSubscriptionResponse response from the API call

deleteSubscriptionAction

public DeleteSubscriptionActionResponse deleteSubscriptionAction(String subscriptionId,
                                                                 String actionId)
                                                          throws ApiException,
                                                                 IOException

Deletes a scheduled action for a subscription.

Specified by:

deleteSubscriptionAction in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription the targeted action is to act upon.

actionId - Required parameter: The ID of the targeted action to be deleted.

Returns:

Returns the DeleteSubscriptionActionResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

deleteSubscriptionActionAsync

public CompletableFuture<DeleteSubscriptionActionResponse> deleteSubscriptionActionAsync(String subscriptionId,
                                                                                         String actionId)

Deletes a scheduled action for a subscription.

Specified by:

deleteSubscriptionActionAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription the targeted action is to act upon.

actionId - Required parameter: The ID of the targeted action to be deleted.

Returns:

Returns the DeleteSubscriptionActionResponse response from the API call

cancelSubscription

public CancelSubscriptionResponse cancelSubscription(String subscriptionId)
                                              throws ApiException,
                                                     IOException

Schedules a `CANCEL` action to cancel an active subscription by setting the `canceled_date` field to the end of the active billing period and changing the subscription status from ACTIVE to CANCELED after this date.

Specified by:

cancelSubscription in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to cancel.

Returns:

Returns the CancelSubscriptionResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

cancelSubscriptionAsync

public CompletableFuture<CancelSubscriptionResponse> cancelSubscriptionAsync(String subscriptionId)

Schedules a `CANCEL` action to cancel an active subscription by setting the `canceled_date` field to the end of the active billing period and changing the subscription status from ACTIVE to CANCELED after this date.

Specified by:

cancelSubscriptionAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to cancel.

Returns:

Returns the CancelSubscriptionResponse response from the API call

listSubscriptionEvents

public ListSubscriptionEventsResponse listSubscriptionEvents(String subscriptionId,
                                                             String cursor,
                                                             Integer limit)
                                                      throws ApiException,
                                                             IOException

Lists all events for a specific subscription.

Specified by:

listSubscriptionEvents in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to retrieve the events for.

cursor - Optional parameter: When the total number of resulting subscription events exceeds the limit of a paged response, specify the cursor returned from a preceding response here to fetch the next set of results. If the cursor is unset, the response contains the last page of the results. For more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).

limit - Optional parameter: The upper limit on the number of subscription events to return in a paged response.

Returns:

Returns the ListSubscriptionEventsResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

listSubscriptionEventsAsync

public CompletableFuture<ListSubscriptionEventsResponse> listSubscriptionEventsAsync(String subscriptionId,
                                                                                     String cursor,
                                                                                     Integer limit)

Lists all events for a specific subscription.

Specified by:

listSubscriptionEventsAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to retrieve the events for.

cursor - Optional parameter: When the total number of resulting subscription events exceeds the limit of a paged response, specify the cursor returned from a preceding response here to fetch the next set of results. If the cursor is unset, the response contains the last page of the results. For more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).

limit - Optional parameter: The upper limit on the number of subscription events to return in a paged response.

Returns:

Returns the ListSubscriptionEventsResponse response from the API call

pauseSubscription

public PauseSubscriptionResponse pauseSubscription(String subscriptionId,
                                                   PauseSubscriptionRequest body)
                                            throws ApiException,
                                                   IOException

Schedules a `PAUSE` action to pause an active subscription.

Specified by:

pauseSubscription in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to pause.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the PauseSubscriptionResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

pauseSubscriptionAsync

public CompletableFuture<PauseSubscriptionResponse> pauseSubscriptionAsync(String subscriptionId,
                                                                           PauseSubscriptionRequest body)

Schedules a `PAUSE` action to pause an active subscription.

Specified by:

pauseSubscriptionAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to pause.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the PauseSubscriptionResponse response from the API call

resumeSubscription

public ResumeSubscriptionResponse resumeSubscription(String subscriptionId,
                                                     ResumeSubscriptionRequest body)
                                              throws ApiException,
                                                     IOException

Schedules a `RESUME` action to resume a paused or a deactivated subscription.

Specified by:

resumeSubscription in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to resume.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the ResumeSubscriptionResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

resumeSubscriptionAsync

public CompletableFuture<ResumeSubscriptionResponse> resumeSubscriptionAsync(String subscriptionId,
                                                                             ResumeSubscriptionRequest body)

Schedules a `RESUME` action to resume a paused or a deactivated subscription.

Specified by:

resumeSubscriptionAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to resume.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the ResumeSubscriptionResponse response from the API call

swapPlan

public SwapPlanResponse swapPlan(String subscriptionId,
                                 SwapPlanRequest body)
                          throws ApiException,
                                 IOException

Schedules a `SWAP_PLAN` action to swap a subscription plan in an existing subscription.

Specified by:

swapPlan in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to swap the subscription plan for.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the SwapPlanResponse response from the API call

Throws:

ApiException - Represents error response from the server.

IOException - Signals that an I/O exception of some sort has occurred.

swapPlanAsync

public CompletableFuture<SwapPlanResponse> swapPlanAsync(String subscriptionId,
                                                         SwapPlanRequest body)

Schedules a `SWAP_PLAN` action to swap a subscription plan in an existing subscription.

Specified by:

swapPlanAsync in interface SubscriptionsApi

Parameters:

subscriptionId - Required parameter: The ID of the subscription to swap the subscription plan for.

body - Required parameter: An object containing the fields to POST for the request. See the corresponding object definition for field details.

Returns:

Returns the SwapPlanResponse response from the API call