Customer

A Customer represents a buyer you do business with. Use Customers to save payment methods for reuse, track lifetime spend, attach metadata for your CRM, and group related Charges, Refunds, and Checkout Sessions under a single record. You can identify a Customer by their email or by a stable external ID from your own system and reference them on any future payment.

id*string

Customer ID

object*string

Object type

type*string

Customer type: registered (merchant-created) or guest (auto-created during checkout)

Value in"registered" | "guest"

createdAt*string

Created timestamp (ISO 8601)

updatedAt*string

Updated timestamp (ISO 8601)

name?|

Customer name

email?|

Customer email

phone?|

Customer phone number

address?|

Customer address

guestFingerprint?|

Guest fingerprint (only populated for type=guest). Captures the set of emails/phones/card fingerprints used during checkout so the same shopper is recognizable across sessions.

metadata?|

Merchant-supplied custom metadata

merchantId*string

Merchant ID owning this customer

{
  "id": "cus_abc123xyz",
  "object": "customer",
  "type": "registered",
  "createdAt": "string",
  "updatedAt": "string",
  "name": "string",
  "email": "string",
  "phone": "string",
  "address": {},
  "guestFingerprint": {},
  "metadata": {},
  "merchantId": "string"
}

Coupon

A Coupon defines a reusable discount you can apply to Checkout Sessions and PaymentIntents. Coupons can grant either a percentage off (`percentOff`) or a fixed amount off (`amountOff`), and can apply once, forever, or repeating for a number of billing cycles. You can also cap how many times a Coupon may be redeemed and when it expires. Coupons are the reusable template. Each concrete application of a Coupon to a customer's purchase is recorded as a Discount.

Discount

A Discount records a single application of a Coupon to a specific Checkout Session, PaymentIntent, or Customer. Where a Coupon is the reusable template, a Discount captures the concrete redemption: which Coupon was applied, when it became active, when it expires, and (when applicable) which Promotion Code the customer entered to claim it.