Introduction

Velocity iOS Software Development Kit Integration Guide

This document provides information to assist with the integration of the Velocity Payment Orchestration Platform (POP) software development kit (SDK) with an iOS native mobile application.

📘

Note: Integration with an Android mobile application has a similar workflow, but the details are provided in the Velocity – Android SDK – Integration Guide.

An SDK facilitates integration of Velocity POP with a native mobile application. An SDK can be integrated with both iOS and Android applications. The SDK uses asynchronous communication when transmitting data to the Velocity server or a Payment Service Provider (PSP).

The following are some features of this SDK:

  • Simple integration with a few calling methods
  • Multiple payment methods such as:
    • APM
    • Wallets
    • mVault or store card
    • Cards with 3DS and non-3DS
  • Native user interface (UI) elements
  • Application developers work with a familiar technology stack
  • Control and brand the payment screen
  • Application and POP platform communication through SDK
  • Customization of SDK depending on requirement

Version History

The following table provides a history of updates to this document.

Document VersionSDK NameSDK VersionFeatures Added
1.04mPoint2.3.1
  • FX Service for stored card and new card
  • FX Service opt-in and opt-out functionality
  • APM Integrations
    • GrabPay
    • PayMaya
    • Swish
  • Wallet Integrations: Gcash
  • Updated the following methods:
    • Handle status
    • Handle error
  • FX Service Indicator
  • Presentment Feature
  • Support for Base SDK v2.0.0
1.05mPoint2.3.2
  • Offline payment card support
  • Handled Sub-Code in URL scheme redirect
  • FX Service based routing support
  • SDK Improvements
  • Added support for base SDK v2.0.0
1.07mPoint3.5.0Introduced the following:
  • Instalment Enhancements
  • Get Transaction Status API
  • Post Status API
1.08mPoint4.0.2Introduced the following:
  • Split Payment for Voucher + Cards
  • Split Payment for Voucher + APMs
  • Split Payment for Voucher + Wallets
  • Split Payment for Cards+ Cards
  • Get Status API Improvements
  • Post Status API Improvements
1.09mPoint4.0.2Updated the template.
1.10mPoint5.0.0Updated the following:
  • Removed Deprecated methods
1.11mPoint5.1.0Updated the following:
  • Integrated PayU PSE
  • Integrated DragonPay Offline Payments
  • Requires Base SDK v 2.1.1
1.12mPoint5.2.0Updated the following:
  • Integrated Stripe
  • Integrated NMI
2.00mPoint5.2.0
  • Migrated PDF contents to website.
  • Reorganized, minor edits for online accessibility.
  • Minor corrections for clarity throughout.

Glossary of Terms

The terms used in this document are listed in the table below.

TermsDescription
CPDCellPoint Digital
HPPHosted Payment Pages
POPPayment Orchestration Platform
PSPPayment Service Provider
ACQAcquirer
MerchantAny business who sells goods or services and accepts payments from customers
CustomersThose who want to buy goods and services from merchants
APMAlternative Payment Methods
SDKSoftware Development Kit
DCCDynamic Currency Conversion
FXForeign Exchange Services