Payment Method

Properties

Property	Type	Required	Description
`type`	string	Yes	Payment method type (e.g., `apple_pay`)
`capabilities`	object	Yes	What this payment method supports
`availability`	object	Yes	Whether this payment method is currently available

Capabilities

Property	Type	Required	Description
`supportedCurrencies`	string[]	Yes	Currencies supported (e.g., `["USD", "EUR"]`)
`supportedTransactionTypes`	string[]	Yes	Transaction types supported (e.g., `["buy", "sell"]`)
`allowsDeletion`	boolean	Yes	Whether this payment method can be deleted
`requiresWidget`	boolean	Yes	Whether completing the payment requires the MoonPay widget

Availability

Property	Type	Required	Description
`active`	boolean	Yes	Whether the payment method is currently available
`reasons`	string[]	No	If unavailable, a list of machine-readable reasons

Payment Method Types

Type	Description
`apple_pay`	Apple Pay
`google_pay`	Google Pay
`card`	Stored credit or debit card
`sepa`	SEPA bank transfer

The fiat currencies each method supports come from capabilities.supportedCurrencies (see Capabilities); sepa bank transfers are EUR only. Bank transfers (sepa) are a floating payment method: the quote is an estimate, and the final amount is set when the customer’s funds settle. See Exchange rate type.

Example

{
  "type": "apple_pay",
  "capabilities": {
    "supportedCurrencies": ["USD", "EUR", "GBP"],
    "supportedTransactionTypes": ["buy"],
    "allowsDeletion": false,
    "requiresWidget": false
  },
  "availability": {
    "active": true
  }
}

Checking Availability

Always check availability.active before offering a payment method to users. If active is false, check reasons for machine-readable details:

{
  "type": "apple_pay",
  "capabilities": {
    "supportedCurrencies": ["USD"],
    "supportedTransactionTypes": ["buy"],
    "allowsDeletion": false,
    "requiresWidget": false
  },
  "availability": {
    "active": false,
    "reasons": ["maintenance"]
  }
}

Documentation

Sessions

Customers

Payment Methods

Assets

Quotes

Transactions

Objects & Types

Properties

Capabilities

Availability

Payment Method Types

Example

Checking Availability

​Properties

​Capabilities

​Availability

​Payment Method Types

​Example

​Checking Availability

Properties

Capabilities

Availability

Payment Method Types

Example

Checking Availability