> ## Documentation Index > Fetch the complete documentation index at: https://docs.mesadepagos.com/llms.txt > Use this file to discover all available pages before exploring further. # Payout ACH por lote > Crea un lote de pagos bancarios en Bolivia usando el saldo del partner. Requiere al menos un pago. Puede autorizar solo algunos pagos por saldo insuficiente. HTTP 200 no confirma la liquidacion: revisa success y el resultado de cada pago, y consulta su estado con GET /v3/transactions/payouts/bank/status/{transactionId}. Conserva campos snake_case aunque la ruta sea v3. ## OpenAPI ````yaml /openapi-v3.yaml post /v3/transactions/payouts/bank/batch openapi: 3.0.0 info: title: YP API Partner description: Documentación de integración para partners de YP API. version: v3 contact: {} servers: - url: https://sandbox-rampa.mesadepagos.com/api description: Sandbox security: [] tags: - name: Auth description: '' - name: Quotes description: '' - name: Payin description: '' - name: Payout description: '' - name: Wallet description: '' - name: Consultas description: '' - name: Webhooks description: '' - name: Fees description: '' - name: Clients description: '' - name: Client verifications description: Las verificaciones que habilitan a un cliente a cobrar a su nombre. - name: Virtual accounts description: 'Las cuentas de cobro: las del partner y las de sus clientes.' paths: /v3/transactions/payouts/bank/batch: post: tags: - Payout summary: Payout ACH por lote description: >- Crea un lote de pagos bancarios en Bolivia usando el saldo del partner. Requiere al menos un pago. Puede autorizar solo algunos pagos por saldo insuficiente. HTTP 200 no confirma la liquidacion: revisa success y el resultado de cada pago, y consulta su estado con GET /v3/transactions/payouts/bank/status/{transactionId}. Conserva campos snake_case aunque la ruta sea v3. operationId: createPayoutAchBatchV1 parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateBankPayoutBatchRequestDoc' responses: '200': description: >- Lote evaluado. Puede incluir pagos pendientes, pagos fallidos por saldo insuficiente o ambos. content: application/json: schema: $ref: '#/components/schemas/CreateBankPayoutBatchResponseDoc' '400': description: Request invalido o lote sin transacciones. '401': description: Token ausente, invalido o expirado. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponseDoc' '500': description: No se pudo procesar el lote de pagos bancarios. security: - bearer: [] components: schemas: CreateBankPayoutBatchRequestDoc: type: object properties: external_reference: type: string example: 550e8400-e29b-41d4-a716-446655440000 format: uuid description: Referencia externa del lote en formato UUID v4. transactions: minItems: 1 description: Pagos bancarios del lote, procesados en el orden enviado. type: array items: $ref: '#/components/schemas/BatchBankTransactionDoc' required: - external_reference - transactions CreateBankPayoutBatchResponseDoc: type: object properties: success: type: boolean example: true description: >- Es true si al menos un pago fue autorizado, incluso cuando otros fallan por saldo insuficiente. message: type: string example: Batch authorized successfully description: Mensaje descriptivo del resultado del lote. transaction_id: type: string example: 550e8400-e29b-41d4-a716-446655440000 description: Identificador del lote, igual a external_reference. external_reference: type: string example: 550e8400-e29b-41d4-a716-446655440000 description: Referencia externa enviada en el request. batch_id: type: string example: ACH-123456 nullable: true description: >- Identificador del lote en el proveedor. Es null si ningun pago tiene saldo suficiente. transactions: description: Resultado de cada pago en el mismo orden del request. type: array items: $ref: '#/components/schemas/BatchBankTransactionResponseDoc' required: - success - message - transaction_id - external_reference - batch_id - transactions UnauthorizedResponseDoc: type: object properties: statusCode: type: number example: 401 message: type: string example: Unauthorized required: - statusCode - message BatchBankTransactionDoc: type: object properties: bank_code: type: string example: '101' description: Codigo del banco destino. description: type: string example: Pago proveedor description: Descripcion de la transaccion. maxLength: 200 destination_account: type: string example: '1234567890' description: Numero de cuenta destino. destination_id_number: type: string example: '1234567' description: Numero de documento del titular. Solo numeros. minLength: 5 maxLength: 20 pattern: ^\d+$ country: type: string enum: - BO - BR - CO - CL - PE - CN - CR - PY - UY - PA - GT default: BO example: BO description: >- Pais del banco destino. El lote se procesa en Bolivia independientemente de este campo. amount: type: number example: 100.5 minimum: 0.01 multipleOf: 0.01 description: Monto fiat a enviar. destination_holder: type: string example: Juan Perez description: Nombre completo del titular de la cuenta destino. currency_type: type: string enum: - BOB - USD default: BOB example: BOB description: Moneda fiat de la transaccion. required: - bank_code - description - destination_account - destination_id_number - amount - destination_holder BatchBankTransactionResponseDoc: type: object properties: transaction_id: type: string example: '12345678901234' description: Identificador de la transaccion bancaria. status: type: string enum: - PENDING - FAILED example: PENDING description: >- PENDING si el pago fue enviado al proveedor; FAILED si no tiene saldo suficiente. message: type: string example: Transaction created successfully description: Mensaje descriptivo del estado. required: - transaction_id - status - message securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http description: JWT obtenido desde /v2/auth/login o /v3/auth/login ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.