com.squareup.square.api

Class DefaultCheckoutApi

java.lang.Object

com.squareup.square.api.BaseApi

com.squareup.square.api.DefaultCheckoutApi

All Implemented Interfaces:

CheckoutApi

public final class DefaultCheckoutApi
extends BaseApi
implements CheckoutApi

This class lists all the endpoints of the groups.

Field Summary

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

AUTHENTICATION_KEY, GLOBAL_ERROR_CASES

Constructor Summary

Constructors

Constructor and Description
DefaultCheckoutApi(io.apimatic.core.GlobalConfiguration globalConfig) Initializes the controller.

Method Summary

Modifier and Type	Method and Description
CreateCheckoutResponse	createCheckout(String locationId, CreateCheckoutRequest body) Deprecated.
CompletableFuture<CreateCheckoutResponse>	createCheckoutAsync(String locationId, CreateCheckoutRequest body) Deprecated.
CreatePaymentLinkResponse	createPaymentLink(CreatePaymentLinkRequest body) Creates a Square-hosted checkout page.
CompletableFuture<CreatePaymentLinkResponse>	createPaymentLinkAsync(CreatePaymentLinkRequest body) Creates a Square-hosted checkout page.
DeletePaymentLinkResponse	deletePaymentLink(String id) Deletes a payment link.
CompletableFuture<DeletePaymentLinkResponse>	deletePaymentLinkAsync(String id) Deletes a payment link.
ListPaymentLinksResponse	listPaymentLinks(String cursor, Integer limit) Lists all payment links.
CompletableFuture<ListPaymentLinksResponse>	listPaymentLinksAsync(String cursor, Integer limit) Lists all payment links.
RetrieveLocationSettingsResponse	retrieveLocationSettings(String locationId) Retrieves the location-level settings for a Square-hosted checkout page.
CompletableFuture<RetrieveLocationSettingsResponse>	retrieveLocationSettingsAsync(String locationId) Retrieves the location-level settings for a Square-hosted checkout page.
RetrieveMerchantSettingsResponse	retrieveMerchantSettings() Retrieves the merchant-level settings for a Square-hosted checkout page.
CompletableFuture<RetrieveMerchantSettingsResponse>	retrieveMerchantSettingsAsync() Retrieves the merchant-level settings for a Square-hosted checkout page.
RetrievePaymentLinkResponse	retrievePaymentLink(String id) Retrieves a payment link.
CompletableFuture<RetrievePaymentLinkResponse>	retrievePaymentLinkAsync(String id) Retrieves a payment link.
UpdateLocationSettingsResponse	updateLocationSettings(String locationId, UpdateLocationSettingsRequest body) Updates the location-level settings for a Square-hosted checkout page.
CompletableFuture<UpdateLocationSettingsResponse>	updateLocationSettingsAsync(String locationId, UpdateLocationSettingsRequest body) Updates the location-level settings for a Square-hosted checkout page.
UpdateMerchantSettingsResponse	updateMerchantSettings(UpdateMerchantSettingsRequest body) Updates the merchant-level settings for a Square-hosted checkout page.
CompletableFuture<UpdateMerchantSettingsResponse>	updateMerchantSettingsAsync(UpdateMerchantSettingsRequest body) Updates the merchant-level settings for a Square-hosted checkout page.
UpdatePaymentLinkResponse	updatePaymentLink(String id, UpdatePaymentLinkRequest body) Updates a payment link.
CompletableFuture<UpdatePaymentLinkResponse>	updatePaymentLinkAsync(String id, UpdatePaymentLinkRequest body) Updates a payment link.

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

getClientInstance, getGlobalConfiguration, getHttpCallback

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultCheckoutApi

public DefaultCheckoutApi(io.apimatic.core.GlobalConfiguration globalConfig)

Initializes the controller.

Parameters:

globalConfig - Configurations added in client.

Method Detail

createCheckout

@Deprecated
public CreateCheckoutResponse createCheckout(String locationId,
                                                         CreateCheckoutRequest body)
                                                  throws ApiException,
                                                         IOException

Deprecated.

