> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Desbloquear una transferencia Pix > Usa este endpoint para desbloquear una transferencia que quedó atascada en estado PROCESSING. El plugin obtiene el estado actual de BTG y activa la liquidación si la transacción ya se completó o falló en BTG. ## OpenAPI ````yaml es/openapi/v3-current/indirect-pix.yaml POST /v1/transfers/{transfer_id}/unblock openapi: 3.0.3 info: title: Plugin BR Pix Indirect - API completa description: | API completa para el sistema de pagos instantáneos Pix de Brasil, que incluye operaciones del diccionario de claves Pix, generación/decodificación de códigos QR, transacciones y límites transaccionales. version: 1.0.0 servers: - url: https://plugin-pix-indirect.api.lerian.net security: - bearerAuth: [] paths: /v1/transfers/{transfer_id}/unblock: post: tags: - Transactions API summary: Desbloquear una transferencia Pix description: >- Usa este endpoint para desbloquear una transferencia que quedó atascada en estado PROCESSING. El plugin obtiene el estado actual de BTG y activa la liquidación si la transacción ya se completó o falló en BTG. parameters: - $ref: '#/components/parameters/TransferId' - $ref: '#/components/parameters/XAccountId' requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/UnblockTransferInput' example: allowNotFoundUnblock: false responses: '200': description: Desbloqueo de la transferencia procesado correctamente. content: application/json: schema: $ref: '#/components/schemas/UnblockTransferOutput' '400': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0001: $ref: '#/components/examples/ErrorPIX0001' ErrorPIX0008: $ref: '#/components/examples/ErrorPIX0008' '404': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0426: $ref: '#/components/examples/ErrorPIX0426' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0000: $ref: '#/components/examples/ErrorPIX0000' '502': description: Bad Gateway content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX1000: $ref: '#/components/examples/ErrorPIX1000' deprecated: false security: - bearerAuth: [] components: parameters: TransferId: name: transfer_id in: path description: Identificador único de la transferencia Pix (formato UUID). required: true example: 019c96a0-0c21-71f9-a487-66a1258278a1 schema: type: string XAccountId: name: X-Account-Id in: header description: Identificador único de la cuenta del Ledger de Midaz (formato UUID). required: true example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string schemas: UnblockTransferInput: type: object properties: allowNotFoundUnblock: type: boolean default: false description: >- Habilita la vía de resolución de no encontrado. Cuando es true y BTG devuelve HTTP 404 para el EndToEndID de la transferencia, el flujo de desbloqueo revierte la retención de Midaz (si la hubiera) y marca el cash-out como FAILED con failedReason=BTG_NOT_FOUND en lugar de devolver un error del proveedor. Solo se aplica a transferencias CASHOUT en estado PENDING o PROCESSING. UnblockTransferOutput: type: object required: - transfer properties: btgStatus: type: string description: Estado recuperado de BTG (por transparencia). example: CONFIRMED message: type: string description: Contexto adicional sobre el resultado del desbloqueo. example: Transaction successfully unblocked and completed transfer: $ref: '#/components/schemas/TransferObject' ErrorFormat: type: object description: El mensaje de error de la respuesta. required: - code - title - message properties: code: type: string description: Un identificador único y estable para el error. title: type: string description: Un breve resumen del problema. message: type: string description: Orientación detallada para resolver el error. TransferObject: type: object properties: id: type: string description: Identificador único de la transferencia. example: 019c96a0-0c21-71f9-a487-66a1258278a1 endToEndId: type: string description: Identificador de extremo a extremo. example: E123456789BR1234567890123456789 amount: type: string description: Monto de la transferencia. example: '100.00' status: type: string description: Estado de la transferencia. enum: - PENDING - PROCESSING - COMPLETED - FAILED - CANCELLED example: COMPLETED type: type: string description: Tipo de transferencia. enum: - CASHOUT - CASHIN example: CASHOUT createdAt: type: string format: date-time example: '2024-01-15T10:30:00Z' updatedAt: type: string format: date-time example: '2024-01-15T10:30:00Z' examples: ErrorPIX0001: summary: Missing Headers in Request value: code: PIX-0001 title: Missing Headers in Request message: >- Your request is missing one or more required header params. Please refer to the documentation to ensure all necessary header params are included in your request. ErrorPIX0008: summary: Invalid Path Parameter in Request value: code: PIX-0008 title: Invalid Path Parameter in Request message: >- One or more path parameters are invalid. Please refer to the documentation to verify the expected format and allowed values for each path parameter. ErrorPIX0426: summary: Transfer Not Found value: code: PIX-0426 title: Transfer Not Found message: The transfer was not found. ErrorPIX0000: summary: Internal Server Error value: code: PIX-0000 title: Internal Server Error message: The server encountered an unexpected error. Please try again later. ErrorPIX1000: summary: Provider Connection Error value: code: PIX-1000 title: Provider Connection Error message: Failed to connect to provider. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````