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

# Get payment settings

> Which payment methods are on, and their public settings. Secret keys are masked.

**Scope:** `payment:read`



## OpenAPI

````yaml GET /api/merchant/v1/stores/{storeId}/payments
openapi: 3.1.0
info:
  title: Join Markt Merchant API
  version: 1.0.0
  description: >-
    Manage your Join Markt store from your own code: products, orders,
    customers, coupons, themes and more.


    Create an API key in **Dashboard → Developers → API keys**, then send it as
    `Authorization: Bearer mk_live_…`. Each key only works on the stores and
    scopes you chose for it.


    Limits: 120 requests per minute per key. Every response is JSON.
  contact:
    name: Join Markt Support
    url: https://joinmarkt.com/contact
servers:
  - url: https://dash.joinmarkt.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Store
    description: Store profile and settings.
  - name: Products
    description: Create, update and delete products, and manage license-key stock.
  - name: Categories
    description: Group products into categories.
  - name: Groups
    description: Bundle several products under one storefront card.
  - name: Orders
    description: Read orders, add notes and mark manual deliveries done.
  - name: Invoices
    description: Read invoices issued for orders.
  - name: Customers
    description: Read customers and adjust their store balance.
  - name: Coupons
    description: Create and manage discount codes.
  - name: Reviews
    description: Read buyer reviews and reply to them.
  - name: Tickets
    description: Support tickets from buyers.
  - name: Analytics
    description: Revenue and traffic numbers.
  - name: Balance & payouts
    description: Seller balance and payout requests.
  - name: Payments
    description: Payment method settings. Secrets are never returned.
  - name: Storefront
    description: Storefront appearance and integrations.
  - name: Themes
    description: Apply catalog themes and edit theme projects.
  - name: Domain
    description: Connect a custom domain.
  - name: Security
    description: Blacklist and anti-fraud settings.
  - name: Notifications
    description: Recent store notifications.
  - name: Discord
    description: Discord bot settings.
  - name: Import
    description: Import products and customers from another platform.
  - name: Webhooks
    description: Get events sent to your own server.
