Skip to main content
DELETE
/
unstable
/
payment-methods
/
{paymentMethodId}
Delete a payment method
curl --request DELETE \
  --url https://www.crossmint.com/api/unstable/payment-methods/{paymentMethodId} \
  --header 'X-API-KEY: <api-key>'
{ "paymentMethodId": "d4e5f6a7-b8c9-0123-def4-567890abcdef", "default": false, "displayName": "Visa ••1111", "type": "card", "card": { "brand": "visa", "last4": "1111", "expiration": { "month": "12", "year": "2028" }, "billing": { "name": "Alice Smith", "phone": "+12125551234", "address": { "line1": "123 Main St", "city": "Springfield", "stateOrRegion": "IL", "postalCode": "62701", "country": "US" } }, "fundingType": "debit", "bin": "411111", "country": "US" } }
This endpoint requires a JWT from an external auth provider (Auth0, Firebase, Stytch, etc.) or a custom JWT backed by a JWKS endpoint. Crossmint Auth is not supported.

Authorizations

​
X-API-KEY
string
header
required

Server-side API key from the Crossmint dashboard.

Path Parameters

​
paymentMethodId
string<uuid>
required

PaymentMethod identifier.

Query Parameters

​
userLocator
string

Identifies the target user. Format: <type>:<value> (e.g., email:alice@example.com, userId:abc123). Required with server API key auth; ignored with JWT.

Response

PaymentMethod object (pre-deletion state). The record is no longer returned by list or retrieve endpoints.

A saved payment method. Sensitive fields (full PAN, CVC, full account numbers) are never included in responses.

​
paymentMethodId
string<uuid>
required

Unique identifier (UUID v4), assigned by the server on creation.

​
default
boolean
required

Whether this is the user's default payment method. Only one per user can be the default; setting a new default automatically unsets the previous one.

​
displayName
string
required

Human-readable label derived by the server (e.g., "Visa ••1111", "SEPA Account ••6789"). Not settable by the client.

​
type
enum<string>
required

Payment method type. Determines which sub-object (card or bankAccount) is present.

Available options:
card
​
card
object
required

Card details. Present when type is card.