Skip to main content

Getting started

The vipaso SDK contains the well-tested implementation for vipasos Pay and PoS solutions. With the help of the SDK, client-side developers can create iOS and Android applications that can initiate and execute payment transactions while the Pay and PoS sides can transfer payment information via BLE (Bluetooth Low Energy).

SDK binaries and sample apps​

Installation​

iOS​

Token Security

Never commit tokens to any repository (public or private).

  • Always source tokens from environment variables.
  • Add tokens to .gitignore and your CI/CD secrets.
  • Hardcoded tokens in code will lead to security breaches.

SPM

To make things easier, we use Swift Package Manager with a private repository. Once you are provided with the necessary credentials, you can include the framework as a Swift Package Manager package by using the git repo url.

https://oauth2:YOUR_TOKEN@gitlab.com:vipaso/horizon/ios/vipaso-sdk.git

CocoaPods

The vipaso SDK is also available with CocoaPods through a private spec repo. The installation in this case is as follows.

  1. Adding the private specs repo to CocoaPods.
pod repo add vipaso https://oauth2:YOUR_TOKEN@gitlab.com:vipaso/horizon/ios/specs.git
  1. Adding the spec repo in the Podfile as source
source 'https://oauth2:YOUR_TOKEN@gitlab.com:vipaso/horizon/ios/specs.git'
  1. Ading the required SDK pod reference in the target section
target '<pod.target>' do
...
  pod "Vipaso", "~> 1.3.17"
...
end

Android​

Token Security

Never commit tokens to any repository (public or private).

  • Always source tokens from environment variables.
  • Add tokens to .gitignore and your CI/CD secrets.
  • Hardcoded tokens in code will lead to security breaches.

Once you are provided with the necessary credentials:

  1. Add the following to dependencyResolutionManagement in your project settings.gradle:
maven { url 'https://oauth2:YOUR_TOKEN@gitlab.com/api/v4/projects/47586488/packages/maven' }
  1. Add the following to dependencies in your module’s build.gradle:
implementation("vipaso.horizon.android:vipaso:[version]")