paths:
  /api/merchant/v1/stores/{storeId}/payments:
    get:
      tags:
        - Payments
      summary: Get payment settings
      description: >-
        Which payment methods are on, and their public settings. Secret keys are
        masked.


        **Scope:** `payment:read`
      operationId: getPayments
      parameters:
        - $ref: '#/components/parameters/storeId'
      responses:
        '200':
          description: The payment settings.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                id: cmvuo0akc0002vdesum2w5xa1
                name: BADE
                ownerAccountEmail: buyer@example.com
                stripeEnabled: false
                stripeSecretKey: null
                stripePublishableKey: null
                stripeEmbeddedForm: false
                stripeCurrencyConversion: false
                stripeAllowedCurrencies: null
                stripeShowTos: false
                stripeTosText: null
                stripeBillingAddressCollection: false
                stripeAutomaticTax: false
                stripeWebhookSecret: null
                stripeAccountId: null
                cryptomusEnabled: false
                cryptomusEnabledCurrencies: null
                cryptomusCommissionPayer: seller
                nowpaymentsEnabled: false
                nowpaymentsEnabledCurrencies: null
                nowpaymentsCommissionPayer: seller
                joinMarktCryptoEnabled: false
                joinMarktCryptoEnabledCurrencies: null
                joinMarktCryptoCommissionPercentage: null
                joinMarktCryptoCommissionPayer: seller
                joinMarktCryptoPayoutEnabled: false
                joinMarktCryptoPayoutEmail: buyer@example.com
                joinMarktCryptoPayoutWallets: null
                paypalEnabled: false
                paypalIntegrationType: rest
                paypalEmail: null
                paypalClientId: null
                paypalClientSecret: null
                paypalWebhookId: null
                paypalSandbox: true
                paypalCardsOnly: false
                paypalCollectShipping: false
                mollieEnabled: false
                mollieApiKey: null
                squareEnabled: false
                squareAccessToken: null
                squareLocationId: null
                squareWebhookSignatureKey: null
                squareSandbox: true
                sumupEnabled: false
                sumupApiKey: null
                sumupMerchantCode: null
                revolutEnabled: false
                revolutApiSecret: null
                revolutWebhookSecret: null
                revolutSandbox: true
                authorizenetEnabled: false
                authorizenetApiLoginId: null
                authorizenetTransactionKey: null
                authorizenetSignatureKey: null
                authorizenetSandbox: true
                skrillEnabled: false
                skrillMerchantEmail: null
                skrillApiMqiPassword: null
                skrillSecretWord: null
                freekassaEnabled: false
                freekassaShopId: null
                freekassaSecretWord1: null
                freekassaSecretWord2: null
                freekassaApiKey: null
                misticpayEnabled: false
                misticpayClientId: null
                misticpayClientSecret: null
                rewarbleEnabled: false
                rewarbleApiKey: null
                rewarbleTestMode: true
                paypalFfEnabled: false
                paypalFfEmail: null
                paypalFfAccountInfo: null
                paypalFfUnderpayPercent: 5
                paypalFfNotes: null
                venmoFfEnabled: false
                venmoFfTag: null
                venmoFfEmail: null
                venmoFfAccountInfo: null
                venmoFfUnderpayPercent: 5
                venmoFfNotes: null
                cashAppEnabled: false
                cashAppCashtag: null
                cashAppEmail: null
                cashAppUnderpayPercent: 5
                cashAppNotes: null
                shopifyEnabled: false
                shopifyShopDomain: null
                shopifyClientId: null
                shopifyClientSecret: null
                shopifyWebhookSecret: null
                shopifyCurrency: null
                adyenEnabled: false
                adyenApiKey: null
                adyenMerchantAccount: null
                adyenWebhookHmacKey: null
                adyenLiveUrlPrefix: null
                adyenSandbox: true
                lemonSqueezyEnabled: false
                lemonSqueezyApiKey: null
                lemonSqueezyStoreId: null
                lemonSqueezyVariantId: null
                lemonSqueezyWebhookSecret: null
                whopEnabled: false
                whopApiKey: null
                whopCompanyId: null
                whopWebhookSecret: null
                whopSandbox: true
                overpayEnabled: false
                overpayShopId: null
                overpayPublicKey: null
                overpaySecretKey: null
                overpayTestMode: true
                paymongoEnabled: false
                paymongoSecretKey: null
                paymongoWebhookSecret: null
                paymongoPaymentMethodTypes:
                  - card
                  - gcash
                paymongoPassOnFees: false
                paymongoSendEmailReceipt: true
                dodoEnabled: false
                dodoApiKey: null
                dodoWebhookSecret: null
                dodoProductId: null
                dodoCheckoutMode: redirect
                dodoPricesIncludeTax: true
                dodoTestMode: true
                pandabaseEnabled: false
                pandabaseApiKey: null
                pandabaseStoreId: null
                pandabaseWebhookSecret: null
                moneymotionEnabled: false
                moneymotionApiKey: null
                moneymotionWebhookSecret: null
                moneymotionTestMode: true
                amazonPsEnabled: false
                amazonPsMerchantIdentifier: null
                amazonPsAccessCode: null
                amazonPsShaRequestPhrase: null
                amazonPsShaResponsePhrase: null
                amazonPsCurrency: null
                amazonPsSandbox: true
                paymentOptionsConfig:
                  methods: {}
                  allowBalanceTopUps: false
                  minimumOrderAmount: null
                  customerBalanceEnabled: false
                  passGatewayFeesToCustomer: false
                paymentNotesConfig: null
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >-
            curl -X GET
            "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/payments"
            \
              -H "Authorization: Bearer $JOIN_MARKT_API_KEY"
        - lang: javascript
          label: JavaScript
          source: >-
            const res = await
            fetch("https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/payments",
            {
              method: "GET",
              headers: {
                Authorization: `Bearer ${process.env.JOIN_MARKT_API_KEY}`,
              },
            })

            const data = await res.json()
        - lang: python
          label: Python
          source: |-
            import os, requests

            res = requests.get(
                "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/payments",
                headers={"Authorization": f"Bearer {os.environ['JOIN_MARKT_API_KEY']}"},
            )
            data = res.json()
components:
  parameters:
    storeId:
      name: storeId
      in: path
      required: true
      description: >-
        Your store id. Find it in Dashboard → Developers, or in `GET /stores`
        with MCP.
      schema:
        type: string
  responses:
    BadRequest:
      description: The request body or a parameter is not valid. `error` names the field.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: The API key is missing, wrong, expired or revoked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The key is valid but has no access to this store, or lacks the scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: More than 120 requests in a minute. Wait and try again.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: What went wrong, in plain words.
          examples:
            - Product not found
        code:
          type: string
          description: Stable error code.
          examples:
            - NOT_FOUND
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: mk_live_…
      description: Your Merchant API key. Create one in Dashboard → Developers → API keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.