---
title: "Criando uma transferência"
method: POST
path: "/transfers"
---

# Criando uma transferência

`POST /transfers`

Realiza uma transferência para uma conta bancária previamente criada.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `amount` integer, required — Valor, em centavos, a ser transferido para uma determinada conta bancária (valor precisa estar entre 1 e 2147483647)
  - `recipient_id` string — Indica que o valor da transferência sairá da conta do recebedor identificado por este parâmetro. OBS: Caso o recipient_id seja passado, não é necessário passar bank_account_id
  - `metadata` string, json — Você pode passar dados adicionais na criação da transferência para facilitar uma futura análise de dados por seus sistemas.

## Response `200`

200

- object
  - `object` string
  - `id` integer
  - `amount` integer
  - `type` string
  - `status` string
  - `source_type` string
  - `source_id` string
  - `target_type` string
  - `target_id` string
  - `fee` integer
  - `funding_date` unknown
  - `funding_estimated_date` string
  - `transaction_id` unknown
  - `date_created` string
  - `bank_account` object
    - `object` string
    - `id` integer
    - `bank_code` string
    - `agencia` string
    - `agencia_dv` string
    - `conta` string
    - `conta_dv` string
    - `type` string
    - `document_type` string
    - `document_number` string
    - `legal_name` string
    - `charge_transfer_fees` boolean
    - `date_created` string
  - `metadata` object
    - `idProduto` string

## Other responses

- `400` — 400

---

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