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

# Actualiza la transferencia.

> TIN Cloud will call this endpoint when bank needs to sign the pending action. Depending on the key handling strategy it can use keys stored in the TIN Cloud or keys stored on local Key management system.



## OpenAPI

````yaml /public/spi-banksv3.yaml post /v1/action
openapi: 3.0.0
info:
  version: 1.0.1
  title: ACH TIN Bank Interface
servers:
  - url: https://bank.domain.com/v1
security: []
tags:
  - name: Credit
    description: Executes download on TIN Cloud side and credit on banking core
  - name: Debit
    description: Executes upload on TIN Cloud side and debit on banking core
  - name: Action
    description: Signs the operation
  - name: Status
    description: Notifies on status of operation
paths:
  /v1/action:
    post:
      tags:
        - Action
      summary: Actualiza la transferencia.
      description: >-
        TIN Cloud will call this endpoint when bank needs to sign the pending
        action. Depending on the key handling strategy it can use keys stored in
        the TIN Cloud or keys stored on local Key management system.
      operationId: signAction
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferUnsigned'
        required: true
      responses:
        '200':
          description: Action signed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferSigned'
        '400':
          description: Error signing the action
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
        - oAuth2ClientCredentials: []
        - XNonce: []
components:
  schemas:
    TransferUnsigned:
      type: object
      properties:
        source:
          type: string
        target:
          type: string
        symbol:
          type: string
        amount:
          type: string
        snapshot:
          type: object
          properties:
            source:
              type: object
              properties:
                wallet:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        type:
                          type: string
                        channelSms:
                          type: string
                signer:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        personType:
                          type: string
                        firstName:
                          type: string
                        lastName:
                          type: string
                        email:
                          type: string
                        mobile:
                          type: string
                        identification:
                          type: string
                        proprietary:
                          type: string
                        countryOfResidence:
                          type: string
                        bankAccountNumber:
                          type: string
                        bankAccountType:
                          type: string
                        bankBicfi:
                          type: string
                        bankName:
                          type: string
            target:
              type: object
              properties:
                wallet:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        type:
                          type: string
                        channelSms:
                          type: string
                signer:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        personType:
                          type: string
                        firstName:
                          type: string
                        lastName:
                          type: string
                        email:
                          type: string
                        mobile:
                          type: string
                        identification:
                          type: string
                        proprietary:
                          type: string
                        countryOfResidence:
                          type: string
                        bankAccountNumber:
                          type: string
                        bankAccountType:
                          type: string
                        bankBicfi:
                          type: string
                        bankName:
                          type: string
            symbol:
              type: object
              properties:
                wallet:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        type:
                          type: string
                signer:
                  type: object
                  properties:
                    handle:
                      type: string
        labels:
          type: object
          properties:
            tx_ref:
              type: string
            tx_id:
              type: string
            type:
              type: string
            description:
              type: string
            transactionPurpose:
              type: string
            sourceCreated:
              type: string
            targetUpdated:
              type: string
            created:
              type: string
            numberOfTransactions:
              type: string
        error:
          $ref: '#/components/schemas/NoError'
          type: object
        action_id:
          type: string
    TransferSigned:
      type: object
      properties:
        source:
          type: string
        target:
          type: string
        symbol:
          type: string
        amount:
          type: string
        snapshot:
          type: object
          properties:
            source:
              type: object
              properties:
                wallet:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        type:
                          type: string
                        channelSms:
                          type: string
                signer:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        personType:
                          type: string
                        firstName:
                          type: string
                        lastName:
                          type: string
                        email:
                          type: string
                        mobile:
                          type: string
                        identification:
                          type: string
                        proprietary:
                          type: string
                        countryOfResidence:
                          type: string
                        bankAccountNumber:
                          type: string
                        bankAccountType:
                          type: string
                        bankBicfi:
                          type: string
                        bankName:
                          type: string
            target:
              type: object
              properties:
                wallet:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        type:
                          type: string
                        channelSms:
                          type: string
                signer:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        personType:
                          type: string
                        firstName:
                          type: string
                        lastName:
                          type: string
                        email:
                          type: string
                        mobile:
                          type: string
                        identification:
                          type: string
                        proprietary:
                          type: string
                        countryOfResidence:
                          type: string
                        bankAccountNumber:
                          type: string
                        bankAccountType:
                          type: string
                        bankBicfi:
                          type: string
                        bankName:
                          type: string
            symbol:
              type: object
              properties:
                wallet:
                  type: object
                  properties:
                    handle:
                      type: string
                    labels:
                      type: object
                      properties:
                        type:
                          type: string
                signer:
                  type: object
                  properties:
                    handle:
                      type: string
        labels:
          type: object
          properties:
            tx_ref:
              type: string
            tx_id:
              type: string
            type:
              type: string
            description:
              type: string
            transactionPurpose:
              type: string
            sourceCreated:
              type: string
            targetUpdated:
              type: string
            created:
              type: string
            numberOfTransactions:
              type: string
            hash:
              type: string
        error:
          $ref: '#/components/schemas/NoError'
          type: object
        action_id:
          type: string
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ErrorGeneric'
          type: object
    NoError:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
    ErrorGeneric:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: API_KEY
    oAuth2ClientCredentials:
      type: oauth2
      description: Simple credentials
      flows:
        clientCredentials:
          tokenUrl: https://achtin-stg.minka.io/oauth/token
          scopes: {}

````