# PaymentMethod

Object · GraphQL API

Top-level field representing a payment method.

## Fields

- `id` (`ID!`) — non-null: Unique identifier.
- `legacyId` (`ID!`) — non-null: Legacy unique identifier. May be the same as ID for single-use payment methods.
- `usage` (`PaymentMethodUsage`): Whether a payment method may be used only once or multiple times.
- `createdAt` (`Timestamp`): Date and time when the payment method was vaulted.
- `details` (`PaymentMethodDetails`): Details about the payment method specific to the type (e.g. credit card, PayPal account).
- `verifications` (`VerificationConnection`): A paginated list of verifications that have been run against the payment method.
  - `first` (`Int`)
  - `after` (`String`)
- `customer` (`Customer`): The customer that the payment method belongs to.

## Used by

- [Customer](/braintree/graphql/reference/types/customer) — Object; defaultPaymentMethod
- [Node](/braintree/graphql/reference/types/node) — Interface; Possible type
- [PaymentMethodConnectionEdge](/braintree/graphql/reference/types/payment-method-connection-edge) — Object; node
- [PayPalTransactionPayload](/braintree/graphql/reference/types/pay-pal-transaction-payload) — Object; billingAgreementWithPurchasePaymentMethod
- [PerformThreeDSecureLookupPayload](/braintree/graphql/reference/types/perform-three-d-secure-lookup-payload) — Object; paymentMethod
- [Refund](/braintree/graphql/reference/types/refund) — Object; paymentMethod
- [RequestVaultInStoreContext](/braintree/graphql/reference/types/request-vault-in-store-context) — Object; paymentMethod
- [TokenizeApplePayCardPayload](/braintree/graphql/reference/types/tokenize-apple-pay-card-payload) — Object; paymentMethod
- [TokenizeCreditCardPayload](/braintree/graphql/reference/types/tokenize-credit-card-payload) — Object; paymentMethod, singleUseToken
- [TokenizeCustomActionsPaymentMethodPayload](/braintree/graphql/reference/types/tokenize-custom-actions-payment-method-payload) — Object; paymentMethod
- [TokenizeCvvPayload](/braintree/graphql/reference/types/tokenize-cvv-payload) — Object; singleUseToken
- [TokenizeEmvCardPayload](/braintree/graphql/reference/types/tokenize-emv-card-payload) — Object; paymentMethod
- [TokenizeMagstripeCardPayload](/braintree/graphql/reference/types/tokenize-magstripe-card-payload) — Object; paymentMethod
- [TokenizeNetworkTokenPayload](/braintree/graphql/reference/types/tokenize-network-token-payload) — Object; paymentMethod
- [TokenizePayPalBillingAgreementPayload](/braintree/graphql/reference/types/tokenize-pay-pal-billing-agreement-payload) — Object; paymentMethod
- [TokenizePayPalOneTimePaymentPayload](/braintree/graphql/reference/types/tokenize-pay-pal-one-time-payment-payload) — Object; paymentMethod
- [TokenizeSamsungPayCardPayload](/braintree/graphql/reference/types/tokenize-samsung-pay-card-payload) — Object; paymentMethod, singleUseToken
- [TokenizeUsBankAccountPayload](/braintree/graphql/reference/types/tokenize-us-bank-account-payload) — Object; paymentMethod
- [Transaction](/braintree/graphql/reference/types/transaction) — Object; paymentMethod
- [UpdateCreditCardBillingAddressPayload](/braintree/graphql/reference/types/update-credit-card-billing-address-payload) — Object; paymentMethod
- [UpdateCreditCardCardholderNamePayload](/braintree/graphql/reference/types/update-credit-card-cardholder-name-payload) — Object; paymentMethod
- [UpdateCreditCardExpirationDatePayload](/braintree/graphql/reference/types/update-credit-card-expiration-date-payload) — Object; paymentMethod
- [UpdatePayPalOneTimePaymentPayload](/braintree/graphql/reference/types/update-pay-pal-one-time-payment-payload) — Object; paymentMethod
- [VaultPaymentMethodPayload](/braintree/graphql/reference/types/vault-payment-method-payload) — Object; paymentMethod
- [VaultPayPalBillingAgreementPayload](/braintree/graphql/reference/types/vault-pay-pal-billing-agreement-payload) — Object; paymentMethod
- [Verification](/braintree/graphql/reference/types/verification) — Object; paymentMethod

## GraphQL definition

```graphql
type PaymentMethod implements Node {
  id: ID!
  legacyId: ID!
  usage: PaymentMethodUsage
  createdAt: Timestamp
  details: PaymentMethodDetails
  verifications(first: Int, after: String): VerificationConnection
  customer: Customer
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)