Save card on file

POST

/square/customers/{customer}/cards

Last modified:2026-09-03 03:39:26

source_id must be a one-time token generated by Square Web Payments SDK or Square Sandbox tooling.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Card saved

Bodyapplication/json

🟠422ValidationError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://connect.dispatchable.com/square_up/api/v1/square/customers//cards' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "source_id": "cnon:card-nonce-from-square",
    "cardholder_name": "Jane Doe",
    "reference_id": "contact-12345",
    "billing_address": {
        "address_line_1": "123 Main Street",
        "locality": "Miami",
        "administrative_district_level_1": "FL",
        "postal_code": "33101",
        "country": "US"
    }
}'

Response Example

201 - Example 1

{
    "data": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "company_uuid": "aba69bec-94b3-48e8-9737-4f951465d0f8",
        "square_card_id": "string",
        "brand": "string",
        "last_four": "1111",
        "exp_month": 0,
        "exp_year": 0,
        "cardholder_name": "string",
        "enabled": true,
        "square_data": {
            "property1": "string",
            "property2": "string"
        }
    }
}

Modified at 2026-09-03 03:39:26

List customer's cards

Retrieve saved card