> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amlok.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Square

> Processor/POS - access route, data references, and integration requirements.

> [!NOTE]
>
> **Active (Beta).** This integration is available in beta. Coverage depends on market, product, and account permissions. [View integration status](https://docs.amlok.io/integrations/status.md).

| Property | Definition |
| - | - |
| Provider ID | PAY-03 |
| Integration status | Active (Beta) |
| Category | Payments and POS |
| Product type | Processor/POS |
| Evidence reviewed | 2026-10-22 |

## Integration approach

OAuth + Orders, Payments, Refunds, and Payouts APIs; validate Canadian endpoint coverage.

## Access and approval

Self-serve API can launch with seller consent without formal partnership; Marketplace listing ETA ND. Review source.

**Documentation availability:** Public API/docs.

*ND means the source catalog does not disclose an approval estimate.*

## Data refresh

**Provider update cadence:** Event notifications typically within 60 seconds.

Square typically sends webhook notifications within 60 seconds of a supported event. Authorized API reads can retrieve the associated payment, order, inventory, or other supported resource.

This is Square's typical notification timing, not an AMLOK end-to-end delivery guarantee. Failed deliveries may be retried for up to 24 hours; event subscriptions require the relevant permissions.

**AMLOK synchronization:** The enabled refresh mode and schedule are agreed for your connection. Provider timing describes upstream capability; allow for retrieval and processing before changes appear in AMLOK. See [data refresh and freshness](https://docs.amlok.io/integrations/data-refresh.md).

Provider references: [Square webhook troubleshooting](https://developer.squareup.com/docs/webhooks/troubleshooting), [Square webhook events](https://developer.squareup.com/reference/square/webhooks).

## Data reference

Open a resource to review its field definitions. Available fields depend on the connected product, account permissions, and source data.

| Resource |
| - |
| [merchant\_account](https://docs.amlok.io/data-model/field-dictionary.md#merchant-account) |
| [order](https://docs.amlok.io/data-model/field-dictionary.md#order) |
| [order\_line](https://docs.amlok.io/data-model/field-dictionary.md#order-line) |
| [payment](https://docs.amlok.io/data-model/field-dictionary.md#payment) |
| [refund](https://docs.amlok.io/data-model/field-dictionary.md#refund) |
| [counterparty](https://docs.amlok.io/data-model/field-dictionary.md#counterparty) |
| [product](https://docs.amlok.io/data-model/field-dictionary.md#product) |
| [location](https://docs.amlok.io/data-model/field-dictionary.md#location) |

## Coverage conditions

| Property | Definition |
| - | - |
| Country / deployment conditions | Verify target country, product edition, tenant and deployment. |
| History | Available payment history retained in the seller account; no fixed maximum number of months is published for payment retrieval. [Provider reference](https://developer.squareup.com/reference/square/payments-api/list-payments). |
| Refresh | Event notifications typically within 60 seconds. [Details](#data-refresh). |
| Commercial / use rights | Client permission and applicable commercial use rights required. |

## Provider documentation

* [developer.squareup.com/docs/payouts-api/overview](https://developer.squareup.com/docs/payouts-api/overview)
* [developer.squareup.com/forums/t/marketplace-listing/26585](https://developer.squareup.com/forums/t/marketplace-listing/26585)

## Related model reference

* [Provider coverage](https://docs.amlok.io/data-model/provider-coverage.md#pay-03)
* [Resource coverage](https://docs.amlok.io/data-model/resource-coverage.md#pay-03)
* [Field dictionary](https://docs.amlok.io/data-model/field-dictionary.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.