TOKENS

Create a card token

Creates a single-use token, which is a unique code that indicates credit card details. Use this token with endpoints like create a charge or pay for an order.

post/v1/tokens

Request

  • Base URL
    https://token-sandbox.dev.clover.com
  • URL
    https://token-sandbox.dev.clover.com/v1/tokens
  • Auth
    none declared. Required headers: apikey, User-Agent

Headers

apikeystring uuid required

Public Ecommerce API key associated with a specific merchant and developer app. Use Retrieve an Ecommerce API key or PAKMS key to generate this key.

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <application>/<version>

Request body

Example request

{
  "card": {
    "phone_number": "+14155552671",
    "email": "jdoe@example.com"
  }
}

Response

Successful response. Card token generated.

idstring

Unique identification.

tokenstring

Public source token provided by Clover.

client_ipstring

Internet protocol (IP) address of the client generating the token.

createdinteger

Time the token object was created.

livemodeboolean

Indicates whether the token object is live in production. Values: True - Token object is in production. False - Token object is in sandbox.

type'card' | 'wallet (Google Pay or Apple Pay)'

Token type.

usedboolean

Indicates whether the token is already used. Note that tokens can be used only once.

Changes

No recorded changes to this operation across all 1 revision of this API.