Ansa SDK

Installation

Open the Podfile file and add pod 'AnsaCore' line of code under use_frameworks!

Manually build xcframework

Open the terminal in project folder and run following commands:

xcodebuild archive -scheme core -destination="iOS" -archivePath /tmp/xcf/ios.xcarchive -derivedDataPath /tmp/iphoneos -sdk iphoneos SKIP_INSTALL=NO

xcodebuild archive -scheme core -destination="iOS Simulator" -archivePath /tmp/xcf/iossimulator.xcarchive -derivedDataPath /tmp/iphoneos -sdk iphonesimulator SKIP_INSTALL=NO

xcodebuild -create-xcframework -framework /tmp/xcf/ios.xcarchive/Products/Library/Frameworks/core.framework -framework /tmp/xcf/iossimulator.xcarchive/Products/Library/Frameworks/core.framework -output AnsaCore.xcframework -allow-internal-distribution

How to use

First, initialize the new payment session which will create a temporary client secret (expires after 24 hours) to communicate with the Ansa API.

After the initializing payment session and obtaining the client secret key, initialize the AnsaCore SDK with the following:

AnsaCore.initialize(clientSecretKey: "CLIENT_SECRET_KEY") {
        let paymentRequest = PaymentRequest()
        paymentRequest.customerId = "CUSTOMER_ID"
        paymentRequest.totalAmount = TOTAL_AMOUNT_IN_CENTS
        
        navigationController?.pushViewController(CardBalanceViewController(paymentRequest: paymentRequest), animated: true)
}

As seen, the AnsaCore struct takes two parameters - CLIENT_SECRET_KEY (which will be used as an authorization for the API calls) and the completion handler executed after everything necessary is initialized inside the SDK.

Use the PaymentRequest and its parameters to build the object needed for the running AnsaCore SDK. customerId and totalAmount are the only two parameters that are not optional (buttonColorEnabled, buttonColorDisabled, cardBackgroundColor, etc are some of the optional parameters used for customization of the SDK).

Implement CardBalanceViewControllerDelegate will expose two methods:

1. onPaymentCompleted (triggered after successful payment)
2. onPayWithApplePay (triggered if purchase will be completed with ApplePay)

If chosen to complete the payment with the ApplePay, you will need to add ApplePay capability to your project.

After completing the payment and obtaining the ApplePay token, create new ApplePaymentToken object and make a call to the Ansa API using makePayment method:

AnsaCore.makePayment(forCustomerId customerId: String, amount: Int, applePayToken: ApplePaymentToken, _ handler: @escaping (Result<Void, AnsaNetworkError>) -> Void)

customerId - id of the customer amount - amount to pay applePayToken - newly created ApplePaymentToken object handler - callback triggered after success/failure response from Ansa API

Exposed SDK methods

AnsaCore.getCustomer(id: String) async -> Result<Customer, AnsaNetworkError>

customerId - id of the customer Customer - object returned in case of successful API call AnsaNetworkError - object returned in case of failed API call

AnsaCore.addFunds(_ funds: AddFundsDto, forCustomerId id: String) async -> Result<Funds, AnsaNetworkError>

funds - object for creating API call body id - id of the customer Funds - object returned in case of successful API call AnsaNetworkError - object returned in case of failed API call

AnsaCore.useFunds(_ funds: UseFundsDto, forCustomerId id: String) async -> Result<Funds, AnsaNetworkError>

funds - object for creating API call body id - id of the customer Funds - object returned in case of successful API call AnsaNetworkError - object returned in case of failed API call

AnsaCore.getPaymentMethods(forCustomerId id: String) async -> Result<PaymentMethodResponse, AnsaNetworkError>

id - id of the customer PaymentMethodResponse - object returned in case of successful API call AnsaNetworkError - object returned in case of failed API call