GTRADEDocs
Help

Merchant FAQ

Answers for merchants about fees, settlement, supported coins, refunds, underpayments, expired links, security and support.

#Fees and pricing

#What does GTRADE charge?

Each successful payment carries your GTRADE plan fee, as set out in your merchant agreement. There is no charge for creating payments that are never paid, for API calls or for webhooks. Ask support or your account manager about your plan.

#Who pays the blockchain network fee?

The customer pays the network fee of the transaction they send. Moving received funds onward (consolidation or withdrawal to another wallet) also costs network fees; choosing low-fee networks such as Base, Polygon or Tron keeps these small.

#Do I price in crypto?

No. You always price in USD (amount_usd). The checkout converts it into the coin the customer chooses at the current rate and tells them exactly how much to send.

#Settlement and custody

#Is GTRADE custodial?

No. GTRADE is non-custodial. Customer payments go to deposit addresses that belong to your account's wallet, and settle to your wallet. GTRADE never holds your funds and can't move them for you.

#When do I get my money?

A payment becomes paid once the blockchain has confirmed it. The time depends on the network (from seconds to tens of minutes, Bitcoin is the slowest). The funds are already on your wallet's deposit address at that point; there is no payout schedule or minimum to wait for.

#In what currency is it settled?

In the coin the customer paid with. A customer paying 25 USDC on Base settles as USDC on Base. If you need fiat, convert through an exchange or off-ramp partner of your choice.

#What do I need to keep safe?

Your wallet's recovery details and your dashboard sign-in. Because the wallet is yours, nobody (including GTRADE) can recover funds if you lose the recovery details. Turn on two-factor sign-in for every dashboard user.

#Coins and networks

#Which coins and networks can my customers use?

The platform supports these combinations. The checkout only offers those enabled for your account:

NetworkCoins
BaseUSDC, ETH, cbBTC
EthereumUSDC, USDT, ETH, PYUSD, cbBTC
PolygonUSDC, USDT, POL
TronUSDT (TRC-20), TRX
BitcoinBTC

Stablecoins (USDC, USDT, PYUSD) avoid price swings between checkout and settlement. Base, Polygon and Tron have the lowest fees for your customers. Contact support to enable or disable an option.

#What happens if a customer pays on the wrong network or in the wrong coin?

Funds sent on a network or in a coin other than the one shown on the checkout may not be detected automatically, and may not be recoverable. Ask the customer for the transaction hash and contact support. This is why the checkout shows the network prominently; repeat it in your own instructions.

#Refunds

#Can GTRADE refund or reverse a payment?

No. Blockchain transactions are final: neither GTRADE nor anyone else can reverse or charge back a crypto payment. That also means no chargebacks for you.

#So how do I refund a customer?

You send the refund yourself from your wallet:

  1. Ask the customer for a refund address and the network, in writing. Don't send the refund to the address the payment came from: it is often an exchange's shared address and the funds could be lost.
  2. Agree on the amount and coin. Usually the same coin and network they paid with. Decide who covers the network fee and whether you refund the USD amount or the crypto amount.
  3. Send the refund from your wallet (dashboard Withdraw, or your own wallet software).
  4. Record it in your systems with the original payment id and the refund transaction hash, and send the customer the hash as proof.

The original payment stays paid in GTRADE; refunds are tracked on your side.

#Underpayments and overpayments

#What if the customer sends too little?

The payment becomes partially_paid and you receive a payment.partially_paid webhook. amount_paid_usd shows what arrived. Your options:

  • Ask the customer to pay the difference: create a new payment for the missing amount and send them its link.
  • Accept the smaller amount and fulfil anyway (for small differences, such as exchange withdrawal fees).
  • Cancel the order and refund what was received.

Don't fulfil automatically on partially_paid.

#What if the customer sends too much?

The payment becomes paid and amount_paid_usd is greater than amount_usd. Fulfil the order and, if you wish, refund the difference as described above.

For a limited time, shown on the checkout. When it expires before payment, the payment becomes cancelled (payment.cancelled webhook).

Create a new payment (with a new idempotency key) and send the new link. Never ask customers to reuse the address from an expired checkout.

Late deposits may not be matched to the payment automatically. Check Payments → Missed Payments in the dashboard and contact support with the transaction hash.

#Security

#How do I know a webhook really comes from GTRADE?

Every webhook is signed with your API key in the X-Gtrade-Signature header. Verify it against the raw body; see Verifying signatures. For extra certainty, fetch the payment with GET /v1/payments/{id} before fulfilling.

#What if my API key leaks?

Create a new key, deploy it, then revoke the leaked key in Developers → API Keys. Revoked keys stop working within 5 minutes. Check GET /v1/webhooks for endpoints you don't recognise and delete them.

#Can someone else see my payments?

No. Every request is scoped to the account of the API key. Payments of other accounts return 404, as if they didn't exist.

#Support

#How do I contact support?

Email [email protected]. See Support for what to include so we can help quickly.