PaperTiger.Resources.Card (PaperTiger v0.9.21)

Handles Card resource endpoints.

DEPRECATED: Cards are deprecated in favor of PaymentMethod, but still supported for backward compatibility.

Endpoints

POST /v1/customers/:customer_id/sources - Create card (attach to customer)
GET /v1/customers/:customer_id/sources/:id - Retrieve card
POST /v1/customers/:customer_id/sources/:id - Update card
DELETE /v1/customers/:customer_id/sources/:id - Delete card (detach from customer)
GET /v1/customers/:customer_id/sources - List cards (filtered by customer)

Card Object

%{
  id: "card_...",
  object: "card",
  created: 1234567890,
  customer: "cus_...",
  brand: "Visa",
  last4: "4242",
  exp_month: 12,
  exp_year: 2025,
  fingerprint: "hash...",
  funding: "credit",
  metadata: %{},
  # ... other fields
}

Summary

Functions

create(conn)

Creates a new card (attaches to customer).

delete(conn, id)

Deletes a card (detaches from customer).

list(conn)

Lists all cards for a customer with pagination.

retrieve(conn, id)

Retrieves a card by ID.

update(conn, id)

Updates a card.

Functions

create(conn)

@spec create(Plug.Conn.t()) :: Plug.Conn.t()

Creates a new card (attaches to customer).

Required Parameters

customer - Customer ID to attach card to

Optional Parameters

source - Token ID or map of card details
brand - Card brand (Visa, Mastercard, American Express, Discover)
last4 - Last 4 digits
exp_month - Expiration month
exp_year - Expiration year
funding - Funding type (credit, debit, prepaid)
metadata - Key-value metadata