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

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

All versions ->

Copy link to request setupRun requestRun
POST/v2/payments

Create payment

Creates a payment using the provided source. API Reference ->

Sign in
SandboxProduction

Access Tokens

Sign in to populate your access tokens from the developer dashboard Sign in

Link to section

Body

idempotency_key

string

Required

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

Generate

source_id

string

Required

Test a card paymentTest a card on file paymentTest a gift card paymentTest a cash paymentTest an external paymentTest a card payment that fails due to CVV validationTest a card payment that fails due to postal code validationTest a card payment that fails due to expiration date validationTest a card payment that fails due to a generic declineTest a card payment that fails due to re-using a tokenTest a gift card payment that fails due to insufficient fundsTest a gift card payment that fails due to insufficient permissionsTest a bank paymentTest a bank payment that fails due to a generic declineTest a bank payment that fails due to an unusable accountTest a bank payment that fails due to insufficient fundsTest a bank payment that fails due to an invalid accountTest a bank payment that fails due to buyer refusing payment

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

accept_partial_authorization

boolean

amount_money

app_fee_allocations

[ ]

app_fee_money

autocomplete

boolean

billing_address

buyer_email_address

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

buyer_phone_number

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

cash_details

customer_details

customer_id

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

delay_action

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

delay_duration

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

Generate

external_details

location_id

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

note

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

order_id

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

reference_id

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

shipping_address

statement_description_identifier

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

team_member_id

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

tip_money

verification_token

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

POST /v2/payments

Response

// No response received yet.