Skip to main content

Identifier

Ways of obtaining the identifier from the user​

Manual input​

The most basic integration is to ask the user to input their identifier when making a deposit.

TCash supports labeling the input field to customize for Vendor's usecase.

For example, if your users usually identify using their username, then when attempting a deposit, they will be asked "Please input your Username".

If your users usually use their account number, our prompt will reflect that (and optionally restrict the input field to digits only)

Anything that you ask for can be accommodated (email, phone number...)

Redirect (preferred)​

In this mode, once the user initiates a deposit to your vendor, we redirect the user to a URL supplied by you. This can be any URL you want. We recommend using a website or a deeplink that is authorized and registered to your HTTPS url. Custom URL schemes are also supported, but we need a web fallback in case the user is not on a mobile device or does not have your app installed.

Once the user is on your website, it is on you to identify who the user is. The usual case will be that your user is already logged into your app, and you have an active user session. If not, you can present the standard sign-in UI that they would use anyways.

Once you have verified the user, you redirect them back to our URL with their account identifier and your vendor id included in the URL query parameters.

For example, if your vendor id is 123 and the user's account id is 778899, you would redirect the user back to: https://voucher.tcash.me and add the query parameters toWallet=123&identifier=778899

The user will only need to do the final approval on our website and the deposit will be done.

For already logged-in users, the entire process from scanning the voucher to finally approving the transfer takes 1-2 seconds and is seamless.

Code entry in Vendor App​

Very similar to the redirect method, it is possible to kick off the deposit process from your application. Either engage the camera and instruct the user to scan the QR code, or have them type in the 9-digit code printed on their TCash voucher.

Much like in the previous case, redirect the user to the URL https://voucher.tcash.me and append the query parameters for your vendor id (toWallet) and the user's account identifier (identifier), but also include the voucher code using &code=xxx-xxx-xxx this will land the user on our website with all information pre-populated and ready to confirm the deposit.