> ## 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. # Procesar una transferencia Pix > Usa este endpoint para procesar un cash-out Pix iniciado previamente y mover fondos entre cuentas. ## OpenAPI ````yaml es/openapi/v3-current/indirect-pix.yaml POST /v1/transfers/cashout/process 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/cashout/process: post: tags: - Transactions API summary: Procesar una transferencia Pix description: |- Usa este endpoint para procesar un cash-out Pix iniciado previamente y mover fondos entre cuentas. parameters: - $ref: '#/components/parameters/XAccountId' - $ref: '#/components/parameters/XPurpose' - $ref: '#/components/parameters/XIdempotency' - $ref: '#/components/parameters/XTTL' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProcessTransferInput' example: initiationId: 019c96a0-0c82-7c3d-8dcc-c180868b45c4 responses: '201': description: >- Transferencia Pix procesada correctamente. La respuesta incluye el encabezado `X-Idempotency-Replayed`. Si el valor es false, la transacción se acaba de procesar. Si el valor es true, la respuesta es una repetición de una solicitud procesada anteriormente. Consulta [Reintentos e idempotencia](/en/reference/retries-idempotency) para obtener más detalles. headers: X-Idempotency-Replayed: $ref: '#/components/headers/XIdempotencyReplayed' content: application/json: schema: $ref: '#/components/schemas/TransferObject' '400': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0001: $ref: '#/components/examples/ErrorPIX0001' ErrorPIX0003: $ref: '#/components/examples/ErrorPIX0003' ErrorPIX0004: $ref: '#/components/examples/ErrorPIX0004' ErrorPIX0404: $ref: '#/components/examples/ErrorPIX0404' ErrorPIX0422: $ref: '#/components/examples/ErrorPIX0422' ErrorPIX0424: $ref: '#/components/examples/ErrorPIX0424' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0431: $ref: '#/components/examples/ErrorPIX0431' ErrorPIX0601: $ref: '#/components/examples/ErrorPIX0601' '404': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0410: $ref: '#/components/examples/ErrorPIX0410' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0412: $ref: '#/components/examples/ErrorPIX0412' ErrorPIX0423: $ref: '#/components/examples/ErrorPIX0423' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0411: $ref: '#/components/examples/ErrorPIX0411' ErrorPIX0413: $ref: '#/components/examples/ErrorPIX0413' ErrorPIX0421: $ref: '#/components/examples/ErrorPIX0421' ErrorPIX0470: $ref: '#/components/examples/ErrorPIX0470' ErrorPIX0471: $ref: '#/components/examples/ErrorPIX0471' ErrorPIX0600: $ref: '#/components/examples/ErrorPIX0600' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX0000: $ref: '#/components/examples/ErrorPIX0000' ErrorPIX0602: $ref: '#/components/examples/ErrorPIX0602' '502': description: Bad Gateway content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: ErrorPIX1000: $ref: '#/components/examples/ErrorPIX1000' ErrorPIX1007: $ref: '#/components/examples/ErrorPIX1007' ErrorPIX1099: $ref: '#/components/examples/ErrorPIX1099' deprecated: false security: - bearerAuth: [] components: parameters: 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 XPurpose: name: X-Purpose in: header description: >- Propósito de la transacción para el cash-out. Su valor predeterminado es TRANSFER cuando se omite. required: false example: TRANSFER schema: type: string default: TRANSFER enum: - TRANSFER - CHANGE - WITHDRAWAL - REFUND_AUTOMATIC_PIX - INSTANT_PAYMENT_REFUND - INSTALLMENT_PIX XIdempotency: name: X-Idempotency in: header description: >- Clave de idempotencia opcional para reintentos seguros. Reutiliza el mismo valor solo cuando reintentas la misma operación tras un resultado desconocido. Consulta [Reintentos e idempotencia](/en/reference/retries-idempotency) para más detalles. required: false schema: type: string XTTL: name: X-TTL in: header description: >- Tiempo de vida en segundos para la caché de la clave de idempotencia. Define cuánto tiempo el sistema recuerda una solicitud procesada. Consulta [Reintentos e idempotencia](/en/reference/retries-idempotency) para más detalles. required: false schema: type: integer schemas: ProcessTransferInput: type: object required: - initiationId properties: initiationId: type: string description: ID de inicio obtenido en el paso de inicio. example: 019c96a0-0c82-7c3d-8dcc-c180868b45c4 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' 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. headers: XIdempotencyReplayed: description: >- Este encabezado solo está presente cuando la respuesta es una repetición en caché de una solicitud procesada anteriormente. Si el encabezado está ausente, la solicitud se procesó como nueva. Verifica siempre la presencia de este encabezado para evitar procesar la misma operación dos veces por tu lado. Consulta [Reintentos e idempotencia](/en/reference/retries-idempotency) para más detalles. schema: type: boolean example: false 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. ErrorPIX0003: summary: Missing Fields in Request value: code: PIX-0003 title: Missing Fields in Request message: >- Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request. ErrorPIX0004: summary: Invalid Field Values in Request value: code: PIX-0004 title: Invalid Field Values in Request message: >- Your request contains one or more fields with invalid values. Please refer to the documentation to verify that all fields have the correct values. ErrorPIX0404: summary: Invalid UUID Format value: code: PIX-0404 title: Invalid UUID Format message: The UUID format is invalid. ErrorPIX0422: summary: Amount Mismatch value: code: PIX-0422 title: Amount Mismatch message: The amount does not match the fixed amount from QR code. ErrorPIX0424: summary: Invalid Amount Value value: code: PIX-0424 title: Invalid Amount Value message: The amount must be greater than zero. ErrorPIX0431: summary: Account Blocked value: code: PIX-0431 title: Account Blocked message: The account is blocked and cannot perform transactions. ErrorPIX0601: summary: Midaz Account Blocked value: code: PIX-0601 title: Midaz Account Blocked message: The account is blocked and cannot perform transactions. ErrorPIX0410: summary: Initiation Not Found value: code: PIX-0410 title: Initiation Not Found message: The payment initiation was not found. ErrorPIX0412: summary: Initiation Already Used value: code: PIX-0412 title: Initiation Already Used message: The payment initiation has already been processed. ErrorPIX0423: summary: Duplicate End-to-End ID value: code: PIX-0423 title: Duplicate End-to-End ID message: A transaction with this end-to-end ID already exists. ErrorPIX0411: summary: Initiation Expired value: code: PIX-0411 title: Initiation Expired message: The payment initiation has expired. ErrorPIX0413: summary: Initiation Invalid State value: code: PIX-0413 title: Initiation Invalid State message: The payment initiation is in an invalid state. ErrorPIX0421: summary: Insufficient Balance value: code: PIX-0421 title: Insufficient Balance message: Insufficient balance to complete the transaction. ErrorPIX0470: summary: Invalid Status Transition value: code: PIX-0470 title: Invalid Status Transition message: The status transition is invalid. ErrorPIX0471: summary: Transfer Already Terminal value: code: PIX-0471 title: Transfer Already Terminal message: The transaction is already in a terminal state. ErrorPIX0600: summary: Midaz Insufficient Funds value: code: PIX-0600 title: Midaz Insufficient Funds message: Insufficient funds in the source account. ErrorPIX0000: summary: Internal Server Error value: code: PIX-0000 title: Internal Server Error message: The server encountered an unexpected error. Please try again later. ErrorPIX0602: summary: Midaz Connection Error value: code: PIX-0602 title: Midaz Connection Error message: Failed to connect to Midaz. ErrorPIX1000: summary: Provider Connection Error value: code: PIX-1000 title: Provider Connection Error message: Failed to connect to provider. ErrorPIX1007: summary: Provider Internal Error value: code: PIX-1007 title: Provider Internal Error message: Provider returned an internal error. ErrorPIX1099: summary: Provider Unmapped Error value: code: PIX-1099 title: Provider Unmapped Error message: Provider returned an unmapped error. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````