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

# Retry recurring initialization

> Retry recurring initialization through the dedicated SmartRetry retry operation.

Use this operation to create a new retry attempt for a previous
[recurring initialization](/docs/api-reference/recurring/init). Supply the originating SmartRetry
transaction reference rendered in the request body below.

<Note>
  This operation creates a dedicated retry attempt. It is different from replaying the original
  recurring initialization request with the same `Idempotency-Key`. See
  [Idempotency](/docs/api-reference/idempotency) for safe request replay.
</Note>


## OpenAPI

````yaml api-reference/openapi.json POST /v1/payments/recurring/init/retry/{terminal_friendly_id}
openapi: 3.0.3
info:
  title: SmartRetry Terminal API
  description: >-
    Payment gateway terminal service — Sale, Preauth, Capture, Refund, Void,
    Recurring, and Future transactions.
  version: 1.0.0
servers:
  - url: https://terminal.smartretry.com
security:
  - ApiKeyAuth: []
tags:
  - name: payments
    description: >-
      Direct payment operations — Sale, Preauth, Capture, Refund, Void, and
      Status.
  - name: recurring
    description: Recurring payment lifecycle — init, charge, update, cancel, and status.
  - name: future-transactions
    description: Future transaction management — charge, update, cancel, and status.
  - name: webhooks
    description: Inbound payment-provider webhook ingestion.
paths:
  /v1/payments/recurring/init/retry/{terminal_friendly_id}:
    post:
      tags:
        - recurring
      parameters:
        - schema:
            minLength: 6
            maxLength: 6
            type: string
          in: path
          name: terminal_friendly_id
          required: true
          description: The unique identifier of the terminal.
        - schema:
            maxLength: 255
            pattern: ^[\w-]+$
            type: string
          in: header
          name: idempotency-key
          required: false
          description: >-
            Optional idempotency key, scoped to terminal + matched route
            pattern. A replayed request returns the cached response with
            `Idempotency-Replayed: true`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectOriginRetryRequest'
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecurringAcceptedWithOrderResponse'
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    DirectOriginRetryRequest:
      additionalProperties: false
      type: object
      required:
        - retry
      properties:
        retry:
          $ref: '#/components/schemas/RetryFromOriginatingId'
    RecurringAcceptedWithOrderResponse:
      type: object
      required:
        - transaction_id
        - recurring_id
        - accepted
        - order_id
      properties:
        transaction_id:
          minLength: 8
          maxLength: 8
          type: string
        recurring_id:
          minLength: 8
          maxLength: 8
          type: string
        accepted:
          type: boolean
        order_id:
          minLength: 8
          maxLength: 8
          type: string
    ErrorResponse:
      type: object
      required:
        - type
        - title
        - status
        - detail
        - reason_code
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        instance:
          type: string
        reason_code:
          type: string
        context:
          type: object
          additionalProperties: {}
    RetryFromOriginatingId:
      additionalProperties: false
      type: object
      required:
        - originating_id
      properties:
        originating_id:
          description: SmartRetry transaction friendly_id of the originating attempt.
          minLength: 8
          maxLength: 8
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````