Download the PHP package mage2pro/square-php-sdk without Composer

Connect v2 PHP SDK

This repository contains a generated PHP client SDK for the Square Connect APIs v2. Check out our API specification repository for the specification and template files we used to generate this.

If you are looking for a sample e-commerce application using these APIs, check out the connect-api-examples repository.

To learn more about the Square APIs in general, head on over to the Square API documentation

Requirements

• PHP >= 5.4.0
• A Square account and developer application (for authorization)

Installing

With Composer

The PHP SDK is available on Packagist. To add it to Composer, simply run:

Or add this line under "require" to your composer.json:

And then install your composer dependencies with

From GitHub

Clone this repository, or download the zip into your project's folder and then add the following line in your code:

Note: you might have to change the path depending on your project's folder structure.

Usage

There are five main objects that you'll be using, depending on what you want to do, each one is explained in more detail below.

Locations

You'll need to list locations for your square account before doing most API calls because the location_id is a in the url for most endpoints.

List Locations

• $authorization : Your access token (sandbox, personal, or OAuth)

Response: \SquareConnect\Model\ListLocationsResponse

See all the functions you can use with the ->getLocations() response in the location model

Customers

Customers are end-users of a business and can be associated with transactions.

List Customers

• $authorization : Your access token (sandbox, personal, or OAuth)
• $cursor : This is an optional argument that specifies which page of customers to retrieve. Learn more about pagination here.

Response: \SquareConnect\Model\ListCustomersResponse

See all the functions you can use with the ->getCustomers() response in the customer model.

Create Customer

• $authorization : Your access token (sandbox, personal, or OAuth)
• $body : The body is a SquareConnect\Model\CreateCustomerRequest object that you'll have to build with the information of your customer.

Response: \SquareConnect\Model\CreateCustomersResponse

See all the functions you can use with the ->getCustomer() response in the customer model.

Retrieve Customer

• $authorization : Your access token (sandbox, personal, or OAuth)
• $customer_id : The id of the customer you want to retrieve. Use the ->getId() fuction on a customer object to the customer_id of a retrieved customer.

Response: \SquareConnect\Model\RetrieveCustomerResponse

See all the functions you can use with the ->getCustomer() response in the customer model. Update Customer

• $authorization : Your access token (sandbox, personal, or OAuth)
• $customer_id : The id of the customer you want to update. Use the ->getId() fuction on a customer object to the customer_id of a retrieved customer.
• $body : The body is a SquareConnect\Model\UpdateCustomerRequest object that you'll have to build with the information of your customer.

Response: \SquareConnect\Model\UpdateCustomerResponse

See all the functions you can use with the ->getCustomer() response in the customer model

Delete Customer

• $authorization : Your access token (sandbox, personal, or OAuth)
• $customer_id : The id of the customer you want to retrieve. Use the ->getId() fuction on a customer object to the customer_id of a retrieved customer.

Response: \SquareConnect\Model\DeleteCustomerResponse

Customers Cards

Customers Cards on file allow merchants to charge customers without them providing their credit card every time. Learn more here: Saving Customer Information

Create Customer Card

• $authorization : Your access token (sandbox, personal, or OAuth)
• $customer_id : The id of the customer you want to associate the card with.
• $body : The body is a SquareConnect\Model\CreateCustomerCardRequest object that you'll have to build with the information of your customer's card.

Response: \SquareConnect\Model\CreateCustomerCardResponse

See all the functions you can use with the ->getCard() response in the card model

Delete Customer Card

• $authorization : Your access token (sandbox, personal, or OAuth)
• $customer_id : The id of the customer whose card you want to delete.
• $card_id : The id of the card you want to delete.

Response: \SquareConnect\Model\DeleteCustomerCardResponse

Transactions

List Transactions

• $authorization : Your access token (sandbox, oauth or personal)
• $location_id : The id of the location you are requesting the transactions for.
• $begin_time : The beginning of the requested reporting period, in RFC 3339 format. (optional)
• $end_time The end of the requested reporting period, in RFC 3339 format. (optional)
• $sort_order The order in which results are listed in the response (ASC for chronological, DESC for reverse-chronological). (optional)
• $cursor : An optional pagination cursor to retrieve the next set of results for your original query to the endpoint. Learn more about pagination here.

Response: \SquareConnect\Model\ListTransactionsResponse

See all the functions you can use with the ->getTransactions() response in the transaction model

Charge (Create Transaction)

• $authorization : Your access token (sandbox, personal, or OAuth)
• $location_id : The id of the location you are creating the transactions for.
• $body : The body is a SquareConnect\Model\ChargeRequest object that you'll have to build with the information of your transaction.

Response: \SquareConnect\Model\ChargeResponse

See all the functions you can use with the ->getTransactions() response in the transaction model

Retrieve Transaction

• $authorization : Your access token (sandbox, personal, or OAuth)
• $location_id : The id of the location you are retrieving the transaction for.
• $transaction_id : The id of the transaction you want to retrieve. Use the ->getId() fuction on a transaction object to get the transaction_id

Response: \SquareConnect\Model\RetrieveTransactionResponse

See all the functions you can use with the ->getTransactions() response in the transaction model

Capture Transaction Charges a card that was previously authorized. See delayed capture transactions for more information.

• $authorization : Your access token (sandbox, personal, or OAuth)
• $location_id : The id of the location you are retrieving the transaction for.
• $transaction_id : The id of the previously authorized transaction you want to capture.

Response: \SquareConnect\Model\CaptureTransactionResponse

Void Transaction Voids a previous card authorization. See delayed capture transactions for more information.

• $authorization : Your access token (sandbox, personal, or OAuth)
• $location_id : The id of the location you are retrieving the transaction for.
• $transaction_id : The id of the previously authorized transaction you want to void.

Response: \SquareConnect\Model\VoidTransactionResponse

Refunds

List Refunds

• $authorization : Your access token (sandbox, oauth or personal)
• $location_id : The id of the location you are requesting the refunds for.
• $begin_time : The beginning of the requested reporting period, in RFC 3339 format. (optional)
• $end_time The end of the requested reporting period, in RFC 3339 format. (optional)
• $sort_order The order in which results are listed in the response (ASC for chronological, DESC for reverse-chronological). (optional)
• $cursor : An optional pagination cursor to retrieve the next set of results for your original query to the endpoint. Learn more about pagination here.

Response: \SquareConnect\Model\ListRefundsResponse

Create Refund

• $authorization : Your access token (sandbox, oauth or personal)
• $location_id : The id of the location you are requesting the refunds for.
• $transaction_id : The id of the previously charged transaction you want to refund.
• $body : The body is a SquareConnect\Model\CreateRefundRequest object that you'll have to build with the information of your refund.

Response: \SquareConnect\Model\CreateRefundResponse

Contributing

Send bug reports, feature requests, and code contributions to the API specifications repository, as this repository contains only the generated SDK code. If you notice something wrong about this SDK in particular, feel free to raise an issue here.

License