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

# Get a payment

> Retrieve details of a specific payment by ID.



## OpenAPI

````yaml /openapi/v0/openapi.json get /v0/payments/{id}
openapi: 3.0.0
info:
  title: Superbank API
  description: Superbank Developer API for Instant Settlement
  version: '1.0'
  contact: {}
servers:
  - url: https://api-sandbox.superbank.co
    description: Sandbox
security: []
tags: []
paths:
  /v0/payments/{id}:
    get:
      tags:
        - Payments
      summary: Get a payment
      description: Retrieve details of a specific payment by ID.
      operationId: PaymentsController_getPayment
      parameters:
        - name: id
          required: true
          in: path
          description: Payment ID
          schema:
            example: pay_abc123
            type: string
      responses:
        '200':
          description: Payment retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentResponseDto'
        '401':
          description: Unauthorized - invalid or missing API key
        '404':
          description: Payment not found
      security:
        - api-key: []
components:
  schemas:
    PaymentResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Payment ID
          example: d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a
        settlement_request_id:
          type: object
          description: Associated settlement request ID
          example: d4e5f6a7-b8c9-4d0e-a1f2-3b4c5d6e7f8a
          nullable: true
        type:
          type: string
          description: Payment type
          enum:
            - PAYOUT
            - PAYIN
          example: PAYOUT
        status:
          type: string
          description: Payment status
          enum:
            - AWAITING_FUNDS
            - PENDING
            - PROCESSING
            - SENT
            - COMPLETED
            - CANCELED
            - FAILED
            - EXPIRED
            - REFUNDED
            - SCHEDULED
            - UNDER_REVIEW
          example: COMPLETED
        fee:
          type: object
          description: Fee amount
          example: '0.50'
          nullable: true
        source:
          description: Source payment details
          allOf:
            - $ref: '#/components/schemas/PaymentSourceResponseDto'
        destination:
          description: Destination payment details
          allOf:
            - $ref: '#/components/schemas/PaymentDestinationResponseDto'
        metadata:
          type: object
          description: Custom metadata attached to the payment
          example:
            orderId: order-123
          nullable: true
        failure_reason:
          type: object
          description: Failure reason if payment failed
          example: Insufficient funds
          nullable: true
        created_at:
          type: string
          description: Payment creation timestamp
          example: '2026-01-20T15:20:00.000Z'
        updated_at:
          type: string
          description: Payment last update timestamp
          example: '2026-01-20T15:20:30.000Z'
        completed_at:
          type: object
          description: Payment completion timestamp
          example: '2026-01-20T15:20:30.000Z'
          nullable: true
      required:
        - id
        - type
        - status
        - source
        - destination
        - created_at
        - updated_at
    PaymentSourceResponseDto:
      type: object
      properties:
        amount:
          type: string
          description: Source amount
          example: '100.00'
        currency:
          type: string
          description: Source currency code
          example: USDC
        rail:
          type: string
          description: Source blockchain network
          example: SOLANA
        wallet_address:
          type: object
          description: Source wallet address
          example: 8yLMnPq3RS8uvwXM2j0KUr2eZpHcVmN4tRfuGxHyW92V
          nullable: true
        transaction_hash:
          type: object
          description: Source transaction hash
          example: 5wHu1qwD7q4bJCRrA...
          nullable: true
      required:
        - amount
        - currency
        - rail
    PaymentDestinationResponseDto:
      type: object
      properties:
        amount:
          type: string
          description: Destination amount
          example: '100.00'
        currency:
          type: string
          description: Destination currency code
          example: USDC
        rail:
          type: string
          description: Destination blockchain network
          example: SOLANA
        wallet_address:
          type: object
          description: Destination wallet address
          example: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
          nullable: true
        transaction_hash:
          type: object
          description: Destination transaction hash
          example: 5wHu1qwD7q4bJCRrA...
          nullable: true
      required:
        - amount
        - currency
        - rail
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-Api-Key

````