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