Crypttp-android
Environment
Java 1.6+
min SDK - 16, target 29
Installation
1. In the end of root build.gradle add the following code
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
2. In the app/build.gradle file add dependency
implementation 'com.github.Crypttp:crypttp-android-sdk:v0.0.1-alpha01'
implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.61"
The latest version you can find at project GitHub
3. Register deeplink schema in AndroidManifest.xml
Add the following code between <activity>
tags
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data
android:host="crypttp"
android:pathPrefix=""
android:scheme="crypttp"
tools:ignore="AppLinkUrlError" />
<data
android:host="crypttp.com"
android:pathPrefix="/crypttp"
android:scheme="http" />
<data
android:host="crypttp.com"
android:pathPrefix="/crypttp"
android:scheme="https" />
<!-- register your app deeplink -->
<data
android:host="crypttp"
android:pathPrefix=""
android:scheme="yourappname" />
</intent-filter>
Or if you already have <intent-filter>
that handle your personal App deeplink add only new handlers
<data
android:host="crypttp"
android:pathPrefix=""
android:scheme="crypttp"
tools:ignore="AppLinkUrlError" />
<data
android:host="crypttp.com"
android:pathPrefix="/crypttp"
android:scheme="http" />
<data
android:host="crypttp.com"
android:pathPrefix="/crypttp"
android:scheme="https" />
<!-- register your app deeplink -->
<data
android:host="crypttp"
android:pathPrefix=""
android:scheme="yourappname" />
3. Register your app link in Crypttp system
Signup at Dashboard
Navigate to Settings/Wallet App
Set:
-
Name
-
Deeplink
-
Discription
-
Icon
-
Available currencies
-
Urls to AppStore
In addition this configuration will help us promote your wallet app.
Every user that has no wallet installed while paying at Crypttp merchants will be redirected to a special page where user can find featured wallets
4. Register first install handler
Get your merchant id in dashboard
val openURL = Intent(android.content.Intent.ACTION_VIEW)
openURL.data = Uri.parse("https://api.crypttp.com/track/installation?id=<your merchant id>")
startActivity(openURL)
Usage
1.
SDK methods are called through the Crypttp class.
Example of deeplink parsing method
Crypttp.parseCrypttpDeepLink(intent) { params: CrypttpTransactions? ->
if (params != null) {
//TODO handle params
}
}
returned value
data class CrypttpTransactions(
val transactionId: String,
val transactions: List<CrypttpTransactionInfo>
)
data class CrypttpTransactionInfo(
val coin: String,
val amount: String,
val to: String,
val payload: String,
val memo: String,
val onSuccessUrl: String,
val onFailureUrl: String
)
2.
In your successfull transaction handler add the following code:
Crypttp.sendTransactionHashAsync(
"transactionId",
"transactionHash"
) {
if (it is Response.Success) {
}
}
This method help us track paid transactions and provide statistics to our merchants.
Which in turn helps attract new merchants.
3.
After step 2.
add code to return user to the webpage or app from where user was routed to wallet.
That is important to provide good UX and to let merchant know that transaction was successfully made or failed.
val openURL = Intent(android.content.Intent.ACTION_VIEW)
openURL.data = Uri.parse(onSuccessUrl)
startActivity(openURL)
val openURL = Intent(android.content.Intent.ACTION_VIEW)
openURL.data = Uri.parse(onFailureUrl)
startActivity(openURL)