SDK Swift pour iOS
Le kit de développement (SDK) KKiaPay pour Swift est conçu afin de permettre l'intégration de notre plugin au sein de votre application mobile de la manière la plus simplifiée possible.
Après avoir créé votre compte KKiaPay sur la plateforme kkiapay.me, vous aurez besoin de créer une instance de KKiaPay en procédant comme suit :
- Ajouter le SDK Swift de KKiaPay dans votre application
Vous pouvez ajouter le SDK Swift de KKiaPay à votre projet en utilisant le gestionnaire de packages de Swift.
- Importer le package KKiaPay
L'intégration du SDK KKiaPay se fait simplement et rapidement via npm :
import KKiaPaySDK;
- Créer un modèle à utiliser ultérieurement
@ObservedObject var viewModel = KKiaPayViewModel()
- Ajouter une instance de KKiaPay
private var kkiaPay: KKiaPay{
KKiaPay(amount: "3000",
phone: "22997000000",
data: "Hello world",
publicAPIKey: "xxxxxxxxxxxxxxxxxxx",
sandbox: true,//set this to false in production
theme: "#4E6BFC",
name: "John Doe",
email:"[email protected]",
callback: "https://redirect.kkiapay.com",
viewModel:viewModel
)
}
Paramètres | Type | Description |
---|---|---|
amount | Numeric | Le montant à payer en FCFA |
phone | String | Un numéro mobile money valide |
data | String | La donnée ou information liée à une transaction et interprétable par votre système |
publicAPIKey | String | |
name | String | Les nom et prénoms de l’initiateur du paiement |
email | String | L’adresse mail de l’initiateur du paiement |
sandbox | Boolean | Vous permet de basculer de l'environnement de test à l'environnement de production. La valeur true de cet attribut signifie que vous êtes en environnement de test |
callback | Function | La fonction de callback appelée uniquement lorsque le paiement est effectué avec succès |
Important !
Afin d'éviter toute fraude, procédez à la vérification côté serveur de l'opération de transaction. Pour cela, apprenez-en plus sur les SDKs Serveurs.
Vous pouvez souscrire aux événements liés à l'opération de paiement avec la fonction onReceive. Pour être notifié du statut réussi d'une opération de paiement, vous pouvez procéder comme suit :
kkiaPay.onReceive(self.viewModel.paymentData.receive(on: RunLoop.main)){paymentData in
if(paymentData.isSuccessful){
print("The amount of the transaction is " + paymentData.amount+" with id "+paymentData.transactionId)
showWebView = false
}else{
print("The payment was not successful")
}
}
import SwiftUI
import KKiaPaySDK
struct ContentView: View {
//Create a view model instance to use later
@ObservedObject var viewModel = KKiaPayViewModel()
@State private var showWebView = false
//Initialise the Kkiapay Instance
private var kkiaPay: KKiaPay{
KKiaPay(amount: "3000",
phone: "97000000",
data: "Hello world",
publicAPIKey: "xxxxxxxxxxxxxxxxxxx",
sandbox: true,//set this to false in production
theme: "#4E6BFC",
name: "John Doe",
email:"[email protected]",
callback: "https://redirect.kkiapay.com",
viewModel:viewModel
)
}
var body: some View {
Button {
showWebView.toggle()
} label: {
Text("Pay")
}
.sheet(isPresented: $showWebView) {
//Get the transaction data back
kkiaPay.onReceive(self.viewModel.paymentData.receive(on: RunLoop.main)){paymentData in
if(paymentData.isSuccessful){
print("The amount of the transaction is " + paymentData.amount+" with id "+paymentData.transactionId)
showWebView = false
}else{
print("The payment was not successful")
}
}
}
}
}
struct ContentView_Previews: PreviewProvider {
static var previews: some View {
ContentView()
}
}
Last modified 4mo ago