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

# Check Real-time Payment & Confirmation Status

> Verifies real-time status, paid timestamp, payment method, block confirmations, transaction hash, and return URL status.



## OpenAPI

````yaml /api-reference/openapi/api-store.json get /api/api-store/v1/payment-links/check
openapi: 3.0.3
info:
  title: PapelShip API Gateway
  description: >-
    Official API reference for PapelShip API Store integrations, hosted payment
    links, direct crypto deposit invoices, real-time blockchain status checks,
    and HMAC webhooks.
  version: 1.0.0
  contact:
    name: PapelShip Support
    url: https://app.papelship.com
    email: support@papelship.com
servers:
  - url: https://app.papelship.com
    description: Production API Server
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: Payment Links
    description: Hosted payment link generation supporting Credit Card, Papara, and Crypto
  - name: Crypto Invoice
    description: Direct cryptocurrency deposit invoice generation with HD wallet derivation
  - name: Payment Status
    description: Real-time payment status and blockchain confirmation check API
  - name: Orders
    description: V1 store order creation API
  - name: Refunds
    description: Invoice refund processing API
paths:
  /api/api-store/v1/payment-links/check:
    get:
      tags:
        - Payment Status
      summary: Check Real-time Payment & Confirmation Status
      description: >-
        Verifies real-time status, paid timestamp, payment method, block
        confirmations, transaction hash, and return URL status.
      operationId: checkPaymentStatus
      parameters:
        - name: invoiceId
          in: query
          required: true
          description: The unique invoice ID string
          schema:
            type: string
            example: aB9xK12Lp9012345678901234
      responses:
        '200':
          description: Real-time payment status and blockchain confirmation details
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  payment:
                    type: object
                    properties:
                      invoice_id:
                        type: string
                        example: aB9xK12Lp9012345678901234
                      status:
                        type: string
                        example: paid
                      is_paid:
                        type: boolean
                        example: true
                      amount:
                        type: number
                        example: 49.99
                      currency:
                        type: string
                        example: USD
                      payment_method:
                        type: string
                        example: crypto_ltc
                      customer_email:
                        type: string
                        example: buyer@example.com
                      redirect_url:
                        type: string
                        example: https://yourdomain.com/checkout/success
                      paid_at:
                        type: string
                        format: date-time
                        example: '2026-08-08T02:15:00.000Z'
                      created_at:
                        type: string
                        format: date-time
                        example: '2026-08-08T02:10:00.000Z'
                      expires_at:
                        type: string
                        format: date-time
                        example: '2026-08-09T02:10:00.000Z'
                      crypto_details:
                        type: object
                        properties:
                          coin:
                            type: string
                            example: LTC
                          network:
                            type: string
                            example: LTC MAINNET
                          address:
                            type: string
                            example: Ltc1q99a812bf00192837410293847561928374
                          crypto_amount:
                            type: number
                            example: 0.584795
                          confirmations:
                            type: integer
                            example: 2
                          required_confirmations:
                            type: integer
                            example: 2
                          tx_hash:
                            type: string
                            example: a1075db55d416d3ca199f55b603e87854619
        '404':
          description: Invoice Not Found
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API-Key
      description: 'Pass your secret API key formatted as: `Authorization: Bearer psa_...`'
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Alternative header format: `X-API-Key: psa_...`'

````