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

# Get a payment instruction

> The current active instruction for a payout: where to settle, the exact amount, and the expiry. Returns 404 until the generation job has run.



## OpenAPI

````yaml /openapi.json get /v1/payouts/{payout_id}/payment-instruction
openapi: 3.0.0
info:
  title: Spendin Merchant API
  description: Cross-border remittance and financial services API
  version: '1.0'
  contact: {}
servers:
  - url: https://api.spendin.app
    description: Production
security:
  - api-key: []
tags: []
paths:
  /v1/payouts/{payout_id}/payment-instruction:
    get:
      tags:
        - payment-instructions
      summary: Get a payment instruction
      description: >-
        The current active instruction for a payout: where to settle, the exact
        amount, and the expiry. Returns 404 until the generation job has run.
      operationId: PaymentInstructionsController_getActiveInstruction
      parameters:
        - name: payout_id
          required: true
          in: path
          schema:
            format: uuid
            type: string
      responses:
        '200':
          description: Active instruction
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentInstructionResponseDto'
        '404':
          description: No active instruction for this payout yet
      security:
        - api-key: []
components:
  schemas:
    PaymentInstructionResponseDto:
      type: object
      properties:
        id:
          type: string
          example: b7e2f1a0-...
        payout_id:
          type: string
          example: a1b2c3d4-...
        rail:
          type: string
          enum:
            - CRYPTO
            - BANK_TRANSFER
          example: CRYPTO
        account_unique:
          type: string
          example: TXyz1234...abc
          description: >-
            Crypto address (CRYPTO) or virtual account number (BANK_TRANSFER)
            the merchant settles to
        provider_name:
          type: string
          example: USDT (TRC-20)
        network:
          type: object
          example: TRC20
          nullable: true
        expected_amount:
          type: number
          example: 42.32
          description: Amount the merchant must send
        expected_currency:
          type: string
          example: USDT
        payment_status:
          type: string
          enum:
            - UNPAID
            - PAID
            - EXPIRED
          example: UNPAID
        expires_at:
          type: string
          example: '2026-07-20T10:11:00.000Z'
        paid_at:
          type: object
          example: null
          nullable: true
        created_at:
          type: string
          example: '2026-07-20T09:41:00.000Z'
      required:
        - id
        - payout_id
        - rail
        - account_unique
        - provider_name
        - network
        - expected_amount
        - expected_currency
        - payment_status
        - expires_at
        - paid_at
        - created_at
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key

````