square-connect-openapi-agent/skills/payments/SKILL.md

name, description

name	description
payments-routes	Handle 7 OpenAPI operation(s) under /v2/payments for the payments route group.

payments API Routes

Handle 7 OpenAPI operation(s) under /v2/payments for the payments route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

list_payments

• Operation ID: list_payments
• Route: GET /v2/payments
• Mode: READ
• Summary: ListPayments
• Parameters:
  • begin_time in query
  • end_time in query
  • sort_order in query
  • cursor in query
  • location_id in query
  • total in query
  • last_4 in query
  • card_brand in query
  • limit in query
  • is_offline_payment in query
  • offline_begin_time in query
  • offline_end_time in query
  • updated_at_begin_time in query
  • updated_at_end_time in query
  • sort_field in query

create_payment

• Operation ID: create_payment
• Route: POST /v2/payments
• Mode: WRITE
• Summary: CreatePayment
• Body: JSON request body accepted.

cancel_payment_by_idempotency_key

• Operation ID: cancel_payment_by_idempotency_key
• Route: POST /v2/payments/cancel
• Mode: WRITE
• Summary: CancelPaymentByIdempotencyKey
• Body: JSON request body accepted.

get_payment

• Operation ID: get_payment
• Route: GET /v2/payments/{payment_id}
• Mode: READ
• Summary: GetPayment
• Parameters:
  • payment_id in path required

update_payment

• Operation ID: update_payment
• Route: PUT /v2/payments/{payment_id}
• Mode: WRITE
• Summary: UpdatePayment
• Parameters:
  • payment_id in path required
• Body: JSON request body accepted.

cancel_payment

• Operation ID: cancel_payment
• Route: POST /v2/payments/{payment_id}/cancel
• Mode: WRITE
• Summary: CancelPayment
• Parameters:
  • payment_id in path required

complete_payment

• Operation ID: complete_payment
• Route: POST /v2/payments/{payment_id}/complete
• Mode: WRITE
• Summary: CompletePayment
• Parameters:
  • payment_id in path required
• Body: JSON request body accepted.