{ "info": { "_postman_id": "e59951ba-22e3-42cb-95a1-78966703b18b", "name": "Square ApplePay Disputes 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:02:23.000Z", "updatedAt": "2026-07-28T03:02:23.000Z", "lastUpdatedBy": "35240", "uid": "35240-e59951ba-22e3-42cb-95a1-78966703b18b" }, "item": [ { "name": "v2", "item": [ { "name": "disputes", "item": [ { "name": "{dispute_id}", "item": [ { "name": "accept", "item": [ { "name": "Square Accept Dispute", "id": "00fbf2cd-d6c6-4d19-a8af-36712e59e759", "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/disputes/:dispute_id/accept", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "accept" ], "variable": [ { "id": "73bfd501-aae7-4c3d-be55-1245d81dd290", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute you want to accept." } ] }, "description": "Accepts the loss on a dispute. Square returns the disputed amount to the cardholder and\nupdates the dispute state to ACCEPTED.\n\nSquare debits the disputed amount from the seller\u2019s Square account. If the Square account\ndoes not have sufficient funds, Square debits the associated bank account." }, "response": [ { "id": "9c80ddd9-d68d-4c6b-baf5-a1cf5f3e1b2f", "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/disputes/:dispute_id/accept", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "accept" ], "variable": [ { "key": "dispute_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\": \"TEMPORARY_ERROR\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"INVALID_SQUARE_VERSION_FORMAT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"dispute\": {\n \"dispute_id\": \"\",\n \"id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"SSP\"\n },\n \"reason\": \"DUPLICATE\",\n \"state\": \"LOST\",\n \"due_at\": \"\",\n \"disputed_payment\": {\n \"payment_id\": \"\"\n },\n \"evidence_ids\": [\n \"\",\n \"\"\n ],\n \"card_brand\": \"EBT\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"brand_dispute_id\": \"\",\n \"reported_date\": \"\",\n \"reported_at\": \"\",\n \"version\": \"\",\n \"location_id\": \"\"\n }\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-9c80ddd9-d68d-4c6b-baf5-a1cf5f3e1b2f" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-00fbf2cd-d6c6-4d19-a8af-36712e59e759" } ], "id": "086f25bd-f983-4242-8424-80d2f8101cdd", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-086f25bd-f983-4242-8424-80d2f8101cdd" }, { "name": "evidence", "item": [ { "name": "{evidence_id}", "item": [ { "name": "Square Delete Dispute Evidence", "id": "25d72953-2b2a-4766-8f0a-13139db4a6c9", "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": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/disputes/:dispute_id/evidence/:evidence_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence", ":evidence_id" ], "variable": [ { "id": "46dd4808-1526-44c6-b450-582b6e324ca5", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute from which you want to remove evidence." }, { "id": "01d0cb2b-7fad-42ad-820f-86a1cc4f21c0", "key": "evidence_id", "value": "", "description": "(Required) The ID of the evidence you want to remove." } ] }, "description": "Removes specified evidence from a dispute.\nSquare does not send the bank any evidence that is removed." }, "response": [ { "id": "74a11c76-25cc-44b0-92b8-23fb742b05b9", "name": "Success", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/disputes/:dispute_id/evidence/:evidence_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence", ":evidence_id" ], "variable": [ { "key": "dispute_id" }, { "key": "evidence_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"EXTERNAL_VENDOR_ERROR\",\n \"code\": \"VERIFY_CVV_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"CONFLICT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-74a11c76-25cc-44b0-92b8-23fb742b05b9" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-25d72953-2b2a-4766-8f0a-13139db4a6c9" }, { "name": "Square Retrieve Dispute Evidence", "id": "7a3ce489-b754-418c-8e6b-a027804b6eff", "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/disputes/:dispute_id/evidence/:evidence_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence", ":evidence_id" ], "variable": [ { "id": "44eee0f3-c404-4abb-8c87-a939f0b65324", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute from which you want to retrieve evidence metadata." }, { "id": "c2ac0be9-7ee8-4e21-89c2-21b8739227d4", "key": "evidence_id", "value": "", "description": "(Required) The ID of the evidence to retrieve." } ] }, "description": "Returns the metadata for the evidence specified in the request URL path.\n\nYou must maintain a copy of any evidence uploaded if you want to reference it later. Evidence cannot be downloaded after you upload it." }, "response": [ { "id": "7972741d-915c-4159-86a8-4c2e6bbb54d7", "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/disputes/:dispute_id/evidence/:evidence_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence", ":evidence_id" ], "variable": [ { "key": "dispute_id" }, { "key": "evidence_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"API_ERROR\",\n \"code\": \"REFUND_ALREADY_PENDING\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"AUTHENTICATION_ERROR\",\n \"code\": \"PLAID_ERROR\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"evidence\": {\n \"evidence_id\": \"\",\n \"id\": \"\",\n \"dispute_id\": \"\",\n \"evidence_file\": {\n \"filename\": \"\",\n \"filetype\": \"\"\n },\n \"evidence_text\": \"\",\n \"uploaded_at\": \"\",\n \"evidence_type\": \"TRACKING_NUMBER\"\n }\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-7972741d-915c-4159-86a8-4c2e6bbb54d7" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-7a3ce489-b754-418c-8e6b-a027804b6eff" } ], "id": "c9e1e394-2a6e-4c5e-b5d8-c5a42007d8cc", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-c9e1e394-2a6e-4c5e-b5d8-c5a42007d8cc" }, { "name": "Square List Dispute Evidence", "id": "39a25c5f-4c5d-408a-bf34-6f6f19141d11", "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/disputes/:dispute_id/evidence?cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence" ], "query": [ { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", "key": "cursor", "value": "" } ], "variable": [ { "id": "7c8df70a-db1e-4880-8d9e-4adee21c05b4", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute." } ] }, "description": "Returns a list of evidence associated with a dispute." }, "response": [ { "id": "5eac9246-8687-45ca-a54a-26f7266976f4", "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/disputes/:dispute_id/evidence?cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence" ], "query": [ { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", "key": "cursor", "value": "" } ], "variable": [ { "key": "dispute_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"evidence\": [\n {\n \"evidence_id\": \"\",\n \"id\": \"\",\n \"dispute_id\": \"\",\n \"evidence_file\": {\n \"filename\": \"\",\n \"filetype\": \"\"\n },\n \"evidence_text\": \"\",\n \"uploaded_at\": \"\",\n \"evidence_type\": \"CANCELLATION_OR_REFUND_DOCUMENTATION\"\n },\n {\n \"evidence_id\": \"\",\n \"id\": \"\",\n \"dispute_id\": \"\",\n \"evidence_file\": {\n \"filename\": \"\",\n \"filetype\": \"\"\n },\n \"evidence_text\": \"\",\n \"uploaded_at\": \"\",\n \"evidence_type\": \"REBUTTAL_EXPLANATION\"\n }\n ],\n \"errors\": [\n {\n \"category\": \"API_ERROR\",\n \"code\": \"PAYMENT_AMOUNT_MISMATCH\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"API_VERSION_INCOMPATIBLE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-5eac9246-8687-45ca-a54a-26f7266976f4" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-39a25c5f-4c5d-408a-bf34-6f6f19141d11" } ], "id": "a9eb1fa6-704b-4a25-a434-0bd5d4eb7038", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-a9eb1fa6-704b-4a25-a434-0bd5d4eb7038" }, { "name": "evidence-files", "item": [ { "name": "Square Create Dispute Evidence File", "id": "f734c195-4052-431c-bd59-c86a48d8713b", "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": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) Defines the parameters for a `CreateDisputeEvidenceFile` request.", "key": "request", "value": "[object Object]", "type": "text", "contentType": "application/json; charset=utf-8" }, { "key": "image_file", "type": "file", "contentType": "image/jpeg", "value": null } ] }, "url": { "raw": "{{baseUrl}}/v2/disputes/:dispute_id/evidence-files", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence-files" ], "variable": [ { "id": "967315a8-940c-4700-b150-1eb29c758b65", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute for which you want to upload evidence." } ] }, "description": "Uploads a file to use as evidence in a dispute challenge. The endpoint accepts HTTP\nmultipart/form-data file uploads in HEIC, HEIF, JPEG, PDF, PNG, and TIFF formats." }, "response": [ { "id": "993ae2f2-004c-478d-b764-7e07c2add2fc", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) Defines the parameters for a `CreateDisputeEvidenceFile` request.", "key": "request", "value": "[object Object]", "type": "text", "contentType": "application/json; charset=utf-8" }, { "key": "image_file", "type": "file", "contentType": "image/jpeg" } ] }, "url": { "raw": "{{baseUrl}}/v2/disputes/:dispute_id/evidence-files", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence-files" ], "variable": [ { "key": "dispute_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\": \"CARD_DECLINED_VERIFICATION_REQUIRED\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"API_ERROR\",\n \"code\": \"UNSUPPORTED_COUNTRY\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"evidence\": {\n \"evidence_id\": \"\",\n \"id\": \"\",\n \"dispute_id\": \"\",\n \"evidence_file\": {\n \"filename\": \"\",\n \"filetype\": \"\"\n },\n \"evidence_text\": \"\",\n \"uploaded_at\": \"\",\n \"evidence_type\": \"SERVICE_RECEIVED_DOCUMENTATION\"\n }\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-993ae2f2-004c-478d-b764-7e07c2add2fc" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-f734c195-4052-431c-bd59-c86a48d8713b" } ], "id": "143c1c6c-8e07-4cf1-89ed-3fa19d00f3d1", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-143c1c6c-8e07-4cf1-89ed-3fa19d00f3d1" }, { "name": "evidence-text", "item": [ { "name": "Square Create Dispute Evidence Text", "id": "14c729c3-3f5c-4a21-b652-61ba6743ac37", "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": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"idempotency_key\": \"\",\n \"evidence_text\": \"\",\n \"evidence_type\": \"RELATED_TRANSACTION_DOCUMENTATION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/disputes/:dispute_id/evidence-text", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence-text" ], "variable": [ { "id": "94fdc01b-3d94-408c-9fac-ff833dae4196", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute for which you want to upload evidence." } ] }, "description": "Uploads text to use as evidence for a dispute challenge." }, "response": [ { "id": "ffdc864f-1f2e-4a26-a0c3-84d7fa82d26f", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"idempotency_key\": \"\",\n \"evidence_text\": \"\",\n \"evidence_type\": \"RELATED_TRANSACTION_DOCUMENTATION\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/disputes/:dispute_id/evidence-text", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "evidence-text" ], "variable": [ { "key": "dispute_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"ACCOUNT_UNUSABLE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"PAYMENT_METHOD_ERROR\",\n \"code\": \"EXPIRATION_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"evidence\": {\n \"evidence_id\": \"\",\n \"id\": \"\",\n \"dispute_id\": \"\",\n \"evidence_file\": {\n \"filename\": \"\",\n \"filetype\": \"\"\n },\n \"evidence_text\": \"\",\n \"uploaded_at\": \"\",\n \"evidence_type\": \"RELATED_TRANSACTION_DOCUMENTATION\"\n }\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-ffdc864f-1f2e-4a26-a0c3-84d7fa82d26f" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-14c729c3-3f5c-4a21-b652-61ba6743ac37" } ], "id": "97e38f71-f6a7-430e-b756-f4a5acd5f790", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-97e38f71-f6a7-430e-b756-f4a5acd5f790" }, { "name": "submit-evidence", "item": [ { "name": "Square Submit Evidence", "id": "246c7825-4bc2-4308-a055-66b0441388f7", "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/disputes/:dispute_id/submit-evidence", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "submit-evidence" ], "variable": [ { "id": "5eb00fd1-bb6d-4b59-a74e-e1ad439c73eb", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute for which you want to submit evidence." } ] }, "description": "Submits evidence to the cardholder's bank.\n\nThe evidence submitted by this endpoint includes evidence uploaded\nusing the [CreateDisputeEvidenceFile](api-endpoint:Disputes-CreateDisputeEvidenceFile) and\n[CreateDisputeEvidenceText](api-endpoint:Disputes-CreateDisputeEvidenceText) endpoints and\nevidence automatically provided by Square, when available. Evidence cannot be removed from\na dispute after submission." }, "response": [ { "id": "9090c391-8b06-43b6-96bb-a3e886d0f4e8", "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/disputes/:dispute_id/submit-evidence", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id", "submit-evidence" ], "variable": [ { "key": "dispute_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\": \"APPLE_TTP_PIN_TOKEN\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"REQUEST_TIMEOUT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"dispute\": {\n \"dispute_id\": \"\",\n \"id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"CHW\"\n },\n \"reason\": \"PAID_BY_OTHER_MEANS\",\n \"state\": \"EVIDENCE_REQUIRED\",\n \"due_at\": \"\",\n \"disputed_payment\": {\n \"payment_id\": \"\"\n },\n \"evidence_ids\": [\n \"\",\n \"\"\n ],\n \"card_brand\": \"VISA\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"brand_dispute_id\": \"\",\n \"reported_date\": \"\",\n \"reported_at\": \"\",\n \"version\": \"\",\n \"location_id\": \"\"\n }\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-9090c391-8b06-43b6-96bb-a3e886d0f4e8" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-246c7825-4bc2-4308-a055-66b0441388f7" } ], "id": "51a54cf8-ae68-473b-8c11-2ffeaa058725", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-51a54cf8-ae68-473b-8c11-2ffeaa058725" }, { "name": "Square Retrieve Dispute", "id": "7f50bdb9-6605-4778-b5fc-62c13efef592", "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/disputes/:dispute_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id" ], "variable": [ { "id": "f215f5a1-ef11-4579-b08d-b62dc0c38fcf", "key": "dispute_id", "value": "", "description": "(Required) The ID of the dispute you want more details about." } ] }, "description": "Returns details about a specific dispute." }, "response": [ { "id": "965eaae7-4315-49ee-ae34-0296bf218665", "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/disputes/:dispute_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes", ":dispute_id" ], "variable": [ { "key": "dispute_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\": \"PAYMENT_METHOD_ERROR\",\n \"code\": \"CARD_DECLINED_VERIFICATION_REQUIRED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"dispute\": {\n \"dispute_id\": \"\",\n \"id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"PHP\"\n },\n \"reason\": \"DUPLICATE\",\n \"state\": \"ACCEPTED\",\n \"due_at\": \"\",\n \"disputed_payment\": {\n \"payment_id\": \"\"\n },\n \"evidence_ids\": [\n \"\",\n \"\"\n ],\n \"card_brand\": \"AMERICAN_EXPRESS\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"brand_dispute_id\": \"\",\n \"reported_date\": \"\",\n \"reported_at\": \"\",\n \"version\": \"\",\n \"location_id\": \"\"\n }\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-965eaae7-4315-49ee-ae34-0296bf218665" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-7f50bdb9-6605-4778-b5fc-62c13efef592" } ], "id": "8025a9ce-e9c9-4c5b-afe1-f9696cedfd7d", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-8025a9ce-e9c9-4c5b-afe1-f9696cedfd7d" }, { "name": "Square List Disputes", "id": "adc5efa3-eb0c-4bc7-87a1-558619c6f9d9", "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/disputes?cursor=&states=ACCEPTED&location_id=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes" ], "query": [ { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", "key": "cursor", "value": "" }, { "description": "The dispute states used to filter the result. If not specified, the endpoint returns all disputes.", "key": "states", "value": "ACCEPTED" }, { "description": "The ID of the location for which to return a list of disputes.\nIf not specified, the endpoint returns disputes associated with all locations.", "key": "location_id", "value": "" } ] }, "description": "Returns a list of disputes associated with a particular account." }, "response": [ { "id": "c9bacc48-633d-4ef4-af17-19bee99edb51", "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/disputes?cursor=&states=ACCEPTED&location_id=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "disputes" ], "query": [ { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this cursor to retrieve the next set of results for the original query.\nFor more information, see [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination).", "key": "cursor", "value": "" }, { "description": "The dispute states used to filter the result. If not specified, the endpoint returns all disputes.", "key": "states", "value": "ACCEPTED" }, { "description": "The ID of the location for which to return a list of disputes.\nIf not specified, the endpoint returns disputes associated with all locations.", "key": "location_id", "value": "" } ] } }, "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\": \"INVALID_EXPIRATION\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"EXTERNAL_VENDOR_ERROR\",\n \"code\": \"CONFLICT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"disputes\": [\n {\n \"dispute_id\": \"\",\n \"id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"RWF\"\n },\n \"reason\": \"PAID_BY_OTHER_MEANS\",\n \"state\": \"INQUIRY_PROCESSING\",\n \"due_at\": \"\",\n \"disputed_payment\": {\n \"payment_id\": \"\"\n },\n \"evidence_ids\": [\n \"\",\n \"\"\n ],\n \"card_brand\": \"VISA\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"brand_dispute_id\": \"\",\n \"reported_date\": \"\",\n \"reported_at\": \"\",\n \"version\": \"\",\n \"location_id\": \"\"\n },\n {\n \"dispute_id\": \"\",\n \"id\": \"\",\n \"amount_money\": {\n \"amount\": \"\",\n \"currency\": \"LYD\"\n },\n \"reason\": \"NOT_AS_DESCRIBED\",\n \"state\": \"INQUIRY_CLOSED\",\n \"due_at\": \"\",\n \"disputed_payment\": {\n \"payment_id\": \"\"\n },\n \"evidence_ids\": [\n \"\",\n \"\"\n ],\n \"card_brand\": \"MASTERCARD\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"brand_dispute_id\": \"\",\n \"reported_date\": \"\",\n \"reported_at\": \"\",\n \"version\": \"\",\n \"location_id\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-c9bacc48-633d-4ef4-af17-19bee99edb51" } ], "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-adc5efa3-eb0c-4bc7-87a1-558619c6f9d9" } ], "id": "1789af7b-2bef-43ad-93fa-012db1f248b3", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-1789af7b-2bef-43ad-93fa-012db1f248b3" } ], "id": "d7fbe3b3-039d-4992-8298-99b07c1c2578", "createdAt": "2026-07-28T03:02:24.000Z", "updatedAt": "2026-07-28T03:02:24.000Z", "uid": "35240-d7fbe3b3-039d-4992-8298-99b07c1c2578" } ], "variable": [ { "key": "baseUrl", "value": "https://connect.squareup.com" } ] }