Square Integration for Xano

Process payments and manage customers using the Square platform. Charge cards and maintain a customer directory directly from your Xano workflows.

Functions

Function	Description
square_create_payment	Processes a payment through Square.
square_create_customer	Creates a new customer in the Square directory.

Install

Option A — Ask Claude Code

With the Xano MCP enabled in Claude Code, paste this into Claude:

Install the integration at https://github.com/xano-community/integration-square-payments into my Xano workspace.

Claude will clone the repo and push the functions to your workspace.

Option B — Use the Xano CLI

1. Install and authenticate the Xano CLI:

   npm install -g @xano/cli
   xano auth

2. Clone and push this integration:

   git clone https://github.com/xano-community/integration-square-payments.git
   cd integration-square-payments
   xano workspace:push . -w <your-workspace-id>

   Replace <your-workspace-id> with the ID from xano workspace:list.

Configure Credentials

1. Sign up or log in at https://developer.squareup.com.
2. Create a new application in the Square Developer Dashboard.
3. Navigate to Credentials and copy your Access Token (use Sandbox for testing or Production for live transactions).
4. In your Xano workspace, go to Settings > Environment Variables and add SQUARE_ACCESS_TOKEN with the token value.

Environment variables used by this integration:

• SQUARE_ACCESS_TOKEN

See .env.example for a template.

Usage

Call any function from another function, task, or API endpoint using function.run:

function.run "square_create_payment" {
  input = {
    // See function signature for required parameters
  }
} as $result

Function Reference

square_create_payment

Charges a payment source (card nonce, customer card on file, or ACH token) for a specified amount and currency. Requires a unique idempotency key to prevent duplicate charges. Returns the payment object with status, receipt URL, and transaction details.

square_create_customer

Adds a customer record to your Square customer directory with details such as name, email, and phone number. Use this to store buyer profiles for repeat purchases, loyalty programs, or linking cards on file for future payments.

License

MIT — see LICENSE.