---
title: "Create transfer"
method: POST
path: "/v2/transfers"
tags: ["Transfers"]
---

# Create transfer

`POST /v2/transfers`

This service can be used to request an instant or scheduled transfer to an account.

## Request body

- union
  - InstantTransfer
    - `origin` string, required — Origin account ID.
    - `destination` string, required — Destination account ID.
    - `amount` number, required — Transfer amount to be sent to destination.
    - `currency` string — Currency of the transfer amount. Three-letter ISO-4217 currency code, in uppercase.<br>If no currency is specified, it will automatically use the currency of the origin account.
    - `external_id` string, required — ID given by the merchant in their system.
    - `notification_url` string, required — URL where dLocal will send notifications associated with the transfer.
    - `description` string, required — Transfer description.
  - ScheduledTransfer
    - `origin` string, required — Origin account ID.
    - `destination` string, required — Destination account ID.
    - `amount` number, required — Transfer amount to be sent to destination.
    - `currency` string — Currency of the transfer amount. Three-letter ISO-4217 currency code, in uppercase.<br>If no currency is specified, it will automatically use the currency of the origin account.
    - `external_id` string, required — ID given by the merchant in their system.
    - `release_date` string, date-time, required — Release date when the transfer will be executed. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).
    - `notification_url` string, required — URL where dLocal will send notifications associated with the transfer.
    - `description` string, required — Transfer description.

## Response `200`

OK

- union
  - ResponseCreateTransferInstant
    - `id` string — dLocal transfer ID.
    - `origin` string — Origin account ID.
    - `destination` string — Destination account ID.
    - `amount` number — Transfer amount to be sent to destination.
    - `currency` string — Currency of the transfer amount.
    - `external_id` string — ID given by the merchant in their system.
    - `description` string — Transfer description.
    - `created_date` string, date-time — Transfer creation’s timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).
    - `notification_url` string — URL where dLocal will send notifications associated with the transfer.
    - `status` string — Transfer status. <br><br> [See details](https://docs.dlocal.com/reference/transfer-status-v2-platforms).
    - `status_code` number — Transfer status code. <br><br> [See details](https://docs.dlocal.com/reference/transfer-status-v2-platforms).
    - `type` string — The type of transaction. <br><br> Possible values: `INSTANT` or `SCHEDULED`.
    - `last_updated` string, date-time — Transfer last modification's timestamp (YYYY-MM-DDTHH:mm:ss).
  - ResponseCreateTransferScheduled
    - `id` string — dLocal transfer ID.
    - `origin` string — Origin account ID.
    - `destination` string — Destination account ID.
    - `amount` number — Transfer amount to be sent to destination.
    - `currency` string — Currency of the transfer amount.
    - `external_id` string — ID given by the merchant in their system.
    - `description` string — Transfer description.
    - `created_date` string, date-time — Transfer creation’s timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).
    - `release_date` string, date-time — Release date when the transfer will be executed. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).
    - `notification_url` string — URL where dLocal will send notifications associated with the transfer.
    - `status` string — Transfer status. <br><br> [See details](https://docs.dlocal.com/reference/transfer-status-v2-platforms).
    - `status_code` number — Transfer status code. <br><br> [See details](https://docs.dlocal.com/reference/transfer-status-v2-platforms).
    - `type` string — The type of transaction. <br><br> Possible values: `INSTANT` or `SCHEDULED`.
    - `last_updated` string, date-time — Transfer last modification's timestamp (YYYY-MM-DDTHH:mm:ss).

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/dlocal/apis/payins.md) · [All operations](https://skmtc.net/dlocal/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dlocal/payins/revisions/d87e090020f9/schema)