Help Center
Gate Pay
Merchant Integration Guide

Gate Pay Refund Methods

2025-11-04 UTC
45289 Read
3

Gate Pay offers two merchant refund methods: Manual Refund via Merchant Dashboard and API Refund

Merchant Dashboard Refund Instructions

Merchants can process full or partial refunds directly through the merchant dashboard. Log in to the merchant dashboard, select [Trade] - [Payment] to access the payment order page. You can search for refund orders using either the merchant order number or Gate Pay order number. Then, click the Refund button to enter the refund page.

1

Option 1: Refund to Original Payment Method

Select [Original Payment Method] and enter the refund amount to process the refund. (If the merchant chooses to cover the transaction fee, the consumer will receive the full refund amount, and the on-chain fee will be deducted separately from the merchant’s payment account. If the consumer covers the fee, the actual amount received = refund amount - transaction fee, and the on-chain fee will be deducted from the refund amount.)

1

Option 2: Refund via Other Methods

  • Gate Pay Gate Pay only supports refunds to Gate users. To refund via Gate Pay, enter the recipient’s Gate UID and the refund amount.

    1
  • Web3 Payment To refund via Web3 Payment, enter the recipient’s account, refund amount, and select who will cover the transaction fee. (If the merchant covers the fee, the consumer receives the full refund amount, and the on-chain fee is deducted separately from the merchant’s payment account. If the consumer covers the fee, the actual amount received = refund amount - transaction fee, and the on-chain fee is deducted from the refund amount.)

    1

API refunds

Merchants can call Gate Pay’s refund APIs for each payment method. Currently, API refunds can only be sent to the customer’s Gate account. For customers without a Gate account, the merchant must ask the customer to register and provide their Gate UID to receive the funds.

Special notes on refund parameters for Checkout payments

Checkout includes on-chain address payments and QR code payments, and the refund logic is more nuanced. The API parameters depend on the settlement:

1

refundOrderAmount: based on the amount that actually settled to the merchant’s payment account.

refundPayAmount: based on the portion that did not settle to the merchant’s payment account (e.g, instant conversion scenarios).

For on-chain address payments made via Checkout, there is currently no instant conversion, so:

Refund API Parameters: "refundOrderAmount": the refund must not exceed the amount credited to the merchant’s payment account.

"refundPayAmount" : 0.

User A pays 5 USDT, and the merchant receives 5 USDT. "refundOrderAmount": ≤ 5 USDT "refundPayAmount": 0

Sign up now for your chance to win up to $10,000!
signup-tips