Skip to main content
Use this method to remove a stored payment method — for example, when a customer asks to forget a card, or after a one-off purchase where you don’t want to retain card details. For request and response details, see the Delete payment method API. To obtain a paymentMethodId, list the customer’s stored payment methods with client.getPaymentMethods().
Delete a payment method
import { createClient } from "@moonpay/platform-sdk-web";

const client = createClient({ sessionToken: "c3N0XzAwMQ==" });

// Call this after the client has an active connection.
const paymentMethodId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";

const result = await client.deletePaymentMethod(paymentMethodId);

if (!result.ok) {
  // Handle error
  console.error(result.error.code, result.error.message);
  return;
}

// On success, `result.value` is `undefined`.

​
Parameters

ParameterTypeRequiredDescription
paymentMethodIdstring✅The id of the stored card to delete. Obtain this from client.getPaymentMethods().

​
Result

client.deletePaymentMethod() returns a Result<void, DevPlatformApiError>. The API responds with 204 No Content on success, so result.value is undefined — there is no response body to read. Check result.ok to confirm the delete succeeded.

​
Result envelope

Result<void, DevPlatformApiError>
FieldTypeRequiredDescription
okboolean✅Whether the operation succeeded.
valueundefinedPresent when ok is true. Always undefined (no response body).
errorDevPlatformApiErrorPresent when ok is false.

​
DevPlatformApiError

The standard MoonPay Platform API error shape.
FieldTypeRequiredDescription
codeDevPlatformApiErrorCode✅A machine-readable error code (for example, "not_found", "unauthorized"). See the error reference for the full list.
messagestring✅A developer-friendly message.
errorsDevPlatformApiErrorDetail[]Optional list of field-level errors.
types.ts
type DevPlatformApiError = {
  code: DevPlatformApiErrorCode;
  message: string;
  errors?: DevPlatformApiErrorDetail[];
};

type DevPlatformApiErrorDetail = {
  field?: string;
  message: string;
};