{ "info": { "_postman_id": "8f4bee7f-9924-4478-848a-702e405aef8b", "name": "Square ApplePay Cards 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:01:52.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "lastUpdatedBy": "35240", "uid": "35240-8f4bee7f-9924-4478-848a-702e405aef8b" }, "item": [ { "name": "v2", "item": [ { "name": "cards", "item": [ { "name": "{card_id}", "item": [ { "name": "disable", "item": [ { "name": "Square Disable Card", "id": "01fd2c2a-5d5e-4814-82ca-cfc1438cad21", "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/cards/:card_id/disable", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards", ":card_id", "disable" ], "variable": [ { "id": "d7252217-4eb8-46d0-a0f0-81882b0b5a62", "key": "card_id", "value": "", "description": "(Required) Unique ID for the desired Card." } ] }, "description": "Disables the card, preventing any further updates or charges.\nDisabling an already disabled card is allowed but has no effect." }, "response": [ { "id": "a30f075d-821c-4b2b-9290-8bec4d9b8bff", "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/cards/:card_id/disable", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards", ":card_id", "disable" ], "variable": [ { "key": "card_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\": \"CUSTOMER_MISSING_NAME\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"ARRAY_LENGTH_TOO_SHORT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"card\": {\n \"id\": \"\",\n \"card_brand\": \"DISCOVER_DINERS\",\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\": \"LB\",\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\": \"UNKNOWN_PREPAID_TYPE\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"UNKNOWN\"\n }\n}", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-a30f075d-821c-4b2b-9290-8bec4d9b8bff" } ], "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-01fd2c2a-5d5e-4814-82ca-cfc1438cad21" } ], "id": "23c7e447-f104-4cd6-8ae6-1ce5bd71c087", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-23c7e447-f104-4cd6-8ae6-1ce5bd71c087" }, { "name": "Square Retrieve Card", "id": "a67e1f81-9fa4-4642-8188-15d81d0fef54", "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/cards/:card_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards", ":card_id" ], "variable": [ { "id": "b2315f14-e432-4916-b8f7-20bb29f48eac", "key": "card_id", "value": "", "description": "(Required) Unique ID for the desired Card." } ] }, "description": "Retrieves details for a specific Card." }, "response": [ { "id": "fe4652f5-ce31-4010-b686-b5abfc733ac9", "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/cards/:card_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards", ":card_id" ], "variable": [ { "key": "card_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\": \"PAYMENT_NOT_REFUNDABLE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"CARD_NOT_SUPPORTED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"card\": {\n \"id\": \"\",\n \"card_brand\": \"SQUARE_GIFT_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\": \"GP\",\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\": \"UNKNOWN_PREPAID_TYPE\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"UNKNOWN\"\n }\n}", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-fe4652f5-ce31-4010-b686-b5abfc733ac9" } ], "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-a67e1f81-9fa4-4642-8188-15d81d0fef54" } ], "id": "359adb89-f228-419c-ab85-b4e5f9a3b5e3", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-359adb89-f228-419c-ab85-b4e5f9a3b5e3" }, { "name": "Square List Cards", "id": "1301e3c6-79bc-41b1-a34a-7258b8f412ed", "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/cards?cursor=&customer_id=&include_disabled=false&reference_id=&sort_order=ASC", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards" ], "query": [ { "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 [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information.", "key": "cursor", "value": "" }, { "description": "Limit results to cards associated with the customer supplied.\nBy default, all cards owned by the merchant are returned.", "key": "customer_id", "value": "" }, { "description": "Includes disabled cards.\nBy default, all enabled cards owned by the merchant are returned.", "key": "include_disabled", "value": "false" }, { "description": "Limit results to cards associated with the reference_id supplied.", "key": "reference_id", "value": "" }, { "description": "Sorts the returned list by when the card was created with the specified order.\nThis field defaults to ASC.", "key": "sort_order", "value": "ASC" } ] }, "description": "Retrieves a list of cards owned by the account making the request.\nA max of 25 cards will be returned." }, "response": [ { "id": "a62ea4c9-bda8-4332-b82e-3e283dbc9cde", "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/cards?cursor=&customer_id=&include_disabled=false&reference_id=&sort_order=ASC", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards" ], "query": [ { "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 [Pagination](https://developer.squareup.com/docs/build-basics/common-api-patterns/pagination) for more information.", "key": "cursor", "value": "" }, { "description": "Limit results to cards associated with the customer supplied.\nBy default, all cards owned by the merchant are returned.", "key": "customer_id", "value": "" }, { "description": "Includes disabled cards.\nBy default, all enabled cards owned by the merchant are returned.", "key": "include_disabled", "value": "false" }, { "description": "Limit results to cards associated with the reference_id supplied.", "key": "reference_id", "value": "" }, { "description": "Sorts the returned list by when the card was created with the specified order.\nThis field defaults to ASC.", "key": "sort_order", "value": "ASC" } ] } }, "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\": \"CARD_DECLINED_VERIFICATION_REQUIRED\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"AUTHENTICATION_ERROR\",\n \"code\": \"PAN_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"cards\": [\n {\n \"id\": \"\",\n \"card_brand\": \"MASTERCARD\",\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\": \"RE\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n },\n \"fingerprint\": \"\",\n \"customer_id\": \"\",\n \"merchant_id\": \"\",\n \"reference_id\": \"\",\n \"enabled\": \"\",\n \"card_type\": \"DEBIT\",\n \"prepaid_type\": \"PREPAID\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"CLEARPAY\"\n },\n {\n \"id\": \"\",\n \"card_brand\": \"CHINA_UNIONPAY\",\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\": \"AU\",\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\": \"UNKNOWN_PREPAID_TYPE\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"CLEARPAY\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-a62ea4c9-bda8-4332-b82e-3e283dbc9cde" } ], "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-1301e3c6-79bc-41b1-a34a-7258b8f412ed" }, { "name": "Square Create Card", "id": "4652363f-edc2-4171-b878-5eb94fa5c7a2", "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 \"source_id\": \"\",\n \"card\": {\n \"id\": \"\",\n \"card_brand\": \"EFTPOS\",\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\": \"SK\",\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\": \"UNKNOWN_PREPAID_TYPE\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"AFTERPAY\"\n },\n \"verification_token\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/cards", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards" ] }, "description": "Adds a card on file to an existing merchant." }, "response": [ { "id": "fc6a3f9c-e00f-426b-8fa4-ec6e9f9073fd", "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 \"source_id\": \"\",\n \"card\": {\n \"id\": \"\",\n \"card_brand\": \"EFTPOS\",\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\": \"SK\",\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\": \"UNKNOWN_PREPAID_TYPE\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"AFTERPAY\"\n },\n \"verification_token\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/cards", "host": [ "{{baseUrl}}" ], "path": [ "v2", "cards" ] } }, "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\": \"INVALID_ENUM_VALUE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"INVALID_ACCOUNT\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"card\": {\n \"id\": \"\",\n \"card_brand\": \"VISA\",\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\": \"KE\",\n \"first_name\": \"\",\n \"last_name\": \"\"\n },\n \"fingerprint\": \"\",\n \"customer_id\": \"\",\n \"merchant_id\": \"\",\n \"reference_id\": \"\",\n \"enabled\": \"\",\n \"card_type\": \"DEBIT\",\n \"prepaid_type\": \"UNKNOWN_PREPAID_TYPE\",\n \"bin\": \"\",\n \"version\": \"\",\n \"card_co_brand\": \"AFTERPAY\"\n }\n}", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-fc6a3f9c-e00f-426b-8fa4-ec6e9f9073fd" } ], "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-4652363f-edc2-4171-b878-5eb94fa5c7a2" } ], "id": "ba5615c9-493e-4950-8c20-2e2028485c95", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-ba5615c9-493e-4950-8c20-2e2028485c95" } ], "id": "0576bf7f-7b39-4719-8d65-e2f7d5dc29f0", "createdAt": "2026-07-28T03:01:53.000Z", "updatedAt": "2026-07-28T03:01:53.000Z", "uid": "35240-0576bf7f-7b39-4719-8d65-e2f7d5dc29f0" } ], "variable": [ { "key": "baseUrl", "value": "https://connect.squareup.com" } ] }