First step

Developers must first configure the transaction fee rate，More about create fee rate refer here，
If you have already set it up, please skip this step.

request example

Second step

Initiate a transfer to WSPN's bank account（ '66354543543544' with Green Link Digital Bank PTE LTD） and obtain the bank receipt.

Third step

Use the UploadFile API to upload the bank receipt. you can get fileId from reponse.

Fourth step

Initiate a payment request to perform OnRamp crediting, more info you can refer here
the greenLinkVA must be Yes, and the fileId you can obtain from Third step. the referenceNo you can use 'receipt transaction no'

request example

response example

{
    "retcode": "200",
    "retdata": {
        "id": 956,
        "txNo": "TR202601080541452855",
        "clientId": 600002644,
        "requestId": "d3a4e1f0-9b2c-4d5e-8f3a-202601071642",
        "fromCurrency": "USD",
        "toCurrency": "WUSD",
        "amount": 20,
        "reallyAmount": 20.00,
        "totalFee": 0.00,
        "walletTo": "0x6EC8DB49D3fC8a47e4Ba3E27214f8975E791BDEa",
        "requestType": 1,
        "status": 2,
        "rate": 1
    },
    "success": true
}

Final step

If the transaction is approved, you will receive a designated email and a transaction success webhook. At this point, you only need to call the transaction details interface for confirmation.
Call the query request to check the transaction execution result

example request

example response

{
    "retcode": "200",
    "retdata": {
        "status": "Completed",
        "paymentRequest": {
            "id": 687,
            "txNo": "TR202510310621563495",
            "clientId": 600002476,
            "requestId": "d3a4e1f0-9b3c-4d5e-8f3a-1b2c3d4f5435",
            "fromCurrency": "USD",
            "toCurrency": "WUSD",
            "amount": 100.00000000,
            "reallyAmount": 100.00000000,
            "totalFee": 0E-8,
            "walletTo": "0x8D33153772DDe6e6eaF21E6217777f867d08519C",
            "requestType": 1,
            "status": 3,
            "createdAt": "2025-10-31T06:21:56.302186",
            "gasFee": 0.00004584
        },
        "paymentFund": {
            "id": 368,
            "clientId": 600002476,
            "requestId": "624d4b3c-5eff-4d79-a9ed-351edac778d6",
            "currency": "USD",
            "fundType": "Fiat",
            "amount": 100.00000000,
            "depositId": "624d4b3c-5eff-4d79-a9ed-351edac778d6",
            "amountLimit": 20.00000000,
            "status": "Executed"
        },
        "executeLegs": [
            {
                "id": 1285,
                "requestId": 687,
                "legType": 1,
                "fromCurrency": "USD",
                "toCurrency": "WUSD",
                "channel": "cmsCryptoWithdrawExecutor",
                "stage": 2,
                "routeId": 11,
                "status": 4
            },
            {
                "id": 1286,
                "requestId": 687,
                "legType": 1,
                "fromCurrency": "USD",
                "toCurrency": "WUSD",
                "channel": "cmsOnRampExecutor",
                "stage": 1,
                "routeId": 11,
                "status": 3
            }
        ]
    },
    "success": true
}

If the status is "Completed", it means this OnRamp transaction has succeeded.You can view the enums of ClientStatus here.

create on-ramp whit wusd

First step#

request example#

Second step#

Third step#

Fourth step#

request example#

response example#

Final step#

example request#

example response#

First step

request example

Second step

Third step

Fourth step

request example

response example

Final step

example request

example response