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

# Retrieve a payment

> Returns one payment or refund. Returns 404 if it is not on the account.



## OpenAPI

````yaml /autogenerated/openapi/roqqett.openapi.json get /roqqett/payments/{paymentId}
openapi: 3.1.0
info:
  title: Roqqett API
  version: 2.0.0
  description: Version 2
  license:
    name: UNLICENSED
    url: https://docs.equalsmoney.com
servers:
  - url: https://api.equalsmoney.com/v2
    description: Production
security: []
paths:
  /roqqett/payments/{paymentId}:
    get:
      tags:
        - Payments
      summary: Retrieve a payment
      description: Returns one payment or refund. Returns 404 if it is not on the account.
      operationId: findOnePayment
      parameters:
        - name: paymentId
          in: path
          required: true
          schema:
            type:
              - string
            format: uuid
            maxLength: 36
            description: The ID of a Roqqett payment or refund record.
            example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
        - name: accountId
          in: query
          schema:
            description: The ID of the account to work with.
            type:
              - string
            example: F50091
          required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  id:
                    type:
                      - string
                    format: uuid
                    maxLength: 36
                    description: The ID of a Roqqett payment or refund record.
                    example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                  type:
                    description: PAYMENT moves money from the payer; REFUND moves it back.
                    type:
                      - string
                    enum:
                      - PAYMENT
                      - REFUND
                    example: PAYMENT
                  status:
                    description: >-
                      PENDING from initiation until the bank confirms the
                      outcome.
                    type:
                      - string
                    enum:
                      - PENDING
                      - COMPLETED
                      - FAILED
                      - CANCELLED
                    example: COMPLETED
                  amount:
                    type:
                      - object
                    properties:
                      amount:
                        type:
                          - string
                        maxLength: 32
                        pattern: ^[0-9]+(\.[0-9]+)?$
                        description: >-
                          Decimal amount in major units, as a string. Never a
                          float.
                        example: '10000.00'
                      currencyCode:
                        type:
                          - string
                        enum:
                          - GBP
                          - EUR
                        description: >-
                          ISO-4217 code of a currency Roqqett can take payments
                          in: GBP over Faster Payments, EUR over SEPA Instant.
                        example: GBP
                    required:
                      - amount
                      - currencyCode
                    description: >-
                      A money value: a decimal amount as a string plus an
                      ISO-4217 currency code.
                  checkoutType:
                    type:
                      - string
                      - 'null'
                    enum:
                      - SHOPPING
                      - TOP_UP
                    description: >-
                      Whether the money was taken by a SHOPPING or a TOP_UP
                      checkout session. A REFUND takes the type of the payment
                      it refunds. `null` when the record has no checkout
                      session.
                    example: SHOPPING
                  checkoutSessionId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    maxLength: 36
                    description: 'The ID of a checkout session: one payment journey.'
                    example: 0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93
                  refundedPaymentId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    maxLength: 36
                    description: >-
                      The payment a REFUND returns money from. Always `null` for
                      a PAYMENT.
                    example: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                  refundId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    maxLength: 36
                    description: >-
                      The ID of the refund a REFUND record belongs to, for `GET
                      /v2/roqqett/refunds/{refundId}`. Always `null` for a
                      PAYMENT.
                    example: 4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45
                  orderId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    maxLength: 36
                    description: >-
                      The ID of an order: the record of a completed shopping
                      checkout session.
                    example: 7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78
                  merchantReference:
                    type:
                      - string
                      - 'null'
                    minLength: 1
                    maxLength: 128
                    description: >-
                      The merchant's own reference for this checkout session,
                      such as its order or basket ID. Shown to the merchant,
                      never to the payer's bank.
                    example: ORDER-10421
                  payer:
                    type:
                      - object
                    properties:
                      bankName:
                        type:
                          - string
                          - 'null'
                        maxLength: 140
                        description: Name of the payer's bank.
                        example: Example Bank
                    required:
                      - bankName
                  isRefundable:
                    type:
                      - boolean
                    description: Whether a refund can still be created for this payment.
                  initiatedAt:
                    type:
                      - string
                    format: date-time
                    description: When the payer authorised the payment.
                    example: '2026-10-02T12:00:00Z'
                  completedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: When the payment reached a terminal status.
                    example: '2026-10-02T12:00:05Z'
                  createdAt:
                    type:
                      - string
                    format: date-time
                    description: >-
                      The date the Resource was initially created. ISO 8601
                      format without milliseconds.
                required:
                  - id
                  - type
                  - status
                  - amount
                  - checkoutType
                  - checkoutSessionId
                  - refundedPaymentId
                  - refundId
                  - orderId
                  - merchantReference
                  - payer
                  - isRefundable
                  - initiatedAt
                  - completedAt
                  - createdAt
                example:
                  id: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                  type: PAYMENT
                  status: COMPLETED
                  amount:
                    amount: '10000.00'
                    currencyCode: GBP
                  checkoutType: SHOPPING
                  checkoutSessionId: 0b8e5c3a-2f1d-4c6b-8a9e-7d4f2c1b0a93
                  refundedPaymentId: 9c4e1a7b-3d2f-4b6a-8e5c-0f7d2a9b1c34
                  refundId: 4a7d2c9e-1b5f-4e3a-9c8d-6b0f1e2a7c45
                  orderId: 7e2b9d4a-6c1f-4a5e-8b3d-2f9c0a1e6b78
                  merchantReference: ORDER-10421
                  payer:
                    bankName: Example Bank
                  isRefundable: true
                  initiatedAt: '2026-10-02T12:00:00Z'
                  completedAt: '2026-10-02T12:00:05Z'
                  createdAt: '2019-08-24T14:15:22Z'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type:
                  - object
                properties:
                  message:
                    type:
                      - string
                    maxLength: 1024
                    description: Human-readable error description.
                    example: Checkout session not found.
                  errors:
                    type:
                      - array
                    items:
                      type:
                        - object
                      properties:
                        path:
                          type:
                            - string
                          description: The location of the bad parameter.
                        message:
                          type:
                            - string
                          description: Description of why the validation failed.
                        errorCode:
                          type:
                            - string
                          description: Where the error occurred.
                      required:
                        - path
                        - message
                      description: An object containing details about one particular error.
                required:
                  - message
                  - errors
                example:
                  message: Checkout session not found.
                  errors:
                    - path: string
                      message: string
                      errorCode: string
      security:
        - CommonAuth:
            - roqqett:transactions:read:any
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.equalsmoney.com/v2/roqqett/payments/{paymentId}?accountId={{accountId}}' \
              --header 'Authorization: <api-key>'
components:
  securitySchemes:
    CommonAuth:
      type: apiKey
      in: header
      name: Authorization

````