Overview

This API call fetches the details of a completed on-ramp transaction with a cryptocurrency withdrawal. When a user deposits fiat and the crypto is withdrawn to a specified wallet

It provides comprehensive information about the transaction, including fees, payment method, and status.

Endpoint

URL: https://staging.mudrex.com/api/v2/wallet/w/transaction/buy/{transaction_id}
Method: GET

Headers

Header	Description
`X-Timestamp`	A UNIX timestamp for the request. Used for generating a secure signature.
`X-Client-Id`	Your unique client ID is provided by Saber Money.
`X-Request-Id`	A unique identifier for the request (optional but recommended).
`X-User-Id`	The unique ID of the user whose transaction is being fetched.
`X-Secret-Key`	Your API secret key for authenticating the request.

Request Parameters

Parameter	Description	Example Value
`transaction_id`	The unique identifier of the transaction to fetch details for.	`50232ef8-5d3f-4d04-9889-ad963ef34ff1`

Sample call

curl --location 'https://staging.mudrex.com/api/v2/wallet/w/transaction/buy/50232ef8-5d3f-4d04-9889-ad963ef34ff1' \
--header 'X-Timestamp: 1705491300' \
--header 'X-Client-Id: CLIENT_ID_HERE' \
--header 'X-Request-Id: hggqwei' \
--header 'X-User-Id: USER_ID_HERE' \
--header 'X-Secret-Key: SECRET_KEY_HERE'

Response

Sample Response:

{
  "success": true,
  "data": {
    "id": "50232ef8-5d3f-4d04-9889-ad963ef34ff1",
    "transaction_type": "ONRAMP_AND_WITHDRAW",
    "status": "ONRAMP_COMPLETED",
    "crypto_symbol": "USDT",
    "fiat_symbol": "INR",
    "source_id": "",
    "payment_method": "gpay_intent",
    "withdraw_address": "0x1f4d75864f1ceb33a75e26ded3393caa55f87d8e",
    "network": "BSC",
    "crypto_amount": 20,
    "fiat_amount": 1868.18,
    "base_price": 92.53,
    "final_price": 93.41,
    "total_fee": 0.19,
    "fee_currency": "USDT",
    "fee_breakup": {
      "platform_fee": 0,
      "network_fee": 0.19,
      "client_fee": 0,
      "discount": 0,
      "tax_on_fee": 0,
      "tds": 0
    },
    "created_at": 1705491300000,
    "updated_at": 1705491301000,
    "txn_hash": ""
  }
}

Key Response Fields

Field	Description	Example Value
`id`	Unique identifier of the transaction.	`50232ef8-5d3f-4d04-9889-ad963ef34ff1`
`transaction_type`	Type of transaction (e.g., `ONRAMP_AND_WITHDRAW`).	`ONRAMP_AND_WITHDRAW`
`status`	Current status of the transaction.	`ONRAMP_COMPLETED`
`crypto_symbol`	Cryptocurrency involved in the transaction.	`USDT`
`fiat_symbol`	Fiat currency used in the transaction.	`INR`
`payment_method`	Payment method used (e.g., `gpay_intent`).	`gpay_intent`
`withdraw_address`	The wallet address to which the cryptocurrency was withdrawn.	`0x1f4d75864f1ceb33a75e26ded3393caa55f87d8e`
`network`	Blockchain network used for the transaction.	`BSC`
`crypto_amount`	Amount of cryptocurrency involved.	`20`
`fiat_amount`	Amount of fiat currency used.	`1868.18`
`total_fee`	Total fees charged for the transaction.	`0.19`
`fee_currency`	Currency in which the fees were charged.	`USDT`
`fee_breakup`	Detailed breakdown of the fees (e.g., platform, network, client fees).	`{ "network_fee": 0.19 }`

Notes

Transaction Status:
- Common statuses include ONRAMP_COMPLETED, WITHDRAW_PENDING,
- Use this field to determine the progress of the transaction.
Fee Details:
- total_fee gives the overall fee, while fee_breakup provides granular insights like platform and network fees.
Network and Wallet Address:
- Ensure that the withdraw_address and network match the user's intended withdrawal details.
Use Cases:
- Monitor the transaction progress.
- Provide detailed insights to users about their transaction history.

This API allows comprehensive tracking of on-ramp transactions and is essential for maintaining transparency and user trust.

Check more details about this API endpoint here.