• Partnerships
  • Sign In
  • Sign In
Docs Home
Dev Essentials
PaymentsCommerceCustomersStaffMerchants
Publish
Release notes

Docs

Docs Home
Dev Essentials
Payments
Commerce
Customers
Staff
Merchants
Publish
Release notes
Get Started
Create an Account and App
Make your First API Call
View the API Logs
Verify the Payment
What's Next
Overview
Build Basics
Versioning
Access Tokens
Frontend and Backend Development
General Development Concepts
TLS and HTTPS
Using the REST API
Handling Errors
Collecting Information
Language Preferences
Common Data Types
Working with Dates
Working with Monetary Amounts
Working with Addresses
Common Square API Patterns
Custom Attributes
Idempotency
Pagination
Optimistic Concurrency
Clear Object Fields
Square eCommerce APIs
Square API Lifecycle
Developer Tools
Developer Console
Square Dashboard
Sandbox
Test in Sandbox
Sandbox Payments
API Explorer
API Logs
Webhook Event Logs
Webhooks
Create a Notification URL
Subscribe to Event Notifications
Verify and Validate an Event Notification
Manage Operations
Move Event Notifications to Production
Webhook Events Reference
Troubleshooting
Build a Developer Team
Authentication
Postman
MCP Server
Square SDKs
Java
Quickstart
Common API Patterns
Migration Guide
.NET
Quickstart
Common API Patterns
Migration Guide
Node.js
Quickstart
Common API Patterns
Migration Guide
PHP
Quickstart
Common API Patterns
Migration Guide
Python
Quickstart
Common API Patterns
Migration Guide
Ruby
Quickstart
Project Setup
Using the SDK
Common API Patterns
Go
Quickstart
Sample Applications
GraphQL
GraphQL Basics
Build your First Query
GraphQL Explorer
Query Examples
OAuth
Create Redirect URL and Authorization Page URL
Receive Authorization and Manage OAuth Tokens
Refresh and Revoke OAuth Tokens
Token Introspection
OAuth Best Practices
OAuth Walkthrough
Migrate to the Square API OAuth Flow
Move OAuth to Production
Permissions Reference
Webhook Subscriptions
Events
Migrate from Deprecated APIs
Deprecated Items
API Migration Guides
v1 Payments API
v1 Refunds API
Square Transactions API
Migrate Employees to Team Members
Migrate from CreateCheckout to CreatePaymentLink
International Development
Develop for Japan
Compliance with Japan's Tax Invoice System

/

Dev Essentials

/

Build Basics

Common Data Types

The following data types are common across Square APIs:

  • Working with Dates
  • Working with Monetary Amounts
  • Working with Addresses

If you need more assistance, contact Developer and App Marketplace Support or ask for help in the Developer Forums.

Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Contact support
  • Developer blog
  • Discord community
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2025 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy