POST /api/transaction/mint-request

Use this API to request a IDRX minting transaction in one of our supported chains.

Parameters

1. toBeMinted (String):

   This parameter represents the amount or quantity of tokens that the user wishes to mint.

2. destinationWalletAddress (String):

   This parameter refers to the wallet address where the newly minted tokens will be transferred. It represents the recipient's digital wallet on the blockchain network.

3. networkChainId (String):

   This parameter identifies the blockchain network on which the minting request is being made. Each blockchain network has a unique identifier known as the chain ID, which helps in distinguishing between different networks (e.g. Polygon or BNB Smart Chain).

4. expiryPeriod(Number):

   This parameter sets the expiry duration of the payment.

5. requestType(String): This parameter is optional, you can leave it empty, or "idrx" for a idrx minting request. You can put "usdt" in this parameter to receive USDT in the destination wallet address.

Example Request

curl -X POST '<https://idrx.co/api/transaction/mint-request>' --header 'idrx-api-key: <API_KEY>' --header 'idrx-api-sig: <signature>' --header 'idrx-api-ts': <timestamp>'

Payload

{
  "toBeMinted": "string",
  "destinationWalletAddress": "string",
  "expiryPeriod": 0,
  "networkChainId": "string",
  "requestType": "string"
}

Response

If the request is successful, the response will be as shown below:

{
  "statusCode": 200,
  "message": "success",
  "data": {
    "id": "85",
    "merchantCode": "DS15079",
    "reference": "DS1507923DW1N5088J6LW6TO",
    "paymentUrl": "https://app-sandbox.duitku.com/redirect_checkout?reference=DS1507923DW1N5088J6LW6TO",
    "amount": "19500.00",
    "statusCode": "00",
    "statusMessage": "SUCCESS",
    "merchantOrderId": "20230321091546"
  }
}

The returned amount value will be different from the request in toBeMinted parameter. This is the amount after fees and will be the amount that the user are going to pay.

Use the payment page in paymentUrl to pay the amount required. Shortly after the payment is done, IDRX tokens will be minted and sent to the specified destination wallet address. In case of "usdt" requestType, USDT tokens will be sent to the wallet address.

To check the status of the transaction, you can use the Transaction History API.