> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revolv3.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Payment Method

> Retrieves details about a **specific stored payment method**, using its unique identifier.
The response includes type (e.g., credit card, ACH), masked account details, expiration, and billing address.

This endpoint is commonly used to display payment method information in the UI (e.g., "Visa ending in 1234"), or confirm method existence before charging.
Useful in both customer-facing portals and internal admin tools for billing management.



## OpenAPI

````yaml /api-reference/swagger.json get /api/PaymentMethod/{paymentMethodId}
openapi: 3.0.4
info:
  title: Revolv3 OpenApi Spec
  description: Spec for Revolv3
  version: 1.29.1
servers:
  - url: 'https://api-sandbox.revolv3.com '
security: []
paths:
  /api/PaymentMethod/{paymentMethodId}:
    get:
      tags:
        - PaymentMethod
      summary: Get Payment Method
      description: "Retrieves details about a **specific stored payment method**, using its unique identifier.\r\nThe response includes type (e.g., credit card, ACH), masked account details, expiration, and billing address.\r\n\r\nThis endpoint is commonly used to display payment method information in the UI (e.g., \"Visa ending in 1234\"), or confirm method existence before charging.\r\nUseful in both customer-facing portals and internal admin tools for billing management."
      parameters:
        - name: paymentMethodId
          in: path
          required: true
          schema:
            maximum: 1000000000
            minimum: 1
            type: integer
            format: int64
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/PaymentMethodDTO'
              example:
                paymentMethodId: 1
                billingAddressId: 1
                billingAddress:
                  addressId: 1
                  addressLine1: 123 Main
                  addressLine2: null
                  city: Santa Ana
                  state: CA
                  postalCode: '90000'
                  phoneNumber: null
                  email: null
                  country: US
                billingFirstName: John
                billingLastName: Smith
                merchantPaymentMethodRefId: payment-method-ref-id_hgays-213-4rf4
                paymentMethodAchDetails: null
                paymentMethodCreditCardDetails:
                  binNumber: '411111'
                  paymentLast4Digit: '1111'
                  paymentExpirationDate: '1025'
                  accountUpdateMessage: null
                  accountUpdateDateTime: null
                  accountUpdateCode: null
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentMethodDTO'
              example:
                paymentMethodId: 1
                billingAddressId: 1
                billingAddress:
                  addressId: 1
                  addressLine1: 123 Main
                  addressLine2: null
                  city: Santa Ana
                  state: CA
                  postalCode: '90000'
                  phoneNumber: null
                  email: null
                  country: US
                billingFirstName: John
                billingLastName: Smith
                merchantPaymentMethodRefId: payment-method-ref-id_hgays-213-4rf4
                paymentMethodAchDetails: null
                paymentMethodCreditCardDetails:
                  binNumber: '411111'
                  paymentLast4Digit: '1111'
                  paymentExpirationDate: '1025'
                  accountUpdateMessage: null
                  accountUpdateDateTime: null
                  accountUpdateCode: null
            text/json:
              schema:
                $ref: '#/components/schemas/PaymentMethodDTO'
              example:
                paymentMethodId: 1
                billingAddressId: 1
                billingAddress:
                  addressId: 1
                  addressLine1: 123 Main
                  addressLine2: null
                  city: Santa Ana
                  state: CA
                  postalCode: '90000'
                  phoneNumber: null
                  email: null
                  country: US
                billingFirstName: John
                billingLastName: Smith
                merchantPaymentMethodRefId: payment-method-ref-id_hgays-213-4rf4
                paymentMethodAchDetails: null
                paymentMethodCreditCardDetails:
                  binNumber: '411111'
                  paymentLast4Digit: '1111'
                  paymentExpirationDate: '1025'
                  accountUpdateMessage: null
                  accountUpdateDateTime: null
                  accountUpdateCode: null
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Attempted to perform an unauthorized operation.
            application/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Attempted to perform an unauthorized operation.
            text/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Attempted to perform an unauthorized operation.
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Unable to find an entity with the provided data.
            application/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Unable to find an entity with the provided data.
            text/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                message: Unable to find an entity with the provided data.
      security:
        - Bearer: []
