Payments

Square — data contract (compatible with Square’s documented schema; not affiliated with Square)

Name: Square data contract
Creator: DataContractGate
License: https://opensource.org/licenses/MIT

Square Payment object — core fields from the Payments API. Compatible with Square's documented Payment object; not affiliated with Square.

Validate a client's Square export at ingest into your warehouse, or with POST /egress before sending the same shape to a partner, reverse ETL, or an AI agent.

Download YAML

Also available: ODCS v3.1.0 YAML. “Use this contract” forks it into your org, then opens the validation playground so you can upload the client file.

Fields

Name	Type	Required	Rule	Description
id	string	required	—	—
status	string	optional	one of: APPROVED, PENDING, COMPLETED, CANCELED, FAILED	Status of the payment.
amount_money	object	required	—	The amount of money processed for the payment.
source_type	string	optional	one of: CARD, BANK_ACCOUNT, WALLET, BUY_NOW_PAY_LATER, SQUARE_ACCOUNT, CASH, EXTERNAL	The source type for the payment.
location_id	string	optional	—	—
order_id	string	optional	—	—
reference_id	string	optional	—	—
receipt_number	string	optional	—	—
created_at	timestamp	optional	—	—
updated_at	timestamp	optional	—	—

Sample rows

Three synthetic rows we wrote. They validate against this contract with zero violations. No real customer data.

[
  {
    "amount_money": {
      "amount": 4200,
      "currency": "USD"
    },
    "created_at": "2026-01-15T09:30:00Z",
    "id": "h4Yk3EXAMPLEPAY0000001",
    "location_id": "L8EXAMPLELOC1",
    "order_id": "aB3EXAMPLEORD0000001",
    "receipt_number": "ABCD",
    "reference_id": "client-ref-1001",
    "source_type": "CARD",
    "status": "COMPLETED",
    "updated_at": "2026-01-15T09:30:05Z"
  },
  {
    "amount_money": {
      "amount": 1599,
      "currency": "USD"
    },
    "created_at": "2026-01-16T14:05:00Z",
    "id": "p9Qm2EXAMPLEPAY0000002",
    "location_id": "L8EXAMPLELOC1",
    "source_type": "BUY_NOW_PAY_LATER",
    "status": "APPROVED"
  },
  {
    "amount_money": {
      "amount": 0,
      "currency": "CAD"
    },
    "created_at": "2026-01-17T11:45:00Z",
    "id": "n7Ls8EXAMPLEPAY0000003",
    "location_id": "L9EXAMPLELOC2",
    "source_type": "SQUARE_ACCOUNT",
    "status": "FAILED"
  }
]

Provenance

Verified against: https://developer.squareup.com/reference/square/objects/Payment
Checked: 2026-11-06
Version: v1.0
Author: DataContractGate
License: MIT

Spotted a mismatch with the vendor’s current schema? Report an issue.

Stripe, Shopify, QuickBooks, Xero, HubSpot, Salesforce, Google Analytics and Square are trademarks of their respective owners. DataContractGate is not affiliated with or endorsed by them. These contracts describe data shaped like these vendors’ documented schemas; they are not official and are not certified by any vendor.