🔼
POST urlServidor/v1/marketplace/banking/transfers/p2p

Obs: A palavra urlServidor deve ser substituída pela url do servidor.

Parâmetros da Requisição

Nome	Tipo	Obrigatório	Descrição
`integration-key`	string	Sim	Chave de integração.
`x-token`	string	Sim	Token utilizado para autenticação. Pode ser encontrado no portal da API.
`Authorization`	Auth Type Bearer Token	Sim	Inserir o Bearer Token, gerado na rota Auth

Exemplo de header da requisição

curl--request POST \
--location 'urlServidor/v1/marketplace/banking/transfers/p2p' \
--header 'integration-key: your_integration_key' \
--header 'x-token: your_x_token' \
--header 'Authorization: Bearer {{bearer_token}}' \

Variáveis

Campo	Tipo	Obrigatório	Descrição
amount	number	Sim	Valor da transferência em centavos
document	string	Sim	Documento do destinatário (CPF/CNPJ)
description	string	Não	Descrição da transferência

📥 Modelo body

{
  "amount": 10000,
  "document": "20961538000170",
  "description": "Repasse de comissão"
}

Modelo response

{
    "_id": "69ea188e71ad0804c9405083",
    "type": "P2P",
    "status": "PENDING",
    "amount": 10000,
    "establishment_id": "155392",
    "gateway_key": "a152a7fb-d1eb-43e1-9b58-3f09f3a00865",
    "gateway_authorization": "CELCOIN",
    "expected_at": "2026-04-23T13:03:10.009Z",
    "recipient": {
        "account_number": "431143",
        "account_check_digit": "7",
        "type": "CHECKING",
        "establishment": {
            "id": 155391,
            "first_name": "EC Final1",
            "last_name": "Final 1",
            "document": "20961538000170"
        },
        "marketplace": {
            "id": 26,
            "first_name": "Webhooks Integrações",
            "last_name": "API Integrações",
            "document": "60274849000185"
        }
    },
    "payer": {
        "account_number": "422345",
        "account_check_digit": "9",
        "type": "CHECKING",
        "establishment": {
            "id": 155392,
            "first_name": "EC Final3",
            "last_name": "Final 3",
            "document": "31820784000128"
        },
        "marketplace": {
            "id": 26,
            "first_name": "Webhooks Integrações",
            "last_name": "API Integrações",
            "document": "60274849000185"
        }
    },
    "history": [
        {
            "status": "CREATED",
            "created_at": "2026-04-23T13:03:10.009Z",
            "_id": "69ea188e71ad0804c9405084"
        }
    ],
    "method": "OUT",
    "end_to_end": null,
    "description": "Repasse de comissão",
    "reprocessed": false,
    "created_at": "2026-04-23T13:03:10.013Z",
    "updated_at": "2026-04-23T13:03:10.013Z"
}

📥 Detalhe response

Campo	Tipo	Obrigatório	Descrição
_id	string	Sim	ID da transferência
type	string	Sim	Tipo da transferência (P2P)
status	string	Sim	Status atual.[ CREATED, PENDING, PAID, FAILED, REFUNDED, CANCELED, PROCESSING]
amount	number	Sim	Valor em centavos
original_amount	number	Não	Valor original da transferência
establishment_id	string	Sim	ID do estabelecimento
gateway_key	string	Não	Código do gateway
gateway_authorization	string	Sim	Código de autorização
expected_at	string	Sim	Data prevista de conclusão
method	string	Sim	Direção da transferência (IN/OUT)
pixKey	string	Não	Chave Pix (quando aplicável)
end_to_end	string	Não	Identificador único da transação
description	string	Não	Descrição da transferência
reprocessed	boolean	Sim	Indica reprocessamento
created_at	string	Sim	Data de criação
updated_at	string	Sim	Data de atualização
fees	number	Não	Total de taxas
user	object	Não	Usuário responsável

Objeto recipient (Conta recebedora)

Campo	Tipo	Obrigatório	Descrição
document	string	Sim	Documento do titular
bank_code	string	Não	Código do banco
bank_ispb	string	Não	ISPB do banco
bank_name	string	Não	Nome do banco
routing_number	string	Não	Agência
routing_check_digit	string	Não	Dígito da agência
account_number	string	Sim	Número da conta
account_check_digit	string	Sim	Dígito da conta
type	string	Sim	Tipo da conta (CHECKING, SAVING, PAYMENT)
pix_key	string	Não	Chave Pix

Objeto payer (Conta pagadora)

Mesma estrutura do objeto recipient, representando a origem do saldo.

Objeto history

Campo	Tipo	Obrigatório	Descrição
status	string	Sim	Status da transferência. [ CREATED, PENDING, PAID, FAILED, REFUNDED, CANCELED, PROCESSING ]
created_at	string	Sim	Data do evento
_id	string	Sim	ID do registro

Objeto user

Campo	Tipo	Obrigatório	Descrição
id	number	Sim	ID do usuário
first_name	string	Sim	Nome
last_name	string	Não	Sobrenome
profile_id	number	Sim	ID do perfil

Códigos de resposta

Consulte a página com os status: Status de respostas

Para mais detalhes sobre os parâmetros e funcionamento da API, acesse a documentação oficial da Paytime.