components:
  schemas:
    PaymentMethodDTO:
      type: object
      properties:
        paymentMethodId:
          maximum: 1000000000
          minimum: 1
          type: integer
          description: The unique identifier for the payment method information.
          format: int64
        billingAddressId:
          maximum: 1000000000
          minimum: 1
          type: integer
          description: The unique identifier of the address.
          format: int64
        billingAddress:
          $ref: '#/components/schemas/AddressDTO'
        billingFirstName:
          maxLength: 100
          minLength: 0
          type: string
          nullable: true
        billingLastName:
          maxLength: 100
          minLength: 0
          type: string
          nullable: true
        merchantPaymentMethodRefId:
          maxLength: 100
          minLength: 0
          type: string
          description: Merchant's unique identifier for the payment method.
        paymentMethodAchDetails:
          allOf:
            - $ref: '#/components/schemas/AchViewDTO'
          description: ACH account information.
        paymentMethodCreditCardDetails:
          allOf:
            - $ref: '#/components/schemas/CreditCardViewDTO'
          description: The details of credit card payment method.
      additionalProperties: false
    StatusMessageResponse:
      type: object
      properties:
        message:
          type: string
          nullable: true
        errors:
          type: array
          items:
            type: string
          nullable: true
        fluentValidatorErrors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationFailure'
          nullable: true
      additionalProperties: false
    AddressDTO:
      type: object
      properties:
        addressId:
          type: integer
          description: The unique identifier of the address.
          format: int64
        addressLine1:
          maxLength: 40
          minLength: 2
          type: string
          description: Address.
          nullable: true
        addressLine2:
          maxLength: 40
          minLength: 0
          type: string
          description: Supplemental information for the address.
        city:
          maxLength: 25
          minLength: 2
          type: string
          description: City.
          nullable: true
        state:
          maxLength: 2
          minLength: 2
          type: string
          description: Two-letter state abbreviation.
          nullable: true
        postalCode:
          maxLength: 20
          minLength: 2
          type: string
          description: Postal Code.
          nullable: true
        phoneNumber:
          maxLength: 20
          minLength: 0
          type: string
          description: >-
            The phone number associated with a payment method that is used for
            billing purposes.
        email:
          maxLength: 100
          minLength: 0
          type: string
          description: The email associated with a billing address.
          format: email
        country:
          maxLength: 2
          minLength: 2
          type: string
          description: Country.
          nullable: true
      additionalProperties: false
    AchViewDTO:
      type: object
      properties:
        accountNumberLast4Digits:
          maxLength: 4
          minLength: 4
          pattern: ^\d{4}$
          type: string
          description: Last 4 digits of the bank account.
        accountNumberLength:
          maximum: 17
          minimum: 4
          type: integer
          description: Bank account number length.
          format: int32
        accountType:
          maxLength: 8
          minLength: 0
          pattern: ^(Checking|Savings)$
          type: string
          description: "**Conditional**: the account type is required if the ACH payment method type is supplied in the request.\r\n\r\nBank account type. Allowed values: Checking, Savings. Case-insensitive."
      additionalProperties: false
      nullable: true
    CreditCardViewDTO:
      type: object
      properties:
        binNumber:
          maxLength: 6
          minLength: 0
          pattern: ^\d{1,6}$
          type: string
          description: First 6 digits (BIN) of the card number.
        paymentLast4Digit:
          maxLength: 4
          minLength: 4
          pattern: ^\d{4}$
          type: string
          description: Payment card last 4 digits.
        paymentExpirationDate:
          maxLength: 4
          minLength: 0
          type: string
          description: The card expiration date.
          format: MMYY
          nullable: true
        accountUpdateMessage:
          maxLength: 500
          minLength: 0
          type: string
          description: Account updater message, if available.
        accountUpdateDateTime:
          maxLength: 20
          minLength: 0
          type: string
          description: UTC date-time of the last account updater event.
          format: YYYY-MM-DDThh:mm:ss
          nullable: true
        accountUpdateCode:
          maxLength: 50
          minLength: 0
          type: string
          description: Processor response code of the last account updater event.
      additionalProperties: false
      nullable: true
    ValidationFailure:
      type: object
      properties:
        propertyName:
          type: string
          nullable: true
        errorMessage:
          type: string
          nullable: true
        attemptedValue:
          nullable: true
        customState:
          nullable: true
        severity:
          $ref: '#/components/schemas/Severity'
        errorCode:
          type: string
          nullable: true
        formattedMessagePlaceholderValues:
          type: object
          additionalProperties:
            nullable: true
          nullable: true
      additionalProperties: false
    Severity:
      enum:
        - Error
        - Warning
        - Info
      type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````