Skip to main content
POST
/
subaccount
/
add-balance
curl -X POST 'https://api.goatpay.com.br/v1/subaccount/add-balance' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "id": "clx_subconta", "amount": 200, "description": "Aporte inicial" }'

{
  "success": true,
  "message": "Saldo adicionado à subconta",
  "data": {
    "mainTransactionId": "clx_tx_main",
    "subTransactionId": "clx_tx_sub",
    "amount": 200
  },
  "requestId": "req_abc123"
}

curl -X POST 'https://api.goatpay.com.br/v1/subaccount/add-balance' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "id": "clx_subconta", "amount": 200, "description": "Aporte inicial" }'

{
  "success": true,
  "message": "Saldo adicionado à subconta",
  "data": {
    "mainTransactionId": "clx_tx_main",
    "subTransactionId": "clx_tx_sub",
    "amount": 200
  },
  "requestId": "req_abc123"
}
​
id
string
required
ID da subconta destino.
​
amount
number
required
Valor em reais (positivo).
​
description
string
Descrição (máx. 200).
​
externalReference
string
Idempotência e reconciliação (máx. 64).

Authorizations

​
X-API-Key
string
header
required

Chave gp_live_... criada em Integrações → Chaves de API no dashboard.

Body

application/json
​
id
string
required
​
amount
number
required
​
description
string
Maximum string length: 200
​
externalReference
string
Maximum string length: 64

Response

200 - application/json

Operação concluída.

​
success
boolean
required
Example:

true

​
message
string
required
Example:

"Pagamento PIX criado com sucesso"

​
data
object
required
​
requestId
string