Skip to content

square/square-php-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Square PHP SDK

Build PHP version Apache-2 license

Use this library to integrate Square payments into your app and grow your business with Square APIs including Catalog, Customers, Employees, Inventory, Labor, Locations, and Orders.

Requirements

Use of the Square PHP SDK requires:

  • PHP 7.4 through PHP ^8.0

Installation

For more information, see Set Up Your Square SDK for a PHP Project.

Quickstart

For more information, see Square PHP SDK Quickstart.

Usage

For more information, see Using the Square PHP SDK.

Tests

First, clone the repo locally and cd into the directory.

git clone https://github.com/square/square-php-sdk.git
cd square-php-sdk

Next, make sure you've downloaded Composer, following the instructions here and then run the following command from the root of the repository:

composer install

Before running the tests, find a sandbox token in your Developer Dashboard and set environment variables:

export SQUARE_ACCESS_TOKEN=mytoken
export SQUARE_ENVIRONMENT=sandbox

Run the tests:

composer run test

All environment variables:

  • SQUARE_TIMEOUT - number
  • SQUARE_NUMBER_OF_RETRIES - number
  • SQUARE_MAXIMUM_RETRY_WAIT_TIME - number
  • SQUARE_SQUARE_VERSION - string
  • SQUARE_USER_AGENT_DETAIL - string
  • SQUARE_CUSTOM_URL - string
  • SQUARE_ACCESS_TOKEN - string
  • SQUARE_ENVIRONMENT - string - one of production, sandbox, custom

SDK Reference

Payments

Terminal

Orders

Subscriptions

Invoices

Items

Customers

Loyalty

Gift Cards

Bookings

Business

Team

Financials

Online

Authorization

Webhook Subscriptions

Deprecated APIs

The following Square APIs are deprecated: