create-customer-card-request.md

Create Customer Card Request

Defines the fields that are included in the request body of a request to the CreateCustomerCard endpoint.

Structure

CreateCustomerCardRequest

Fields

Name	Type	Tags	Description
cardNonce	string	Required	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.
billingAddress	Address | undefined	Optional	Represents a postal address in a country. For more information, see Working with Addresses.
cardholderName	string | undefined	Optional	The full name printed on the credit card.
verificationToken	string | undefined	Optional	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.

Example (as JSON)

{
  "billing_address": {
    "address_line_1": "500 Electric Ave",
    "address_line_2": "Suite 600",
    "administrative_district_level_1": "NY",
    "country": "US",
    "locality": "New York",
    "postal_code": "10003"
  },
  "card_nonce": "YOUR_CARD_NONCE",
  "cardholder_name": "Amelia Earhart"
}