---
title: "Create Batch Transfer"
method: POST
path: "/v2/batch_transfers"
---

# Create Batch Transfer

`POST /v2/batch_transfers`

This document describes the request to create batch transfer.

## Request body

- object
  - `transfers` object[], required
    - `source_account` object, required — Describes source account that participates in the transfer
      - `number` string, required — Source account number
      - `name` string, required — Source account name
      - `bic` string, required — Source account bank code. use PAEYPHM2XXX for Paymongo BIC
    - `destination_account` object, required — Describes destination account that participates in the transfer
      - `number` string, required — Destination account number
      - `name` string, required — Destination account name
      - `bic` string, required — Destination account bank code
    - `amount` integer, required — Amount to be transfered
    - `currency` 'PHP', required — Currency of the amount transfered
    - `provider` 'paymongo' | 'instapay' | 'pesonet', required — Entity that will facilitate the transfer
    - `reference_number` string — Merchant-provided reference number to mark the transaction. Value is normalized to alphanumeric characters and spaces, other characters (_, -, punctuation, accents, etc.) are replaced with spaces, and apostrophes are stripped. If no value is provided, a random string will be generated.
    - `purpose` string — The purpose of the transaction
    - `description` string
    - `callback_url` string — A URL link used to inform a change in transaction status
    - `metadata` object — Key value additional information

## Response `201`

- object

## Other responses

- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/paymongo/apis/paymongo-api.md) · [All operations](https://skmtc.net/paymongo/apis/paymongo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymongo/paymongo-api/versions/c18f9a027b2c/schema)