SDK > iOS | Payment Gateway

iOS

iOS is an operating system developed by Apple Inc. for mobile devices, such as iPhone, iPad, and iPod Touch.

iOS is based on a Unix platform and provides a secure and protected environment, preventing the execution of unauthorized applications.

You can download the XPay SDK for iOS provided by Nexi from the following GitHub repository:

iOS SDK XPay

ATTENTION: merchants are responsible for the proper and secure storage of their API keys. These should not be stored within the client app but must be securely requested and exchanged between the app and the merchant's server.

Installation

To use the XPay SDK, you need to add it as a dependency to your application and create the XPay client:

Hosted Payment Page

The following method refers to the API POST /orders/hpp.

A WebView is opened containing the XPay checkout page:

                                    do{
orderHppWithWebViewButton.loadIndicator(true)
let res = try await ngpclient!.CreateOrderHPPWebView(param:createMockedOrderRequestWebView(),
cbResultOk: { (op)->Void in
do{
// handle successful response
}
},
cbResultCancel: { (error)->Void in
do{
// handle cancel response
}
},
controller:self)
}
catch let e as ClientException {
// Handle exception
}
catch let e as UnauthorizedException {
// Handle exception
}
catch let e as ServerErrorException {
// Handle exception
}
catch let e{
// Handle exception
}
                                

To independently choose the WebView for displaying the checkout page, you need to use the following method: it returns the link to the XPay checkout page to be displayed in the WebView.

                                    do{
let req: CreateHostedFieldOrderRequest // initialize the request
let res = try await ngpclient!.CreateOrderHPP(param: req)
}
catch let e as ClientException {
// Handle exception
}
catch let e as UnauthorizedException {
// Handle exception
}
catch let e as ServerErrorException {
// Handle exception
}
catch{
// Handle exception
}
                                

Get Payments Methods

The following method refers to the API POST /payment_methods.

The list of payment methods supported by the merchant's terminal is returned along with their associated attributes.

                                    do{
let req: PaymentMethodsResponse // initialize the request
let res = try await ngpclient!.GetPaymentMethods()
}
catch let e as ClientException {
// Handle exception
}
catch let e as UnauthorizedException {
// Handle exception
}
catch let e as ServerErrorException {
// Handle exception
}
catch{
// Handle exception
}
                                

                                    @IBOutlet weak var cardData: Card2LinesForm!
func twoStepsOrder() async throws{
let req: ThreeDSInitRequest // initialize the request
do{
try await cardData.twoStepsOrder(sdk: ngpclient!, param: req,
cbResultOk: { (op)->Void in
do{
// handle successful response
}
},
cbResultCancel: { (error)->Void in
do{
// handle cancel response
}
},
controller:self)
}
catch let e as ClientException {
// Handle exception
}
catch let e as UnauthorizedException {
// Handle exception
}
catch let e as ServerErrorException {
// Handle exception
}
catch let e {
// Handle exception
}
}
                                

3 Step payment

The following method refers to the Payment 3 Steps solution.

It allows making payments through card with 3D Secure authentication, in Server-to-Server mode.

Server-to-Server solutions are subject to obtaining PCI DSS security certification (SAQ D questionnaire).

To use this functionality, you need to add a new view to your storyboard and add the Card2LinesForm class, then associate it with the controller.

                                    @IBOutlet weak var cardData: Card2LinesForm!
func threeStepsOrder() async throws{
let req: ThreeDSInitRequest // initialize the request
do{
try await cardData.threeStepsOrder(sdk: ngpclient!, param: req,
cbResultOk: { (op)->Void in
do{
// handle successful response
}
},
cbResultCancel: { (error)->Void in
do{
// handle cancel response
}
},
controller:self)
}
catch let e as ClientException {
// Handle exception
}
catch let e as UnauthorizedException {
// Handle exception
}
catch let e as ServerErrorException {
// Handle exception
}
catch let e {
// Handle exception
}
}
                                

Card Verification

The following method refers to the Card Verification solution.

It performs a card verification operation, without any charge, solely to confirm the validity of the card data entered by the customer.

Server-to-Server solutions are subject to obtaining PCI DSS security certification (SAQ D questionnaire).

                                    do{
let req: CardVerificationRequest // initialize the request
let responses = try await ngpclient!.CardVerification(param: req)
}
catch let e as ClientException {
// Handle exception
}
catch let e as UnauthorizedException {
// Handle exception
}
catch let e as ServerErrorException {
// Handle exception
}
catch{
// Handle exception
}
                                

M.O.T.O.

The following method refers to the API POST /orders/moto.

It performs a M.O.T.O payment: a payment made in Server-to-Server mode, where the cardholder's 3D Secure authentication is not required. It is intended for those who want to integrate the authorization request function for credit card payments, where the cardholder's data has been communicated to the merchant via email, phone, etc.

Server-to-Server solutions are subject to obtaining PCI DSS security certification (SAQ D questionnaire).

                                    do{
let res = try await ngpclient!.moto(param:createMotoRequest())
}
catch let e as ClientException {
// Handle exception
}
catch let e as UnauthorizedException {
// Handle exception
}
catch let e as ServerErrorException {
// Handle exception
}
catch let e{
// Handle exception
}
                                