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

Create Customer Card Request

Fields

Name	Type	Tags	Description
card_nonce	str	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.
billing_address	Address	Optional	Represents a postal address in a country. For more information, see Working with Addresses.
cardholder_name	str	Optional	The full name printed on the credit card.
verification_token	str	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",
    "address_line_3": "address_line_34",
    "sublocality": "sublocality8"
  },
  "card_nonce": "YOUR_CARD_NONCE",
  "cardholder_name": "Amelia Earhart",
  "verification_token": "verification_token0"
}