Links a `checkoutId` to a `checkout_page_url` that customers are directed to in order to provide their payment information using a payment processing workflow hosted on connect.squareup.com. NOTE: The Checkout API has been updated with new features. For more information, see [Checkout API highlights](https://developer.squareup.com/docs/checkout-api#checkout-api-highlights).

Specified by:

createCheckout in interface CheckoutApi

Parameters:

locationId - Required parameter: The ID of the business location to associate the checkout with.

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

Returns:

Returns the CreateCheckoutResponse 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.

createCheckoutAsync

@Deprecated
public CompletableFuture<CreateCheckoutResponse> createCheckoutAsync(String locationId,
                                                                                 CreateCheckoutRequest body)

Deprecated.

Links a `checkoutId` to a `checkout_page_url` that customers are directed to in order to provide their payment information using a payment processing workflow hosted on connect.squareup.com. NOTE: The Checkout API has been updated with new features. For more information, see [Checkout API highlights](https://developer.squareup.com/docs/checkout-api#checkout-api-highlights).

Specified by:

createCheckoutAsync in interface CheckoutApi

Parameters:

locationId - Required parameter: The ID of the business location to associate the checkout with.

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

Returns:

Returns the CreateCheckoutResponse response from the API call

retrieveLocationSettings

public RetrieveLocationSettingsResponse retrieveLocationSettings(String locationId)
                                                          throws ApiException,
                                                                 IOException

Retrieves the location-level settings for a Square-hosted checkout page.

Specified by:

retrieveLocationSettings in interface CheckoutApi

Parameters:

locationId - Required parameter: The ID of the location for which to retrieve settings.

Returns:

Returns the RetrieveLocationSettingsResponse 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.

retrieveLocationSettingsAsync

public CompletableFuture<RetrieveLocationSettingsResponse> retrieveLocationSettingsAsync(String locationId)

Retrieves the location-level settings for a Square-hosted checkout page.

Specified by:

retrieveLocationSettingsAsync in interface CheckoutApi

Parameters:

locationId - Required parameter: The ID of the location for which to retrieve settings.

Returns:

Returns the RetrieveLocationSettingsResponse response from the API call

updateLocationSettings

public UpdateLocationSettingsResponse updateLocationSettings(String locationId,
                                                             UpdateLocationSettingsRequest body)
                                                      throws ApiException,
                                                             IOException

Updates the location-level settings for a Square-hosted checkout page.

Specified by:

updateLocationSettings in interface CheckoutApi

Parameters:

locationId - Required parameter: The ID of the location for which to retrieve settings.

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

Returns:

Returns the UpdateLocationSettingsResponse 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.

updateLocationSettingsAsync

public CompletableFuture<UpdateLocationSettingsResponse> updateLocationSettingsAsync(String locationId,
                                                                                     UpdateLocationSettingsRequest body)

Updates the location-level settings for a Square-hosted checkout page.

Specified by:

updateLocationSettingsAsync in interface CheckoutApi

Parameters:

locationId - Required parameter: The ID of the location for which to retrieve settings.

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

Returns:

Returns the UpdateLocationSettingsResponse response from the API call

retrieveMerchantSettings

public RetrieveMerchantSettingsResponse retrieveMerchantSettings()
                                                          throws ApiException,
                                                                 IOException

Retrieves the merchant-level settings for a Square-hosted checkout page.

Specified by:

retrieveMerchantSettings in interface CheckoutApi

Returns:

Returns the RetrieveMerchantSettingsResponse 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.

retrieveMerchantSettingsAsync

public CompletableFuture<RetrieveMerchantSettingsResponse> retrieveMerchantSettingsAsync()

Retrieves the merchant-level settings for a Square-hosted checkout page.

Specified by:

retrieveMerchantSettingsAsync in interface CheckoutApi

Returns:

Returns the RetrieveMerchantSettingsResponse response from the API call

updateMerchantSettings

public UpdateMerchantSettingsResponse updateMerchantSettings(UpdateMerchantSettingsRequest body)
                                                      throws ApiException,
                                                             IOException

Updates the merchant-level settings for a Square-hosted checkout page.

Specified by:

updateMerchantSettings in interface CheckoutApi

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 UpdateMerchantSettingsResponse 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.

updateMerchantSettingsAsync

public CompletableFuture<UpdateMerchantSettingsResponse> updateMerchantSettingsAsync(UpdateMerchantSettingsRequest body)

Updates the merchant-level settings for a Square-hosted checkout page.

Specified by:

updateMerchantSettingsAsync in interface CheckoutApi

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 UpdateMerchantSettingsResponse response from the API call

listPaymentLinks

public ListPaymentLinksResponse listPaymentLinks(String cursor,
                                                 Integer limit)
                                          throws ApiException,
                                                 IOException

Lists all payment links.

Specified by:

listPaymentLinks in interface CheckoutApi

Parameters:

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query. If a cursor is not provided, the endpoint returns the first page of the results. For more information, see [Pagination](https://developer.squareup.com/docs/basics/api101/pagination).

limit - Optional parameter: A limit on the number of results to return per page. The limit is advisory and the implementation might return more or less results. If the supplied limit is negative, zero, or greater than the maximum limit of 1000, it is ignored. Default value: `100`

Returns:

Returns the ListPaymentLinksResponse 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.

listPaymentLinksAsync

public CompletableFuture<ListPaymentLinksResponse> listPaymentLinksAsync(String cursor,
                                                                         Integer limit)

Lists all payment links.

Specified by:

listPaymentLinksAsync in interface CheckoutApi

Parameters:

cursor - Optional parameter: A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query. If a cursor is not provided, the endpoint returns the first page of the results. For more information, see [Pagination](https://developer.squareup.com/docs/basics/api101/pagination).

limit - Optional parameter: A limit on the number of results to return per page. The limit is advisory and the implementation might return more or less results. If the supplied limit is negative, zero, or greater than the maximum limit of 1000, it is ignored. Default value: `100`

Returns:

Returns the ListPaymentLinksResponse response from the API call

createPaymentLink

public CreatePaymentLinkResponse createPaymentLink(CreatePaymentLinkRequest body)
                                            throws ApiException,
                                                   IOException

Creates a Square-hosted checkout page. Applications can share the resulting payment link with their buyer to pay for goods and services.

Specified by:

createPaymentLink in interface CheckoutApi

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 CreatePaymentLinkResponse 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.

createPaymentLinkAsync

public CompletableFuture<CreatePaymentLinkResponse> createPaymentLinkAsync(CreatePaymentLinkRequest body)

Creates a Square-hosted checkout page. Applications can share the resulting payment link with their buyer to pay for goods and services.

Specified by:

createPaymentLinkAsync in interface CheckoutApi

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 CreatePaymentLinkResponse response from the API call

deletePaymentLink

public DeletePaymentLinkResponse deletePaymentLink(String id)
                                            throws ApiException,
                                                   IOException

Deletes a payment link.

Specified by:

deletePaymentLink in interface CheckoutApi

Parameters:

id - Required parameter: The ID of the payment link to delete.

Returns:

Returns the DeletePaymentLinkResponse 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.

deletePaymentLinkAsync

public CompletableFuture<DeletePaymentLinkResponse> deletePaymentLinkAsync(String id)

Deletes a payment link.

Specified by:

deletePaymentLinkAsync in interface CheckoutApi

Parameters:

id - Required parameter: The ID of the payment link to delete.

Returns:

Returns the DeletePaymentLinkResponse response from the API call

retrievePaymentLink

public RetrievePaymentLinkResponse retrievePaymentLink(String id)
                                                throws ApiException,
                                                       IOException

Retrieves a payment link.

Specified by:

retrievePaymentLink in interface CheckoutApi

Parameters:

id - Required parameter: The ID of link to retrieve.

Returns:

Returns the RetrievePaymentLinkResponse 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.

retrievePaymentLinkAsync

public CompletableFuture<RetrievePaymentLinkResponse> retrievePaymentLinkAsync(String id)

Retrieves a payment link.

Specified by:

retrievePaymentLinkAsync in interface CheckoutApi

Parameters:

id - Required parameter: The ID of link to retrieve.

Returns:

Returns the RetrievePaymentLinkResponse response from the API call

updatePaymentLink

public UpdatePaymentLinkResponse updatePaymentLink(String id,
                                                   UpdatePaymentLinkRequest body)
                                            throws ApiException,
                                                   IOException

Updates a payment link. You can update the `payment_link` fields such as `description`, `checkout_options`, and `pre_populated_data`. You cannot update other fields such as the `order_id`, `version`, `URL`, or `timestamp` field.

Specified by:

updatePaymentLink in interface CheckoutApi

Parameters:

id - Required parameter: The ID of the payment link 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 UpdatePaymentLinkResponse 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.

updatePaymentLinkAsync

public CompletableFuture<UpdatePaymentLinkResponse> updatePaymentLinkAsync(String id,
                                                                           UpdatePaymentLinkRequest body)

Updates a payment link. You can update the `payment_link` fields such as `description`, `checkout_options`, and `pre_populated_data`. You cannot update other fields such as the `order_id`, `version`, `URL`, or `timestamp` field.

Specified by:

updatePaymentLinkAsync in interface CheckoutApi

Parameters:

id - Required parameter: The ID of the payment link 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 UpdatePaymentLinkResponse response from the API call