https://github.com/xendit/xenissuing-android
https://github.com/xendit/xenissuing-android
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/xendit/xenissuing-android
- Owner: xendit
- Created: 2022-08-02T06:50:00.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-22T08:19:47.000Z (about 2 years ago)
- Last Synced: 2024-07-22T10:00:12.204Z (about 2 years ago)
- Language: Kotlin
- Size: 232 KB
- Stars: 0
- Watchers: 10
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Xenissuing
This SDK comprises of the following modules :
- XenIssuing: this module handles encryption between XenIssuing and your Android application.
## SecureSession
SecureSession is a module to help you set up encryption between XenIssuing and your application.
### Requirements
To be able to use XenIssuing, you will need to use a private key provided by Xendit.
It includes several methods:
- `getKey` will encrypt a session key randomly generated used for asymmetric encryption with Xenissuing.
- `encrypt` would be used when setting sensitive data.
- `decryptCardData` would be used whenever receiving sensitive card data from Xenissuing.
### Usage
```android
import XenIssuing
try {
// xenKey is base64 encoded portion without headers and footers *(see example bellow)
val xenKey = Base64.encode("BASE64_PUBLIC_KEY")
val secureSession = XenIssuing.createSecureSession(xenKey);
// you can make an API call using this URL encode key
val key = secureSession.getKey() // ...3AVnPpM0CxhBHgHgX%2F0KYb0vIFg%3D%3D
val secret = apiResponse.secret
val iv = apiResponse.iv
val decrypted = secureSession.decryptCardData(secret, iv);
} catch (error: Exception) {
throw error
}
```
```
// Example of valid xenKey
val xenKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArY3DXFJ2M0EHbsD9r+2XgFVtpYEQR5bxnQZVHVxtVzQP8u2cv/1APs2cft+8E682wKGY7SFUEsFsoqxoak7qsfXYL/mOdvQe6XDyNC7N6oo9Zb8dUKtuy8qPb1bVeTbxAwDVUzIdJpiRVI69fAGCW7aF3jTAV7Q+Z5qUTaLUFyKvu3+j8u/A58Nw5fjOENTLHBZRrXhFtQC1eql2O6FiQRJBDACYtzhyFBMyT/B7SKNPkEvLm1w4AQEWxxwL93B8vxstfpatbJJvorJaDEl/glncxJVtZ0lBeB3dkWdro/TrhpPD7CHKlBIUKRfvq1TgmMFs9SP90DxD9l9mE+AUAwIDAQAB"
```