)
)
)
```
{% endhint %}
**2.3 Complete the payment on your app**
**Fetch a Payment**
Request your server to fetch a payment as soon as your view is loaded. Store the `sdkAuthorization` returned by your server. The `PaymentSession` will use this secret to complete the payment process.
{% hint style="danger" %}
**Important**: Make sure to never share your API key with your client application as this could potentially compromise your security.
{% endhint %}
{% tabs %}
{% tab title="Swift" %}
```swift
let paymentSessionConfiguration = PaymentSessionConfiguration(
sdkAuthorization: sdkAuthorization
)
let paymentSession = hyperswitch.initPaymentSession(
configuration: paymentSessionConfiguration
)
```
{% endtab %}
{% endtabs %}
**Handle Payment Result**
Handle the payment result in the completion block and display appropriate messages to your customer based on whether the payment fails with an error or succeeds.
{% tabs %}
{% tab title="Swift" %}
```swift
@objc
func openPaymentSheet(_ sender: Any) { //present payment shee
var configuration = PaymentSheet.Configuration()
configuration.merchantDisplayName = "Example, Inc."
// Optional theming
var appearance = PaymentSheet.Appearance()
appearance.font.base = UIFont(name: "montserrat", size: UIFont.systemFontSize)
appearance.shapes.shadow = .disabled
appearance.colors.primary = UIColor(red: 0.55, green: 0.74, blue: 0.00, alpha: 1.00)
appearance.primaryButton.shapes.borderRadius = 32
configuration.appearance = appearance
// Optional: enable native 3DS challenges inside the sheet
configuration.netceteraSDKApiKey = netceteraApiKey
paymentSession.presentPaymentSheet(
viewController: self,
configuration: configuration,
subscribe: { builder in // optional event subscription
builder.on(.paymentMethodInfoCard) { event in
if case .cardInfo(let info) = event.data {
print(info)
}
}
},
completion: { result in
DispatchQueue.main.async {
switch result {
case .completed: print("Payment complete")
case .failed(let error): print("Payment failed: \(error)")
case .canceled: print("Payment canceled")
}
}
}
)
}
```
{% hint style="danger" %}
Please retrieve the payment status from the Hyperswitch backend to get the terminal status of the payment. Do not rely solely on the status returned by the SDK, as it may not always reflect the final state of the transaction.
{% endhint %}
{% endtab %}
{% tab title="SwiftUI" %}
```swift
VStack {
if let paymentSession = model.paymentSession {
PaymentSheet.PaymentButton(paymentSession: paymentSession,
configuration: configuration(),
onCompletion: model.onPaymentCompletion)
{
Text("Hyper Payment Sheet")
.padding()
.background(.blue)
.foregroundColor(.white)
.cornerRadius(10.0)
}
if let result = model.paymentResult {
switch result {
case .completed:
Text("Payment complete")
case .failed(let error):
Text("Payment failed: \(error.domain)")
case .canceled:
Text("Payment canceled.")
}
}
}
}.onAppear { model.preparePaymentSheet() }
// handle result
func onPaymentCompletion(result: PaymentSheetResult) {
DispatchQueue.main.async {
self.paymentResult = result
}
}
// setup configuration for payment sheet
func configuration() -> PaymentSheet.Configuration {
var configuration = PaymentSheet.Configuration()
configuration.merchantDisplayName = "Example, Inc."
return configuration
}
```
{% endtab %}
{% endtabs %}
#### 3. Card Element (Beta)
Create a card element view and pay button and handle the payment result in the completion block and display appropriate messages to your customer based on whether the payment fails with an error or succeeds.
{% tabs %}
{% tab title="Swift" %}
//Create a card element view and pay button.
lazy var hyperCardTextField: PaymentCardTextField = {
let cardTextField = PaymentCardTextField()
return cardTextField
}()
lazy var payButton: UIButton = {
let button = UIButton(type: .custom)
button.layer.cornerRadius = 5
button.backgroundColor = .systemBlue
button.setTitle("Pay", for: .normal)
button.addTarget(self, action: #selector(pay), for: .touchUpInside)
return button
}()
@objc
func pay() {
guard let paymentIntentClientSecret = model.paymentIntentClientSecret else {
return
}
let paymentIntentParams = PaymentIntentParams(clientSecret: paymentIntentClientSecret)
let paymentHandler = PaymentHandler.shared()
paymentHandler.confirmPayment(paymentIntentParams, with: self) {
(status, paymentIntent, error) in
switch (status) {
case .failed:
break
case .canceled:
break
case .succeeded:
break
@unknown default:
fatalError()
break
}
}
}
{% endtab %}
{% tab title="SwiftUI" %}
```swift
@ObservedObject var model = BackendModel()
@State var paymentMethodParams: PaymentMethodParams?
VStack {
PaymentCardTextField.Representable(paymentMethodParams: $paymentMethodParams)
.padding()
//Create a card element view and pay button.
if let paymentIntent = model.paymentIntentParams {
Button("Buy")
{
paymentIntent.paymentMethodParams = paymentMethodParams
isConfirmingPayment = true
}
.disabled(isConfirmingPayment || paymentMethodParams == nil)
.paymentConfirmationSheet(
isConfirmingPayment: $isConfirmingPayment,
paymentIntentParams: paymentIntent,
onCompletion: model.onCompletion
)
}
else {
ProgressView()
}
if let paymentStatus = model.paymentStatus {
PaymentHandlerStatusView(actionStatus: paymentStatus,
lastPaymentError: model.lastPaymentError)
}
}.onAppear { model.preparePaymentIntent() }
```
{% endtab %}
{% endtabs %}
Congratulations! Now that you have integrated the iOS SDK, you can customize the payment sheet to blend with the rest of your app.
#### Next Step:
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.hyperswitch.io/integration-guide/payment-experience/pay-then-vault/mobile/ios/swift-with-rest-api-integration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.