Skip to main content
POST
/
transfer-crypto-auto
/
create
curl -X POST 'https://api.goatpay.com.br/v1/transfer-crypto-auto/create' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 100, "address": "TEnderecoDestino...", "description": "Saque automático" }'
{
  "success": true,
  "message": "Transferência cripto solicitada",
  "data": {
    "id": "clx_crypto_out",
    "type": "CRYPTO_OUT",
    "status": "PROCESSING",
    "amount": 100,
    "feeAmount": 3,
    "netAmount": 103,
    "coverFee": true,
    "currency": "BRL",
    "description": "Saque automático",
    "payCurrency": "usdttrc20",
    "payAddress": "TEnderecoDestino...",
    "referenceId": "np_payout_auto",
    "requiresVerification": false,
    "createdAt": "2026-06-01T15:00:00.000Z"
  },
  "requestId": "req_abc123"
}
Semelhante a POST /transfer-crypto/create, com roteamento interno que seleciona moeda/rede conforme regras da conta. Permissão: transfer-crypto-auto/create.
curl -X POST 'https://api.goatpay.com.br/v1/transfer-crypto-auto/create' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 100, "address": "TEnderecoDestino...", "description": "Saque automático" }'
{
  "success": true,
  "message": "Transferência cripto solicitada",
  "data": {
    "id": "clx_crypto_out",
    "type": "CRYPTO_OUT",
    "status": "PROCESSING",
    "amount": 100,
    "feeAmount": 3,
    "netAmount": 103,
    "coverFee": true,
    "currency": "BRL",
    "description": "Saque automático",
    "payCurrency": "usdttrc20",
    "payAddress": "TEnderecoDestino...",
    "referenceId": "np_payout_auto",
    "requiresVerification": false,
    "createdAt": "2026-06-01T15:00:00.000Z"
  },
  "requestId": "req_abc123"
}
Webhooks: transfer.created, transfer.crypto.completed, transfer.crypto.failed.

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

200 - application/json

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