Skip to main content
POST
/
payment-crypto
/
create
curl -X POST 'https://api.goatpay.com.br/v1/payment-crypto/create' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 100, "payCurrency": "usdttrc20", "description": "Pedido 456" }'
{
  "success": true,
  "message": "Pagamento cripto criado com sucesso",
  "data": {
    "id": "clx_crypto_in",
    "type": "CRYPTO_IN",
    "status": "PENDING",
    "amount": 100,
    "feeAmount": 6.5,
    "netAmount": 93.5,
    "coverFee": false,
    "currency": "BRL",
    "description": "Pedido 456",
    "externalReference": "pedido-crypto-456",
    "referenceId": "np_payment_abc",
    "payAddress": "TEmGwPeRTPiLFLVfBxXkSP91yc5GMNQhfS",
    "payCurrency": "usdttrc20",
    "payAmount": 18.42,
    "expiresAt": "2026-06-02T12:00:00.000Z",
    "createdAt": "2026-06-01T12:00:00.000Z"
  },
  "requestId": "req_abc123"
}
curl -X POST 'https://api.goatpay.com.br/v1/payment-crypto/create' \
  -H 'X-API-Key: gp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 100, "payCurrency": "usdttrc20", "description": "Pedido 456" }'
{
  "success": true,
  "message": "Pagamento cripto criado com sucesso",
  "data": {
    "id": "clx_crypto_in",
    "type": "CRYPTO_IN",
    "status": "PENDING",
    "amount": 100,
    "feeAmount": 6.5,
    "netAmount": 93.5,
    "coverFee": false,
    "currency": "BRL",
    "description": "Pedido 456",
    "externalReference": "pedido-crypto-456",
    "referenceId": "np_payment_abc",
    "payAddress": "TEmGwPeRTPiLFLVfBxXkSP91yc5GMNQhfS",
    "payCurrency": "usdttrc20",
    "payAmount": 18.42,
    "expiresAt": "2026-06-02T12:00:00.000Z",
    "createdAt": "2026-06-01T12:00:00.000Z"
  },
  "requestId": "req_abc123"
}

Corpo da requisição

amount
number
required
Valor em BRL (mín. 5).
payCurrency
string
required
Código code de Moedas.
description
string
Opcional (máx. 180 caracteres).
externalReference
string
Referência externa (máx. 120).
coverFee
boolean
Padrão false.
purpose
string
gateway (padrão) ou topup.

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 >= 5
payCurrency
string
required

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

Example:

"usdttrc20"

description
string
externalReference
string
coverFee
boolean
default:false
purpose
enum<string>
default:gateway
Available options:
gateway,
topup

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