> ## 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. # Batch ACH payout > Creates a batch of bank payments in Bolivia using the partner balance. Requires at least one payment. Some payments may be authorized while others fail due to insufficient funds. HTTP 200 does not confirm settlement: check success and each payment result, and retrieve its status with GET /v3/transactions/payouts/bank/status/{transactionId}. Fields remain snake_case even though the route is v3. ## OpenAPI ````yaml /openapi-v3.en.yaml post /v3/transactions/payouts/bank/batch openapi: 3.0.0 info: title: YP API Partner description: Integration documentation for YP API partners. 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: Queries 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: Batch ACH payout description: >- Creates a batch of bank payments in Bolivia using the partner balance. Requires at least one payment. Some payments may be authorized while others fail due to insufficient funds. HTTP 200 does not confirm settlement: check success and each payment result, and retrieve its status with GET /v3/transactions/payouts/bank/status/{transactionId}. Fields remain snake_case even though the route is v3. operationId: createPayoutAchBatchV1 parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateBankPayoutBatchRequestDoc' responses: '200': description: >- Batch evaluated. May contain pending payments, payments failed due to insufficient funds, or both. content: application/json: schema: $ref: '#/components/schemas/CreateBankPayoutBatchResponseDoc' '400': description: Invalid request or batch without transactions. '401': description: Missing, invalid, or expired token. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponseDoc' '500': description: The bank payment batch could not be processed. security: - bearer: [] components: schemas: CreateBankPayoutBatchRequestDoc: type: object properties: external_reference: type: string example: 550e8400-e29b-41d4-a716-446655440000 format: uuid description: External batch reference in UUID v4 format. transactions: minItems: 1 description: Bank payments in the batch, processed in the submitted order. type: array items: $ref: '#/components/schemas/BatchBankTransactionDoc' required: - external_reference - transactions CreateBankPayoutBatchResponseDoc: type: object properties: success: type: boolean example: true description: >- True when at least one payment was authorized, even if others fail due to insufficient funds. message: type: string example: Batch authorized successfully description: Descriptive message for the batch result. transaction_id: type: string example: 550e8400-e29b-41d4-a716-446655440000 description: Batch identifier, equal to external_reference. external_reference: type: string example: 550e8400-e29b-41d4-a716-446655440000 description: External reference sent in the request. batch_id: type: string example: ACH-123456 nullable: true description: >- Provider batch identifier. Null when no payment has sufficient funds. transactions: description: Result for each payment in the same order as the 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: Destination bank code. description: type: string example: Supplier payment description: Transaction description. maxLength: 200 destination_account: type: string example: '1234567890' description: Destination account number. destination_id_number: type: string example: '1234567' description: Account holder document number. Digits only. 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: >- Destination bank country. The batch is processed in Bolivia regardless of this field. amount: type: number example: 100.5 minimum: 0.01 multipleOf: 0.01 description: Fiat amount to send. destination_holder: type: string example: Juan Perez description: Full name of the destination account holder. currency_type: type: string enum: - BOB - USD default: BOB example: BOB description: Transaction fiat currency. required: - bank_code - description - destination_account - destination_id_number - amount - destination_holder BatchBankTransactionResponseDoc: type: object properties: transaction_id: type: string example: '12345678901234' description: Bank transaction identifier. status: type: string enum: - PENDING - FAILED example: PENDING description: >- PENDING when the payment was sent to the provider; FAILED when funds are insufficient. message: type: string example: Transaction created successfully description: Status description. required: - transaction_id - status - message securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http description: JWT obtained from /v2/auth/login or /v3/auth/login ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.