Developer FAQs

1\ how much time it takes to integrate widget ? it will take a maximum of 1 hour if clients have a clear idea of how they want to execute and have the following basics covered a functioning app list of tokens and blockchains to set up with kyc flow needed or not designs and logics for how clients want to act based on the widget events that onmeta streams in webhook 2\ how can we set up the list of tokens we want in our widget? you can set up the list of tokens that you want by using the “search coins” section of the onmeta https //dashboard onmeta in/ 3\ does the widget have a default token list? if you don’t select any tokens then the default token list of the widget will appear the tokens setup as default include the following usdc, usdt, wbtc, weth, plot, matic, ps1, ufarm, bnb, bolt usds 4\ what is the chain id of a blockchain? chain id is a symbol that is passed over a network during a handshake and allows nodes not to connect to the nodes of other networks 5\ where can we find the chain id of different networks? you can find the different chain id's https //chainlist org/ 6\ where do we find the api keys? you can find the api keys inside the developer section of the onmeta dashboard 7\ do you provide a sandbox environment for testing? yes we provide a staging environment to test the widget you can access staging environment api keys by creating an account https //stg dashboard onmeta in/ you can integrate the staging widget by using this http //documentation link 8\ do you have integration support? yes, we support integration queries via whatsapp and telegram channels you can also book calendly meetings with our technical experts with a short notice 9\ do you have go live tech support? yes, one of your technical experts verifies the integration done by clients for good practices and gives a thumbs up for going live our experts are also available for discussions and help immediately before going live 10\ how can customers reach out to you if there is a technical problem with their order? we have a live chat widget using which customers can raise queries to us the live chat widget can be accessed by clicking the hamburger menu in the top right corner 11\ is the widget customizable? what options do you provide? our widget is customizable for your needs in more ways than one following are some of the customizations that we provide and clients can choose based on their needs onramp or offramp or both choose to use the kyc in our widget or use your own kyc customized the list of exact tokens that you want option to “whitelist” end user emails so users don’t end up going through otp verification every time they login option to initialize the widget with wallet address so that the customers don't need to type the same choose upi or bank transfer option or both 12\ how to customize whether i need onramp or offramp or both? you can check the "customizing widget" section in the onmeta widget integration documentation 13\ how to initialize the widget with customers wallet address for the onramp flow? you can initialize the widget with customers wallet address by passing an additional parameter in the widget script called "walletaddress" with the address of the end users wallet 14\ do our customers need to go through your login module? no, you can customize so that your users don't have to login you can initialize the widget with customers email address by passing an additional parameter in the widget script called "useremail" with the email address of the user 15\ do our customers need to go through your kyc module? not mandatory by default we keep our kyc module turned off in the widget if you feel the need to use our kyc module then reach out to us at or ask us in the telegram or whatsapp channel that we created for the purpose of integration 16\ who is your kyc partner? we currently use the kyc module of hyperverge we are happy to make an introduction to them if you want to directly integrate with them 17\ what are the kyc checks that you do? for indian market we verify the pan, aadhaar and do a face match of selfie and the photo from your pan 18\ is your kyc real time? yes we support real time kyc and it can be completed within a minute typically 19\ what is the fallback if user kyc doesn’t go through? you or the end user can email us the kyc documents at and we will get your account verified manually 20\ is the user data safe with onmeta? yes, we have incorporated industry standard security measures to protect the end users data 21\ how frequently your quote gets updated? the quote gets updated every 15 seconds or when the user changes the input 22\ what user security measures do you have to prevent losses due to token value fluctuations? we have setup slippage fee limits in our transactions with the central and decentralized exchanges to limit the losses our customers might face due to market effects 23\ what is the slippage fee? slippage fee is the difference (in %) between the quantity of token we promise to give in the quote and the quantity of token that we eventually deliver to you our slippage fee is typically less than 0 5% 24\ how much is the gas fee? are you customizing the gas fees for different blockchains? gas fee varies from chain to chain it is calculated by using the combination of the gas price and the gas units needed to process the transaction we fetch live gas price and gas units to enable fast transactions on your behalf 25\ does onmeta deduct tds from end user? if so, how much? we deduct tds only for offramp transactions tds is 1% based on the latest ruling by the government of india 26\ how can a seller reconcile the tds onmeta deducted on behalf of him? we will provide invoices for every offramp transaction made with onmeta along with a yearly summary of the transactions with our platform 27\ what payment methods are supported? how can i customize the methods? you can find the payment methods that we support in different geographies and our default onramp & offramp commission here 28\ what is utr? utr means unique transaction reference this is a number that the remittance bank account issues for the fiat amount that you transfer to us it is typically present in the sms confirmation that the bank sends for the transaction made by you 29\ do you allow the reuse of the same utr for a new order? we allow an user to place another order with the same utr only if the order associated with the utr is “canceled” typically an order gets canceled if the amount mentioned by the user in the widget is different from the amount transferred we allow this so the user is able to use the genuinely transferred money to place a fresh order 30\ where can the users find utr? unique transaction reference (utr) is typically a 12 digit number for upi transactions this can be found in the sms messages that users receive from their upi providers 31\ do you do validation of utr entered? we currently validate if the utr entered is in the valid utr format for upi transactions 32\ what should users do if they enter a wrong utr? after entering the utr, you would typically be waiting for the payment confirmation in this screen there is an option reenter utr and submit again 33\ is the utr case sensitive? tba 34\ what is onmeta's average transaction processing time? average time to process an order is less than 1 minutes we do face certain delays from the blockchain in executing the transaction during peak hours but we are constantly evolving our product with best practices to give you the quickest possible transaction time 35\ what are the different payment states possible and their definition? states description fiatpending yet to receive payment with that utr fiatreceived fiat payment received, starting token movement orderreceived crypto transaction started transferred tokens are moved to the receiver wallet address completed there is at least 1 block confirmation in the blockchain after transferred state expired order which was in fiatpending state for too long will be moved to expired state (this is still work in progress) cancelled when order amounts don't match, i e paid amount for that utr and the amount requested in the order don't match, usually users can retry again with the same utr for a new order refundinitiated when payment is received from invalid payment method (unverified upi id or bank accounts) that order will be moved to refunding state refunded once we refund the amount back to source account it will move to this refund complete step as refunded 36\ what are the different payment related events in the widget? where do i listen to these events? we stream order success and failure events you can listen to these events by using the call back functions that get called when the event is fired 37\ what are the offramp event states and their description ? states description orderreceived we received the order its under processing pending waiting for the tokens to be received to our wallet and for api requests waiting for transaction hash of completed transfer refundinitiated mismatch in token received or quantity of tokens received hence refund of received tokens has been initiated refunded refund of received tokens has been done fiatfailed fiat payment has failed, reasons might beaccount has issues accepting payments during the payout time or any other bank related issue fiatpending fiat is yet to be transferred to the receiver bank account completed order has been completed and money has been paid out to the receiver bank account 38\ how do we integrate solana to our product our tech stack will remain same no matter what chain we add , we want our users to make minimal changes to adopt new chains in their product , so to use solana chain the only change you need make is i for widget enabled required solana token from your dashboard and once its done refresh your widget page it should show in dropdown list ii for api you need to use chainid 102 for staging and 101 for production , with respective token symbol and its smart contract address and create the orders sample api request for sol token on staging environment is below note solana is non evm chain hence its wallet address will be different so kindly double check the wallet adderss so that it won't credit to wrong addres 39\ bank account link status and their definitions status remarks pending pending state, validation is in progress success successfully linked bank account of the user failed failed to link bank account due to wrong ifsc code or account number or name mismatch 40\ minimum amount for each chains minimum amount polygon, ton 100 inr/php bsc 500 inr/php ethereum 1000 inr/php avalanche, solana,immutable,gnosis,arbitrum,klayton,hedera 100 inr/php for ethereum based on gas fee minimum amount changes 41\