Account Overview

Developer API

Overview

BASE URL api.smartcloudpay.com In order to ensure the reasonable allocation of requested resources, all request APIs need to carry the parameter API Key, and requests without an API Key will be severely limited or not even responded. For details, please refer to the API Key chapter. API Key 


Generate Address

    header 'apikey: XYZ'
    header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/Generateaddress

Query Parameters

Parameter Description
clientid the clientid string user authentication ID
callbackurl the callbackurl string your callback URL
currency the Currency string support token TRX,BNB
basecurrency the base Currency string support USDT, TRX,BNB
amount the String Amount pay by user
email the String user email ID
mobile the String user mobile number
name the String user name
refrencenumber the String Unique refrencenumber for every transaction
Method Post

Sample Response


{
  "data": {
     "address": "TznQ31zq5Tzso969SrwZcqBAsPfTJ6Qf",
    "totalusd": "1.0000",
    "invoiceno": "zu2mhzrgiaxl",
    "price": "0.13908000",
    "amount": "7.19010600",
    "currency": "TRX",
    "basecurrency": "USDT",
    "orderno": "854585"
    "expdate": "2024-03-06 16:19:07.057"
  },
  "status": "succeed",
  "message": "Generated Successfully"
}

Create and Sign Transaction

    
    
Send Transaction

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/SendTransaction

Query Parameters

Parameter Description
URL the string representing the API base url
currency the Currency string support token USDT
address the String merchant withdrawal address
subaddress(optional) the String merchant withdrawal Sub address
secretkey the String merchant Secret Key
supercent(optional) the int64 Transfer USDT sub percent
amount the int64 Transfer USDT amount amount
Method Post

Sample Response



{
  "status": "succeed",
  "message": "Withdrwal Successful",
  "withdrwalid": "axxxx"
}

Get Account Balance



Balance by address

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/GetAccountBalance/{currency}

Query Parameters

Parameter Description
URL the string representing the API base url
currency the Currency string support token USDT
Method Get

Sample Response


{
  "data": {
    "balance": 0
  },
  "status": "succeed",
  "message": "succeed"
}

Transaction List



Get Transaction List

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/GetTransactionList/{currency}

Query Parameters

Parameter Description
URL the string representing the API base url
Currency the Currency string support token USDT
Method Get

Sample Response


{
  "data": [
    {
      "debit": 5.1891,
      "credit": 0,
      "hashcode": "s5f251462",
      "currency": "TRX",
      "paymentDate": "21/02/2024 06:54:04",
      "explorerhash": "https://tronscan.org/#/transaction/g8",
       "paymenttype": "Add Fund",
      "invoicenumber": "dya8an42u4aw"
    }
    ],
  "status": "succeed",
  "message": "succeed"
}

Create a Payment



Sending a payment form via POST


The following technical elements:


 1. The <form> and </form> tags that allow to create an HTML form.


 2. The method="POST" attribute that defines the method used for sending data.


 3. The action="https://smartcloudpay.com/paymentdo/" attribute that defines where to send the form data.

  
  Click to see Example of parameters sent to the payment gateway

Query Parameters

Parameter Description
clientid the clientid string user authentication ID
merchantid the merchantid string merchant authentication ID
callbackurl the callbackurl string your callback URL
currency the Currency string support token TRX,BNB
basecurrency the basecurrency string support USDT, TRX,BNB
amount the String Amount pay by user
email the String user email ID
mobile the String user mobile number
apikey the String merchant Api Key
refrencenumber the String Unique refrencenumber for every transaction

Sample Response

either via GET, the data is presented in the Callback URL as follows: ?orderno=value1&status=value2 



    1. orderno":"xx5625",
    2. status":"1", (0 Pending, 1 Success, 2 Partially Payment,3 Cancelled By User, 4 Timeout)

Get Withdrwal Details Status



Withdrwal Details  by Withdrawal ID

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/V1/GetWithdrwalstatus/{withdrwalid}

Query Parameters

Parameter Description
URL the string representing the API base url
withdrwalid the String Withdrawal Details by Withdrawal ID
Method Get

Sample Response


{
  "data": [
    {
      "debit": 5.1891,
      "payout": 5.1372,
      "charges": 0.0519,
      "subamt": 0,
      "walletaddress": "xxxxxxx",
      "subwalletaddress": "",
      "hashcode": "xqsssssssss",
      "subhashcode": "",
      "currency": "TRX",
      "paymentDate": "21/02/2024 06:54:04",
      "status": "Approved"
    }
  ],
  "status": "succeed",
  "message": "succeed"
}

Get Invoice Details



Invoice Details  by Order ID,Invoice ID,Reference Number

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/getinvoicedetails/{Order ID or Invoice ID or Reference Number}

Query Parameters

Parameter Description
URL the string representing the API base url
refrencenumber the String Invoice Details by Refrence Number
Method Get

Sample Response


{
  "data": {
    "paymentstatus": 4,
    "currency": "TRX",
    "orderno": "9603035",
    "amount": "7.214487",
    "merchantid": "ss",
    "createdate": "2024-02-23 16:19:47",
    "paymentamt": "5.000000",
    "remainamt": "2.214487",
    "amountusd": "1.0000",
    "mobile": "xx",
    "email": "XXXXX.com",
    "name": "XXXXXX",
    "refrencenumber": "PA1125",
    "invoiceno": "ep7m5a8pcn65"
  },
  "paymentList": [
    {
      "hashcode": "ac008a1d37e97887336a10be8f64291b7f67bfcb0cf0170ad013e79a62b4a4d",
      "amt": "5.000000"
    }
  ],
  "status": "succeed",
  "message": "succeed"
}

Check Transaction Status



Check Transaction Status by Order ID,Invoice ID,Reference Number

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/checktransactionstatus/{Order ID or Invoice ID or Reference Number}

Query Parameters

Parameter Description
URL the string representing the API base url
refrencenumber the String Invoice Details by Order ID, Invoice ID, Reference Number
Method Get

Sample Response


{
    "data": {
        "paymentstatus": 1
    },
    "status": "succeed",
    "message": "succeed"
}

Merchant Currency



Check Merchant Currency by Merchant ID

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/Getmerchnatcurrency

Query Parameters

Parameter Description
URL the string representing the API base url
Method Get

Sample Response


{
    "data": [
        {
            "currency": "TRX"
        },
        {
            "currency": "BNB"
        }
    ],
    "status": "succeed",
    "message": "succeed"
}

Invoice Cancelled



Invoice Cancelled   by Order ID,Invoice ID,Reference Number

    header 'apikey: XYZ'
     header 'merchantid: XYZ'
    header 'content-type: application/json'
    /api/v1/Ordercancel/{Order ID,Invoice ID,Reference Number}

Query Parameters

Parameter Description
URL the string representing the API base url
orderid the String Invoice Details by Order ID, Invoice ID, Reference Number
Method Post

Sample Response


{
    "status": "succeed",
    "message": "Cancelled  Successfully"
}