Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.moonpay.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this method to list the customer’s available payment methods, plus any cards they have on file. For request and response details, see the List payment methods API.
Get payment methods
import { useMoonPay } from "@moonpay/platform-sdk-react-native";

export function PaymentMethodsList() {
  const { client } = useMoonPay();

  const load = async () => {
    // Call this after the client has an active connection (for example, after
    // `client.getConnection()` returns `status: "active"` or after `client.connect()`
    // completes).
    const result = await client.getPaymentMethods();

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

    console.log(result.value.data); // Available payment-method configs
    console.log(result.value.storedCards); // Saved cards on file (if any)
  };

  // ...
}

​
Result

client.getPaymentMethods() returns a Result<ListPaymentMethodsResponse, GetPaymentMethodsError>.

​
Result envelope

Result<ListPaymentMethodsResponse, GetPaymentMethodsError>
FieldTypeRequiredDescription
okboolean✅Whether the operation succeeded.
valueListPaymentMethodsResponsePresent when ok is true.
errorGetPaymentMethodsErrorPresent when ok is false.

​
ListPaymentMethodsResponse

FieldTypeRequiredDescription
dataPaymentMethodConfig[]✅Payment methods (Apple Pay, Google Pay, card, etc.) available to the customer with their capabilities and availability.
storedCardsStoredCardPaymentMethod[]Cards the customer has saved on file. Present when the connected customer has at least one saved card.

​
PaymentMethodConfig

FieldTypeRequiredDescription
typePaymentMethodType✅The payment method type (for example, "apple_pay", "google_pay", "card").
capabilitiesPaymentMethodCapabilities✅Details about how this payment method can be used.
availabilityPaymentMethodAvailability✅Whether this payment method is available for the current session.

​
PaymentMethodCapabilities

FieldTypeRequiredDescription
supportedCurrenciesstring[]✅A list of ISO 4217 fiat currency codes that this payment method can be used with.
supportedTransactionTypesstring[]✅The kinds of transactions this payment method can be used for.

​
PaymentMethodAvailability

FieldTypeRequiredDescription
activeboolean✅Whether this payment method is available for the current session.
unavailableReasonstringIf the payment method is unavailable, a developer-friendly message.

​
StoredCardPaymentMethod

A card the customer has saved on file. Use the id directly in client.getQuote() to quote against a specific stored card. See the API reference for the full shape, including network brand, expiry, and last4.
FieldTypeRequiredDescription
idstring✅The stored card identifier. Pass this to getQuote({ paymentMethod: { type: "card", id } }).
typestring✅The payment method type, typically "card".

​
GetPaymentMethodsError

GetPaymentMethodsError is the standard MoonPay Platform API error shape, DevPlatformApiError.
FieldTypeRequiredDescription
codeDevPlatformApiErrorCode✅A machine-readable error code (for example, "unauthorized", "connection_required"). See the error reference for the full list.
messagestring✅A developer-friendly message.
errorsDevPlatformApiErrorDetail[]Optional list of field-level errors.
types.ts
type ListPaymentMethodsResponse = {
  data: PaymentMethodConfig[];
  storedCards?: StoredCardPaymentMethod[];
};

type PaymentMethodConfig = {
  type: PaymentMethodType;
  capabilities: PaymentMethodCapabilities;
  availability: PaymentMethodAvailability;
};

type PaymentMethodCapabilities = {
  supportedCurrencies: string[];
  supportedTransactionTypes: string[];
};

type PaymentMethodAvailability = {
  active: boolean;
  unavailableReason?: string;
};

type GetPaymentMethodsError = {
  code: DevPlatformApiErrorCode;
  message: string;
  errors?: DevPlatformApiErrorDetail[];
};