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
Versioning
Access Tokens
Frontend and Backend Development
TLS and HTTPS
Using the REST API
Handling Errors
Collecting Information
Language Preferences
Working with Dates
Working with Monetary Amounts
Working with Addresses
Custom Attributes
Idempotency
Pagination
Optimistic Concurrency
Clear Object Fields
Square eCommerce APIs
Square API Lifecycle
Developer Console
Square Dashboard
Test in Sandbox
Sandbox Payments
Sandbox Seeding Data
API Explorer
API Logs
Webhook Event Logs
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
Quickstart
Project Setup
Using the SDK
Common API Patterns
Quickstart
Project Setup
Using the SDK
Common API Patterns
Quickstart
Common API Patterns
Migration Guide
Quickstart
Common API Patterns
Migration Guide
Quickstart
Project Setup
Using the SDK
Common API Patterns
Quickstart
Project Setup
Using the SDK
Common API Patterns
Quickstart
Sample Applications
GraphQL Basics
Build your First Query
GraphQL Explorer
Query Examples
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
Deprecated Items
v1 Payments API
v1 Refunds API
Square Transactions API
Migrate Employees to Team Members
Migrate from CreateCheckout to CreatePaymentLink
OAuth and Testing
International Payments
Regional Differences for International Development
Compliance with Japan's Tax Invoice System

/

Dev Essentials

/

Get Started

Make your First API Call

After you create an account and application, you can use API Explorer to call Square APIs. This exercise creates a payment in the Square Sandbox.

Link to section

Create a payment

In the Developer Console, your application displays the following blue banner:

An image of the "create your first test payment" banner.

  1. Choose the Open API Explorer link on the banner. This opens API Explorer and populates all the fields that are required to send a CreatePayment request to the Payments API.

    Note

    Don't see the banner? Use this API Explorer link to open the prepopulated view.

  2. In API Explorer, choose Run Request.

  3. Review the Request and Response panes:

    • The Request pane shows the request that was sent. You can change the default cURL view to see the request in another programming language.
    • The Response pane shows the response from Square. If the payment is successful, Square returns a Payment object with the status field set to COMPLETED. If the request failed, Square returns an error.

An image of API Explorer populated with CreatePayment values.

The source_id in the request is a Sandbox payment token that represents a credit card. In production, payment tokens are generated by the Web Payments SDK or In-App Payments SDK. For more information, see Take Payments.

Did you know?

For this Get Started exercise, API Explorer prefilled the Access token field for you. When you're using API Explorer in the future, choose the Change button and select your application. When selected, the Access token field is filled with your application token.