Skip to main content
POST
/
transfer-crypto
/
create
curl -X POST 'https://api.goatpay.com.br/v1/transfer-crypto/create' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 50, "address": "TEmGwPeRTPiLFLVfBxXkSP91yc5GMNQhfS", "payCurrency": "usdttrc20", "description": "Saque USDT" }'

{
  "success": true,
  "message": "Transferência cripto solicitado",
  "data": {
    "id": "clx_crypto_out",
    "type": "CRYPTO_OUT",
    "status": "PROCESSING",
    "amount": 50,
    "feeAmount": 1.5,
    "netAmount": 51.5,
    "coverFee": true,
    "currency": "BRL",
    "description": "Saque USDT",
    "payCurrency": "usdttrc20",
    "payAmount": 9.21,
    "payAddress": "TEmGwPeRTPiLFLVfBxXkSP91yc5GMNQhfS",
    "referenceId": "np_payout_xyz",
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

curl -X POST 'https://api.goatpay.com.br/v1/transfer-crypto/create' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 50, "address": "TEmGwPeRTPiLFLVfBxXkSP91yc5GMNQhfS", "payCurrency": "usdttrc20", "description": "Saque USDT" }'

{
  "success": true,
  "message": "Transferência cripto solicitado",
  "data": {
    "id": "clx_crypto_out",
    "type": "CRYPTO_OUT",
    "status": "PROCESSING",
    "amount": 50,
    "feeAmount": 1.5,
    "netAmount": 51.5,
    "coverFee": true,
    "currency": "BRL",
    "description": "Saque USDT",
    "payCurrency": "usdttrc20",
    "payAmount": 9.21,
    "payAddress": "TEmGwPeRTPiLFLVfBxXkSP91yc5GMNQhfS",
    "referenceId": "np_payout_xyz",
    "createdAt": "2026-06-01T14:00:00.000Z"
  },
  "requestId": "req_abc123"
}

​
Corpo da requisição

​
amount
number
required
Valor em BRL debitado (mín. 1).
​
address
string
required
Endereço on-chain de destino.
​
payCurrency
string
required
Código code de Moedas.
​
description
string
required
Descrição (3–180 caracteres).
​
payAmount
number
Quantidade exata em cripto (opcional).
​
extraId
string
Memo / destination tag.
​
externalReference
string
Referência externa.
​
coverFee
boolean
Padrão true.

Authorizations

​
X-API-Key
string
header
required

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

Body

application/json
​
amount
number
required
Required range: x >= 1
​
address
string
required
​
payCurrency
string
required

Código da moeda/rede (code de GET /payment-crypto/currencies).

Example:

"usdttrc20"

​
description
string
required
​
extraId
string

Memo / destination tag.

​
externalReference
string
​
coverFee
boolean
default:true

Response

Transação cripto criada ou consultada.

​
success
boolean
required
​
message
string
required
​
data
object
required

Transação exposta na API pública após sanitização. Não inclui provider, accountId, metadata, pixRail, direction, updatedAt nem providerStatus.

​
requestId
string