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