Skip to content

christophertino/rize-swift-sdk

Repository files navigation


Rize Swift SDK

Rize makes financial services simple and accessible by enabling fintechs, financial institutions and brands to build across multiple account types with one API. The Rize Swift SDK enables access to all platform services in our sandbox, integration and production environments.

When you're ready to build, open a sandbox environment. If you have questions, feedback, or a use case you want to discuss with us, contact us at [email protected].

For more information, check out our Platform API Documentation.

Supported iOS Versions

The Rize Swift SDK is compatible with the two most recent, major iOS releases.

We currently support iOS v15 and higher.

Getting Started

Configuration

The SDK requires program configuration credentials in order to interact with the API.

You can find these in the Rize Admin Portal.

Parameter Description Default
HMACKey HMAC key for the target environment ""
ProgramUID Program UID for the target environment ""
Environment The Rize environment to be used:
"sandbox", "integration" or "production"
"sandbox"

Add the SDK as a Package Dependency

Add the Rize Swift SDK to your project using Swift Package Manager.

.package(url: "https://github.com/RizeFinance/rize-swift-sdk", from: "1.0.0")

Import and Initialize

import RizeSDK

struct Rize {
	static var client: RizeSDK?
	static var config: RizeConfig?

	init() {
		self.config = try? RizeConfig(
			programUID: "PROGRAM_UID",
			hmacKey: "HMAC_KEY",
			environment: RizeEnvironments.sandbox
		)
		self.client = RizeSDK(config: self.config!)
	}

	func getCustomer(uid: String) async -> Customer? {
		let customer = try? await RizeSDK.client?.customers.get(uid: uid)
	}
}

Tests

Configure SwiftLint (optional)

$ brew install swiftlint

# Set xcode-select path
$ xcode-select -s /Applications/Xcode.app/Contents/Developer/

Add a new Run Script to the Build phase of the RizeSDK scheme:

Product Menu > Edit Scheme > Build > Pre-Action > Add > New Run Script Action

if which swiftlint > /dev/null; then
  swiftlint
fi

Run Mock Server API

The SDK uses Prism as a mock server for validation testing. You must start the Docker container before running the SDK tests.

$ docker compose up

Documentation

License

MIT License. Copyright 2023-Present Rize Money, Inc. All rights reserved.

See LICENSE

About

Swift SDK for consuming the Rize Platform API's

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages