Skip to main content
POST
/
transfers
Criar transferência
curl --request POST \
  --url https://api.conta.paybeehive.com.br/v1/transfers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipientId": 321,
  "amount": 10000,
  "description": "Saque"
}
'
{
  "id": 555,
  "recipientId": 321,
  "amount": 10000,
  "status": "processing",
  "createdAt": "2026-01-04T12:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Basic Authorization usando SECRET_KEY como usuário e "x" como senha.

Headers

​
Idempotency-Key
string

Chave de idempotência para evitar duplicidade em retries.

Body

application/json
​
recipientId
integer
required
Example:

321

​
amount
integer
required
Example:

10000

​
description
string
Example:

"Saque"

Response

Transferência criada

​
id
integer
Example:

555

​
recipientId
integer
Example:

321

​
amount
integer
Example:

10000

​
status
string
Example:

"processing"

​
createdAt
string
Example:

"2026-01-04T12:00:00Z"