Create customer card

Deprecated

- POST /v2/customers/{customer_id}/cards

Adds a card on file to an existing customer.

Open in API Reference

Access Tokens Sign in to populate your access tokens from the developer dashboard Sign In

Parameters

customer_id

The Square ID of the customer profile the card is linked to.

string

Body

card_nonce

A card nonce representing the credit card to link to the customer.

Card nonces are generated by the Square payment form when customers enter their card information. For more information, see Walkthrough: Integrate Square Payments in a Website.

NOTE: Card nonces generated by digital wallets (such as Apple Pay) cannot be used to create a customer card.

string

billing_address

Address information for the card on file.

NOTE: If a billing address is provided in the request, the CreateCustomerCardRequest.billing_address.postal_code must match the postal code encoded in the card nonce.

Address

cardholder_name

The full name printed on the credit card.

string

verification_token

An identifying token generated by Payments.verifyBuyer(). Verification tokens encapsulate customer device information and 3-D Secure challenge results to indicate that Square has verified the buyer identity.

string

You are viewing an old version of the API

All Versions

Request

cURL

Ruby

Python

Java

PHP

Node.js

Response

// No response received yet.

Thanks for the feedback. For more help, check out our support resources.

Developer Support Developer Forums

There was an error submitting feedback. Try again later.

Developer Support Developer Forums