---
title: "Criar transferência P2P"
method: POST
path: "/v1/marketplace/banking/transfers/p2p"
tags: ["Transferências"]
---

# Criar transferência P2P

`POST /v1/marketplace/banking/transfers/p2p`

## Request

- Base URL: `https://api.sandbox.paytime.com.br`
- URL: `https://api.sandbox.paytime.com.br/v1/marketplace/banking/transfers/p2p`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/paytime/apis/api-p-blica/docs/v1/marketplace/banking/transfers/p2p/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `mTLS` string, required
- `integration-key` string, required
- `x-token` string, required

## Request body

- CreateTransferP2pDto
  - `amount` number, required: Valor da transferência em centavos.
  - `document` string, required: Documento do destinatário.
  - `description` string: Descrição livre da transferência.

## Response `200`

- TransferResponse
  - `_id` string, required: ID da transferência.
  - `type` 'TED' | 'P2P' | 'PIX', required: Tipo da transferência.
  - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required: Status atual da transferência.
  - `amount` number, required: Valor transferido em centavos.
  - `original_amount` number: Valor original da transferência em centavos.
  - `establishment_id` string, required: ID do estabelecimento.
  - `gateway_key` string: Código do gateway.
  - `gateway_authorization` string, required: Código de autorização do gateway.
  - `expected_at` string, date-time, required: Data prevista para conclusão da transferência.
  - `recipient` TransferAccount, required
    - `establishment` TransferEntity, required
      - `id` number, required
      - `first_name` string, required: Nome / Razão Social.
      - `last_name` string, required: Sobrenome / Nome Fantasia.
      - `document` string, required: CPF / CNPJ.
    - `marketplace` TransferEntity, required
      - `id` number, required
      - `first_name` string, required: Nome / Razão Social.
      - `last_name` string, required: Sobrenome / Nome Fantasia.
      - `document` string, required: CPF / CNPJ.
    - `representative` TransferEntity
      - `id` number, required
      - `first_name` string, required: Nome / Razão Social.
      - `last_name` string, required: Sobrenome / Nome Fantasia.
      - `document` string, required: CPF / CNPJ.
    - `document` string, required: Documento do titular (CPF/CNPJ).
    - `bank_code` string: Código do banco.
    - `bank_ispb` string: ISPB do banco.
    - `bank_name` string: Nome do banco.
    - `routing_number` string: Número da agência bancária.
    - `routing_check_digit` string: Dígito verificador da agência.
    - `account_number` string, required: Número da conta bancária.
    - `account_check_digit` string, required: Dígito verificador da conta.
    - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required: Tipo da conta.
    - `pix_key` string: Chave pix de origem ou destino.
  - `payer` TransferAccount, required
    - `establishment` TransferEntity, required
      - `id` number, required
      - `first_name` string, required: Nome / Razão Social.
      - `last_name` string, required: Sobrenome / Nome Fantasia.
      - `document` string, required: CPF / CNPJ.
    - `marketplace` TransferEntity, required
      - `id` number, required
      - `first_name` string, required: Nome / Razão Social.
      - `last_name` string, required: Sobrenome / Nome Fantasia.
      - `document` string, required: CPF / CNPJ.
    - `representative` TransferEntity
      - `id` number, required
      - `first_name` string, required: Nome / Razão Social.
      - `last_name` string, required: Sobrenome / Nome Fantasia.
      - `document` string, required: CPF / CNPJ.
    - `document` string, required: Documento do titular (CPF/CNPJ).
    - `bank_code` string: Código do banco.
    - `bank_ispb` string: ISPB do banco.
    - `bank_name` string: Nome do banco.
    - `routing_number` string: Número da agência bancária.
    - `routing_check_digit` string: Dígito verificador da agência.
    - `account_number` string, required: Número da conta bancária.
    - `account_check_digit` string, required: Dígito verificador da conta.
    - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required: Tipo da conta.
    - `pix_key` string: Chave pix de origem ou destino.
  - `history` TransferHistory[], required: Histórico de status da transferência.
    - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required: Status histórico da transferência.
    - `created_at` string, date-time, required: Data do registro do histórico.
    - `_id` string, required
  - `method` 'IN' | 'OUT', required: Direção da transferência (entrada ou saída).
  - `pixKey` string: Chave Pix utilizada (caso aplicável).
  - `end_to_end` string: Identificador único de cada transação.
  - `description` string: Descrição da transferência.
  - `reprocessed` boolean, required: Indica se a transferência foi reprocessada.
  - `created_at` string, date-time, required: Data de criação da transferência.
  - `updated_at` string, date-time, required: Data da última atualização da transferência.
  - `fees` number: Valor total de taxas da transferência.
  - `user` TransferUser
    - `id` number, required: Id do usuário.
    - `first_name` string, required: Primeiro nome.
    - `last_name` string: Sobrenome.
    - `profile_id` number, required: Id do perfil.

---

[API](https://skmtc.dev/paytime/apis/api-p-blica.md) - [All operations](https://skmtc.dev/paytime/apis/api-p-blica/llms.txt) - [OpenAPI document](https://skmtc.dev/paytime/apis/api-p-blica/revisions/5c818991d183?raw)