{ "info": { "_postman_id": "712eb3b5-6168-4ac3-9b97-dc5670f07770", "name": "Square ApplePay Transactions API", "description": "Supercharge Square for sellers of every size. Our entire connected commerce platform from elegant hardware to a rich suite of Square APIs is yours to build with. Whether youre developing an app or composing a bespoke solution, this is the place to make it happen. \n\nContact Support:\n Name: Square Developer Platform\n Email: developers@squareup.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "lastUpdatedBy": "35240", "uid": "35240-712eb3b5-6168-4ac3-9b97-dc5670f07770" }, "item": [ { "name": "v2", "item": [ { "name": "locations", "item": [ { "name": "{location_id}", "item": [ { "name": "transactions", "item": [ { "name": "{transaction_id}", "item": [ { "name": "capture", "item": [ { "name": "Square Capture Transaction", "id": "f86cfe64-3a9e-45ac-9c33-87d5d703b4c0", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions/:transaction_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions", ":transaction_id", "capture" ], "variable": [ { "id": "da625680-5630-4aa6-9c76-1d95082d1e31", "key": "location_id", "value": "", "description": "(Required) " }, { "id": "ad898b5c-f4ee-4f39-b89e-2df77b072fb9", "key": "transaction_id", "value": "", "description": "(Required) " } ] }, "description": "Captures a transaction that was created with the [Charge](api-endpoint:Transactions-Charge)\nendpoint with a `delay_capture` value of `true`.\n\n\nSee [Delayed capture transactions](https://developer.squareup.com/docs/payments/transactions/overview#delayed-capture)\nfor more information." }, "response": [ { "id": "f8ee138a-306a-4ec2-8fe6-ef81686e3ad1", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions/:transaction_id/capture", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions", ":transaction_id", "capture" ], "variable": [ { "key": "location_id" }, { "key": "transaction_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"AUTHENTICATION_ERROR\",\n \"code\": \"UNSUPPORTED_LOYALTY_REWARD_TIER\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"EXTERNAL_VENDOR_ERROR\",\n \"code\": \"ACCESS_TOKEN_EXPIRED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-f8ee138a-306a-4ec2-8fe6-ef81686e3ad1" } ], "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-f86cfe64-3a9e-45ac-9c33-87d5d703b4c0" } ], "id": "a2c5ead1-e2a0-49ff-bdb0-095e36779b13", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-a2c5ead1-e2a0-49ff-bdb0-095e36779b13" }, { "name": "void", "item": [ { "name": "Square Void Transaction", "id": "d6a5c64d-d226-4098-a178-b5c2130bd771", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions/:transaction_id/void", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions", ":transaction_id", "void" ], "variable": [ { "id": "18da2102-c012-4ba0-b6be-315c9d5fe551", "key": "location_id", "value": "", "description": "(Required) " }, { "id": "48fdfd06-fc18-47dc-9eee-df59f48ca531", "key": "transaction_id", "value": "", "description": "(Required) " } ] }, "description": "Cancels a transaction that was created with the [Charge](api-endpoint:Transactions-Charge)\nendpoint with a `delay_capture` value of `true`.\n\n\nSee [Delayed capture transactions](https://developer.squareup.com/docs/payments/transactions/overview#delayed-capture)\nfor more information." }, "response": [ { "id": "7d54ad5b-b015-4588-b380-c7778d7c089a", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions/:transaction_id/void", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions", ":transaction_id", "void" ], "variable": [ { "key": "location_id" }, { "key": "transaction_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"RATE_LIMIT_ERROR\",\n \"code\": \"INCORRECT_TYPE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"API_ERROR\",\n \"code\": \"INVALID_EXPIRATION_YEAR\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-7d54ad5b-b015-4588-b380-c7778d7c089a" } ], "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-d6a5c64d-d226-4098-a178-b5c2130bd771" } ], "id": "099b2611-6a91-4ef1-a14a-510beff8e9f6", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-099b2611-6a91-4ef1-a14a-510beff8e9f6" }, { "name": "Square Retrieve Transaction", "id": "04f69431-cd59-4760-8772-fcc41d6342f0", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions/:transaction_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions", ":transaction_id" ], "variable": [ { "id": "da1ffc06-503e-4b6a-9ff9-a115eb43b21c", "key": "location_id", "value": "", "description": "(Required) The ID of the transaction's associated location." }, { "id": "c544df26-2ce7-4fbc-ac88-03ae623117ca", "key": "transaction_id", "value": "", "description": "(Required) The ID of the transaction to retrieve." } ] }, "description": "Retrieves details for a single transaction." }, "response": [ { "id": "73fde88a-9d88-4f91-a455-bc625e150afa", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions/:transaction_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions", ":transaction_id" ], "variable": [ { "key": "location_id" }, { "key": "transaction_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"PAYMENT_METHOD_ERROR\",\n \"code\": \"PAYMENT_LIMIT_EXCEEDED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"transaction\": {\n \"id\": \"\",\n \"location_id\": \"\",\n \"created_at\": \"\",\n \"tenders\": [\n {\n \"type\": \"NO_SALE\",\n \"id\": \"\",\n \"location_id\": \"\",\n \"transaction_id\": \"\",\n \"created_at\": \"\",\n \"note\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"DJF\"\n },\n \"tip_money\": {\n \"amount\": \"\",\n \"currency\": \"UYU\"\n },\n \"processing_fee_money\": {\n \"amount\": \"\",\n \"currency\": \"LSL\"\n },\n \"customer_id\": \"\",\n \"card_details\": {\n \"status\": \"CAPTURED\",\n \"card\": {\n \"id\": \"\",\n \"card_brand\": \"OTHER_BRAND\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cardholder_name\": \"\",\n \"billing_address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"BQ\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n },\n \"fingerprint\": \"\",\n \"customer_id\": \"\",\n \"merchant_id\": \"\",\n \"reference_id\": \"\",\n \"enabled\": \"\",\n \"card_type\": \"UNKNOWN_CARD_TYPE\",\n \"prepaid_type\": \"NOT_PREPAID\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"UNKNOWN\"\n },\n \"entry_method\": \"SWIPED\"\n },\n \"cash_details\": {\n \"buyer_tendered_money\": {\n \"amount\": \"\",\n \"currency\": \"GBP\"\n },\n \"change_back_money\": {\n \"amount\": \"\",\n \"currency\": \"LSL\"\n }\n },\n \"bank_account_details\": {\n \"status\": \"PENDING\"\n },\n \"buy_now_pay_later_details\": {\n \"buy_now_pay_later_brand\": \"AFTERPAY\",\n \"status\": \"CAPTURED\"\n },\n \"square_account_details\": {\n \"status\": \"AUTHORIZED\"\n },\n \"additional_recipients\": [\n {\n \"location_id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"NAD\"\n },\n \"description\": \"\",\n \"receivable_id\": \"\"\n }\n ],\n \"payment_id\": \"\"\n }\n ],\n \"refunds\": [\n {\n \"id\": \"\",\n \"location_id\": \"\",\n \"tender_id\": \"\",\n \"reason\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"USN\"\n },\n \"status\": \"PENDING\",\n \"transaction_id\": \"\",\n \"created_at\": \"\",\n \"processing_fee_money\": {\n \"amount\": \"\",\n \"currency\": \"SLL\"\n },\n \"additional_recipients\": [\n {\n \"location_id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"SHP\"\n },\n \"description\": \"\",\n \"receivable_id\": \"\"\n }\n ]\n }\n ],\n \"reference_id\": \"\",\n \"product\": \"PAYROLL\",\n \"client_id\": \"\",\n \"shipping_address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"VN\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n },\n \"order_id\": \"\"\n }\n}", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-73fde88a-9d88-4f91-a455-bc625e150afa" } ], "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-04f69431-cd59-4760-8772-fcc41d6342f0" } ], "id": "c11baf1f-272c-4d33-84b8-a875ce09558c", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-c11baf1f-272c-4d33-84b8-a875ce09558c" }, { "name": "Square List Transactions", "id": "c644abd4-5b25-435a-b449-6e8f6ff99239", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions?begin_time=&end_time=&sort_order=DESC&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions" ], "query": [ { "description": "The beginning of the requested reporting period, in RFC 3339 format.\n\nSee [Date ranges](https://developer.squareup.com/docs/build-basics/working-with-dates) for details on date inclusivity/exclusivity.\n\nDefault value: The current time minus one year.", "key": "begin_time", "value": "" }, { "description": "The end of the requested reporting period, in RFC 3339 format.\n\nSee [Date ranges](https://developer.squareup.com/docs/build-basics/working-with-dates) for details on date inclusivity/exclusivity.\n\nDefault value: The current time.", "key": "end_time", "value": "" }, { "description": "The order in which results are listed in the response (`ASC` for\noldest first, `DESC` for newest first).\n\nDefault value: `DESC`", "key": "sort_order", "value": "DESC" }, { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Paginating results](https://developer.squareup.com/docs/working-with-apis/pagination) for more information.", "key": "cursor", "value": "" } ], "variable": [ { "id": "34a8db59-89ba-4ac8-9e17-795b340897bd", "key": "location_id", "value": "", "description": "(Required) The ID of the location to list transactions for." } ] }, "description": "Lists transactions for a particular location.\n\nTransactions include payment information from sales and exchanges and refund\ninformation from returns and exchanges.\n\nMax results per [page](https://developer.squareup.com/docs/working-with-apis/pagination): 50" }, "response": [ { "id": "641ed4c2-037f-434b-ac6d-ceea79adf78e", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/locations/:location_id/transactions?begin_time=&end_time=&sort_order=DESC&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "locations", ":location_id", "transactions" ], "query": [ { "description": "The beginning of the requested reporting period, in RFC 3339 format.\n\nSee [Date ranges](https://developer.squareup.com/docs/build-basics/working-with-dates) for details on date inclusivity/exclusivity.\n\nDefault value: The current time minus one year.", "key": "begin_time", "value": "" }, { "description": "The end of the requested reporting period, in RFC 3339 format.\n\nSee [Date ranges](https://developer.squareup.com/docs/build-basics/working-with-dates) for details on date inclusivity/exclusivity.\n\nDefault value: The current time.", "key": "end_time", "value": "" }, { "description": "The order in which results are listed in the response (`ASC` for\noldest first, `DESC` for newest first).\n\nDefault value: `DESC`", "key": "sort_order", "value": "DESC" }, { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for your original query.\n\nSee [Paginating results](https://developer.squareup.com/docs/working-with-apis/pagination) for more information.", "key": "cursor", "value": "" } ], "variable": [ { "key": "location_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"MAP_KEY_LENGTH_TOO_SHORT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"transactions\": [\n {\n \"id\": \"\",\n \"location_id\": \"\",\n \"created_at\": \"\",\n \"tenders\": [\n {\n \"type\": \"SQUARE_ACCOUNT\",\n \"id\": \"\",\n \"location_id\": \"\",\n \"transaction_id\": \"\",\n \"created_at\": \"\",\n \"note\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"ZMK\"\n },\n \"tip_money\": {\n \"amount\": \"\",\n \"currency\": \"ERN\"\n },\n \"processing_fee_money\": {\n \"amount\": \"\",\n \"currency\": \"JPY\"\n },\n \"customer_id\": \"\",\n \"card_details\": {\n \"status\": \"VOIDED\",\n \"card\": {\n \"id\": \"\",\n \"card_brand\": \"SQUARE_CAPITAL_CARD\",\n \"last_4\": \"\",\n \"exp_month\": \"\",\n \"exp_year\": \"\",\n \"cardholder_name\": \"\",\n \"billing_address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"HN\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n },\n \"fingerprint\": \"\",\n \"customer_id\": \"\",\n \"merchant_id\": \"\",\n \"reference_id\": \"\",\n \"enabled\": \"\",\n \"card_type\": \"CREDIT\",\n \"prepaid_type\": \"NOT_PREPAID\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"UNKNOWN\"\n },\n \"entry_method\": \"ON_FILE\"\n },\n \"cash_details\": {\n \"buyer_tendered_money\": {\n \"amount\": \"\",\n \"currency\": \"WST\"\n },\n \"change_back_money\": {\n \"amount\": \"\",\n \"currency\": \"LAK\"\n }\n },\n \"bank_account_details\": {\n \"status\": \"PENDING\"\n },\n \"buy_now_pay_later_details\": {\n \"buy_now_pay_later_brand\": \"AFTERPAY\",\n \"status\": \"FAILED\"\n },\n \"square_account_details\": {\n \"status\": \"FAILED\"\n },\n \"additional_recipients\": [\n {\n \"location_id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"SZL\"\n },\n \"description\": \"\",\n \"receivable_id\": \"\"\n }\n ],\n \"payment_id\": \"\"\n }\n ],\n \"refunds\": [\n {\n \"id\": \"\",\n \"location_id\": \"\",\n \"tender_id\": \"\",\n \"reason\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"USD\"\n },\n \"status\": \"FAILED\",\n \"transaction_id\": \"\",\n \"created_at\": \"\",\n \"processing_fee_money\": {\n \"amount\": \"\",\n \"currency\": \"ILS\"\n },\n \"additional_recipients\": [\n {\n \"location_id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"NZD\"\n },\n \"description\": \"\",\n \"receivable_id\": \"\"\n }\n ]\n }\n ],\n \"reference_id\": \"\",\n \"product\": \"INVOICES\",\n \"client_id\": \"\",\n \"shipping_address\": {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"address_line_3\": \"\",\n \"locality\": \"\",\n \"sublocality\": \"\",\n \"sublocality_2\": \"\",\n \"sublocality_3\": \"\",\n \"administrative_district_level_1\": \"\",\n \"administrative_district_level_2\": \"\",\n \"administrative_district_level_3\": \"\",\n \"postal_code\": \"\",\n \"country\": \"SS\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n },\n \"order_id\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-641ed4c2-037f-434b-ac6d-ceea79adf78e" } ], "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-c644abd4-5b25-435a-b449-6e8f6ff99239" } ], "id": "885aabd2-46ff-4018-bb9f-df4ff5525d00", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-885aabd2-46ff-4018-bb9f-df4ff5525d00" } ], "id": "005617e2-0361-43ed-ab44-57bc8608f219", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-005617e2-0361-43ed-ab44-57bc8608f219" } ], "id": "095a35fb-1848-4ea4-9278-d296195ae1ee", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-095a35fb-1848-4ea4-9278-d296195ae1ee" } ], "id": "4339ee23-18d7-4ba6-85dd-f8ce1df174be", "createdAt": "2026-07-28T03:04:44.000Z", "updatedAt": "2026-07-28T03:04:44.000Z", "uid": "35240-4339ee23-18d7-4ba6-85dd-f8ce1df174be" } ], "variable": [ { "key": "baseUrl", "value": "https://connect.squareup.com" } ] }