Conversion - UQPAY Developer Docs

Stablecoin Account API Publisher Disclaimer Event metadata

name: CONVERSION
types:
- ramp.conversion.trade.pending – conversion in progress
- ramp.conversion.trade.completed – conversion completed successfully
- ramp.conversion.trade.failed – conversion failed

Request body

Field	Type	Description
event_id	string	Unique event ID
event_name	string	Event name
event_type	string	Event type
source_id	string	Conversion ID
version	string	API version
data	object	Conversion details object

Notification example

The structure is consistent with the Retrieve Conversion API response.

{
  "version": "V1.6.0",
  "event_name": "CONVERSION",
  "event_type": "ramp.conversion.trade.pending",
  "event_id": "9f02664f-e30a-43dd-8904-35bb7806c79c",
  "source_id": "2031debb-8ac5-4dc9-add5-02ebd1aa36da",
  "data": {
    "buy_amount": "98.06",
    "buy_currency": "USD",
    "complete_time": "",
    "conversion_id": "2031debb-8ac5-4dc9-add5-02ebd1aa36da",
    "conversion_status": "Pending",
    "create_time": "2026-03-03 10:10:04 +0800 CST",
    "network_fee": "0",
    "processing_fee": "0",
    "quote_price": "0.899712",
    "reason": "test",
    "sell_amount": "109",
    "sell_currency": "USDC",
    "short_conversion_id": "ES260303-V77NUZPN"
  }
}