---
title: "Nova transferência"
method: POST
path: "/transfer_requests"
---

# Nova transferência

`POST /transfer_requests`

Este endpoint permite criar uma nova transferência no sistema Grafeno.

## Request body

- object
  - `transferRequest` object, required — Parâmetros para realizar transferência
    - `transferMethod` 'pix' | 'ted' | 'tef' — Método de transferência. Se não informado, o padrão é ted ou tef. (dependendo da conta destino).
    - `apiPartnerTransactionUuid` string, required — uuid próprio da transferência.
    - `value` number, double, required — Valor da transferência.
    - `callbackUrl` string — URL de notificação da transferência.
  - `beneficiary` object, required — Verificar a tabela de atributos do beneficiário
    - `name` string — Nome do beneficiário
    - `documentNumber` string — Documento do beneficiário
    - `bankCode` string — Código do banco.
    - `agency` string — Agência da conta bancária.
    - `account` string — Número da conta bancária.
    - `uuid` string — uuid do beneficiário.
    - `keyType` 'evp' | 'cpf' | 'cnpj' | 'email' | 'phone' — Tipo de chave PIX do beneficiário. Valores possíveis: evp, cpf, cnpj, email e phone.
    - `key` string — Chave PIX do beneficiário.

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` object
      - `apiPartnerTransactionUuid` string
      - `originBankAccount` object
        - `agency` string
        - `account` string
        - `name` string
      - `associatedFund` unknown
      - `beneficiary` object
        - `companyName` unknown
        - `destinationAccount` object
          - `agency` string
          - `account` string
          - `name` string
      - `transferDetails` object
        - `createdAt` string
        - `value` string
        - `source` string
        - `transferMethod` string
        - `approvalStatus` string
        - `transferStatus` unknown

## Other responses

- `400` — 400
- `401` — 401
- `422` — 422

---

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