Attach a saved payment method

Persists the card from a confirmed SetupIntent against the contact. The SetupIntent is re-verified server-side (status + scope) before the card is saved. Replaces any existing card on file for the contact.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Request Body

application/jsonRequired

setupIntentIdRequiredstring

Stripe SetupIntent id confirmed on the client

Path Parameters

idRequiredstring

Contact id, discoverable via list_contacts

POST/v1/contacts/{id}/payment-methods

curl -X POST "https://api.3common.com/v1/contacts/string/payment-methods" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "setupIntentId": "string"
  }'

Default Response

Response

{
  "data": {
    "id": "string",
    "contactId": "string",
    "card": {
      "brand": "string",
      "last4": "string",
      "expMonth": -9007199254740991,
      "expYear": -9007199254740991,
      "country": "string",
      "funding": "string"
    },
    "billingDetails": {
      "name": "string",
      "email": "string",
      "phone": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "state": "string",
      "postalCode": "string",
      "country": "string"
    },
    "status": "active",
    "detachedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  },
  "replacedExisting": true
}

TypeScript

export interface Response {
  data: {
    id: string;
    contactId: string;
    card: {
      brand: string;
      last4: string;
      expMonth: number;
      expYear: number;
      country?: string;
      funding?: string;
    };
    billingDetails?: {
      name?: string;
      email?: string;
      phone?: string;
      addressLine1?: string;
      addressLine2?: string;
      city?: string;
      state?: string;
      postalCode?: string;
      country?: string;
    };
    status: "active" | "detached" | "expired";
    detachedAt?: string;
    createdAt: string;
    updatedAt: string;
  };
  replacedExisting: boolean;
}