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

# Requery a payment

> Asks Orqex to re-check the payment with the underlying processor and reconcile the stored status. Use it for a payment that has not settled — it is a fallback, not a polling strategy.



## OpenAPI

````yaml /api-reference/openapi.json post /payment/intents/{paymentIntentId}/requery
openapi: 3.1.0
info:
  title: Orqex Orchestrate API
  version: 1.0.0
  description: >-
    The Orqex Orchestrate API for collecting payments and sending payouts.


    Authenticate with a secret key as a bearer token; the key also selects the
    environment. Amounts are in major units everywhere: `50` means 50.00. Writes
    accept an `X-Idempotency-Key` header. Lists are cursor-paginated.


    Which countries, currencies and payment methods are available depends on
    your project configuration: read them from the discovery endpoints at
    payment time, or look them up in your dashboard.
  contact:
    name: Orqex Orchestrate
    url: https://orqex.com
servers:
  - url: https://api.orqex.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Checkout
    description: Hosted checkout sessions.
  - name: Payment intents
    description: Payments, discovery and reconciliation.
  - name: Payment attempts
    description: Collecting a payment and confirming it.
  - name: Refunds
    description: Returning money to a payer.
  - name: Payouts
    description: Sending money out.
  - name: Utilities
    description: Exchange rates and method status.
paths:
  /payment/intents/{paymentIntentId}/requery:
    post:
      tags:
        - Payment intents
      summary: Requery a payment
      description: >-
        Asks Orqex to re-check the payment with the underlying processor and
        reconcile the stored status. Use it for a payment that has not settled —
        it is a fallback, not a polling strategy.
      operationId: requeryPaymentIntent
      parameters:
        - name: paymentIntentId
          in: path
          required: true
          description: The payment intent id.
          schema:
            type: string
        - name: X-Idempotency-Key
          in: header
          required: false
          description: >-
            Optional key, 8 to 128 characters, that makes this request safe to
            retry. The first response is stored for 24 hours; a repeat returns
            it unchanged with `X-Idempotent-Replayed: true`.
          schema:
            type: string
            minLength: 8
            maxLength: 128
      responses:
        '200':
          description: The requery result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  data:
                    $ref: '#/components/schemas/Requery'
        '401':
          description: Missing, invalid, inactive or expired API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The request address is not on the API key's allowlist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Resource not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded (100 requests per minute per key).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Requery:
      type: object
      properties:
        id:
          type: string
          example: rq_4Hs7Kn
        status:
          type:
            - string
            - 'null'
        payment_intent_id:
          type:
            - string
            - 'null'
        payment_attempt_id:
          type:
            - string
            - 'null'
        before:
          type: object
          properties:
            intent_status:
              type:
                - string
                - 'null'
            attempt_status:
              type:
                - string
                - 'null'
        after:
          type: object
          properties:
            intent_status:
              type:
                - string
                - 'null'
            attempt_status:
              type:
                - string
                - 'null'
        attempts:
          type: object
          properties:
            count:
              type: integer
            requeried:
              type: array
              items:
                type: object
                additionalProperties: true
        completed_at:
          type:
            - string
            - 'null'
          format: date-time
        created_at:
          type:
            - string
            - 'null'
          format: date-time
    Error:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your secret key, e.g. `sk_live_...` or `sk_sandbox_...`.

````