Criar transferência

post https://secure.api.pagseguro.com/transfers

Este endpoint permite que você solicite uma transferência de valor entre contas. Essa transferência pode ser entre contas PagBank (type = P2P) ou para contas de outras instituições bancárias (type = PIX).

📘
Liberação da API
Para você utilizar a API, você deve entrar em contato com o seu executivo comercial. Ele irá fornecer todas as informações e orientações necessárias para a ativação dessa funcionalidade.

🚧
Certificado Digital
Para realizar transferências, utilize seu certificado digital.
Se você ainda não possui um, acesse a página de introdução ao Certificado Digital para conferir o guia de criação do seu certificado.

📘
Acesse o guia do serviço de transferências para mais informações sobre seu funcionamento e funcionalidades disponíveis.

Body Params

amount

object

required

Objeto contendo as informações do valor a ser transferido.

description

string

Descrição da transferência. Caso o campo seja enviado, deve conter no mínimo 1 e, no máximo, 72 caracteres alfanuméricos.

reference_id

string

Identificador próprio atribuído para a transferência. Tamanho máximo permitido: 64 caracteres alfanuméricos.

instrument

object

Objeto contendo as informações da transferência.

notification_urls

string

required

Objeto contendo as urls que receberão as notificações da transferência. (Por ora, apenas aceitamos uma url).

Headers

Authorization

string

required

Defaults to Bearer <token>

Token de autenticação (access_token). Deve ser enviado no formato Bearer <token>.

Content-type

string

required

O tipo de mídia do recurso. Exemplo: application/json.

x-idempotency-key

string

Chave de idempotência.

Responses

Language


xxxxxxxxxx
12
1
curl --request POST \
2
     --url https://secure.api.pagseguro.com/transfers \
3
     --header 'Authorization: Bearer <token>' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json' \
6
     --data '
7
{
8
  "instrument": {
9
    "type": "P2P"
10
  }
11
}
12
'

Choose an example:

application/json

text/plain

Criar transferência

📘
Liberação da API

🚧
Certificado Digital

📘

📘Liberação da API

🚧Certificado Digital

📘

200200

400400

📘
Liberação da API

🚧
Certificado Digital