M2Square

Authentication

API authentication, headers, idempotency, and request identifiers.

Headers

HeaderRequiredDescription
AuthorizationYesBearer token for the environment.
Content-TypeFor JSON bodiesUse application/json.
Idempotency-KeyFor retryable writesUnique key for safely retrying requests.

Bearer token

curl "$M2_BASE_URL/v1/balances" \
  -H "Authorization: Bearer $M2_API_KEY"

Idempotent write

curl "$M2_BASE_URL/v1/settlements" \
  -H "Authorization: Bearer $M2_API_KEY" \
  -H "Idempotency-Key: settlement-order-1001" \
  -H "Content-Type: application/json" \
  -d '{ "quote_id": "quo_01JEXAMPLE" }'

Request IDs

Every response includes a request identifier. Include it when contacting support or investigating Sentra timelines.

On this page