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

# Read a payment

> Returns the status/details of a payment request. Requires a **Pro** or **Paymint-only** license.



## OpenAPI

````yaml /api-reference/paymint/openapi.json post /paymint/read
openapi: 3.1.0
info:
  title: Magic Meal Kits — Paymint API
  version: 1.0.0
  description: >-
    Send and manage Paymint (결제선생) payment requests and AutoPay through your
    Magic Meal Kits server. Backs the **Paymint** Make.com app.


    **License:** the protected endpoints require a **Pro** or **Paymint-only**
    license — a Basic deployment gets `402` (upgrade required) before anything
    else runs. On top of that, the payment-sending calls (`request`, `resend`,
    `autopay/request`) draw down your Paymint balance (also `402` when the
    balance is insufficient).


    Auth: the MMK `X-API-KEY` plus your Paymint connection fields — set once on
    the connection page in the Magic Meal Kits app. Two modes: **MMK mode**
    (`X-Paymint-MMK-Mode: true`, optionally `X-Paymint-Member-ID` /
    `X-Paymint-Merchant-ID` to pick a license) or **traditional mode**
    (`X-Paymint-Host`, `X-Paymint-Api-Key`, `X-Paymint-Member-ID`,
    `X-Paymint-Merchant-ID`, `X-Paymint-Business-Number`).
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
  - url: https://{deployment}/api/v1
    description: Your Magic Meal Kits deployment
    variables:
      deployment:
        default: magic-meal-kits-xxxxx.run.app
        description: Your Cloud Run host (without protocol)
security:
  - ApiKeyAuth: []
    PaymintMMKMode: []
  - ApiKeyAuth: []
    PaymintHost: []
    PaymintApiKey: []
    PaymintMemberId: []
    PaymintMerchantId: []
    PaymintBusinessNumber: []
tags:
  - name: Payments
    description: Send and manage payment requests.
  - name: AutoPay
    description: Recurring/auto payment methods.
  - name: Utilities
    description: Public helpers (no auth).
paths:
  /paymint/read:
    post:
      tags:
        - Payments
      summary: Read a payment
      description: >-
        Returns the status/details of a payment request. Requires a **Pro** or
        **Paymint-only** license.
      operationId: paymintRead
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '200':
          description: Payment
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          $ref: '#/components/responses/BadRequest'
        '402':
          $ref: '#/components/responses/PaymentRequired'
components:
  responses:
    BadRequest:
      description: Invalid request or missing Paymint connection headers
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    PaymentRequired:
      description: >-
        License gate (Basic deployment — upgrade to Pro/Paymint-only) **or**
        insufficient Paymint balance for a paid action
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        error:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Your deployment's API key (MMK_API_KEY).
    PaymintMMKMode:
      type: apiKey
      in: header
      name: X-Paymint-MMK-Mode
      description: >-
        Set to `true` to use MMK mode (uses a license configured on your
        deployment). Set the Paymint connection fields on the connection page in
        the Magic Meal Kits app.
    PaymintHost:
      type: apiKey
      in: header
      name: X-Paymint-Host
      description: Traditional mode — Paymint host.
    PaymintApiKey:
      type: apiKey
      in: header
      name: X-Paymint-Api-Key
      description: Traditional mode — Paymint API key.
    PaymintMemberId:
      type: apiKey
      in: header
      name: X-Paymint-Member-ID
      description: Paymint member ID.
    PaymintMerchantId:
      type: apiKey
      in: header
      name: X-Paymint-Merchant-ID
      description: Paymint merchant ID.
    PaymintBusinessNumber:
      type: apiKey
      in: header
      name: X-Paymint-Business-Number
      description: Traditional mode — business registration number.

````