Fiat Deposit & Verification
The ToroForge SDK allows registered projects to receive fiat currency deposits into user wallets on the Toronet blockchain, including NGN, USD, EUR, KSH, and more.
This process mimics traditional banking UX, but settles the value directly on-chain.
π§ How It Works
User initiates a deposit with an amount and currency.
SDK returns bank account details for transfer or payment link.
User completes the payment (via card, bank, or wire).
Admin calls verify deposit using the returned transaction ID.
The wallet is funded automatically on Toronet.
βοΈ Requirements
Before you can use these features:
You must register your project on https://payments.connectw.com.
You will receive:
Admin Wallet Address
Admin Wallet Password
These credentials are passed into the SDK methods.
π Initialize a Deposit
import { depositFunds, Currency } from 'torosdk';
const depositInfo = await depositFunds({
userAddress: '0xWalletAddress',
username: 'torousername',
amount: '1000',
currency: Currency.Naira,
admin: 'adminWalletAddress',
adminpwd: 'adminPassword',
});
π Supported Currencies (Currency
Enum)
Currency
Enum)enum Currency {
Naira = "NGN",
Dollar = "USD",
Euro = "EUR",
Pound = "GBP",
Kenyan_Shilling = "KSH",
South_African_Rand = "ZAR",
}
π¦ Response Example
{
"paymentlink": "https://connectw.com/pay/...",
"accountnumber": "2039932299",
"bankname": "ExampleBank",
"amount": "1000",
"txid": "TX10294-TORO"
}
Use either the paymentlink
or show the account number and bank name to the user.
π₯ Verify Deposit
Once the user completes payment, you can finalize it:
import { verifyDeposit } from 'torosdk';
const success = await verifyDeposit({
currency: 'NGN',
txid: 'TX10294-TORO',
});
If the verification is successful, the Toronet wallet is funded immediately.
π§© Use Cases
Add fiat onboarding to Web3 apps
Enable wallet top-ups in localized currency (NGN, KSH, etc.)
Integrate verified deposit flows into financial platforms or fintech apps
β οΈ Notes & Best Practices
Always validate that a
txid
is returned before verifying.Store returned
txid
and map to your internal transaction logs.For higher amounts, KYC verification may be required (see KYC & Identity).
π Related Docs
Last updated