Having obtained and configured the required Apple Developer certificates, use the Mercado Pago native SDK to integrate payment methods in iOS applications. Below we show how to install and initialize the SDK.

Follow the step-by-step to install the SDK in your Swift project.

1. In Swift Package Manager, click File > Add Package Dependencies.
2. Paste the repository URL: https://github.com/mercadopago/sdk-ios.
3. Select the desired SDK version.
4. Click Add Package to complete the installation.

Import the SDK dependencies in your project by running the following code:

plain
Copiar
import CoreMethods

After installing the SDK and adding the dependencies to your project, initialize the SDK at the start of the application lifecycle. This ensures that all essential configuration is defined before any payment operation.

To ensure correct operation, make a call to initialize() before using any other SDK functionality. To initialize the Mercado Pago library, you need to use your credentialsUnique access keys we use to identify an integration in your account, linked to your application. For more information, see the link below.Credentials, linked to the applicationEntity registered in Mercado Pago that acts as an identifier to manage your integrations. For more information, see the link below.Application details you created.

At this stage, you must use your test Public KeyPublic key of the application created in Mercado Pago, used in the frontend. You can access it in Your integrations > Application details > Test > Test credentials..

import UIKit
import CoreMethods
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, 
           didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let configuration = MercadoPagoSDK.Configuration(
            publicKey: "YOUR-PUBLIC-KEY",
            country: // Enter the country of your public key
        )
        MercadoPagoSDK.shared.initialize(configuration)
        
        return true
    }
}

import SwiftUI
import CoreMethods
@main
struct YourApp: App {
    init() {
        let configuration = MercadoPagoSDK.Configuration(
            publicKey: "<YOUR-PUBLIC-KEY>",
            country: "<Enter the country of your public key>",
            locale: "en-US"
        )
        MercadoPagoSDK.shared.initialize(configuration)
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

The initialization parameters are listed in the table below.

To enable Apple Pay in your app, configure the required capabilities in XcodeApple's integrated development environment (IDE) for creating applications for iOS, iPadOS, macOS, watchOS and tvOS.:

1. In Xcode, select the project file in the Project Navigator and the app's main Target.
2. Go to the Signing & Capabilities tab and click + Capability.
3. In the search box, type "Apple Pay" and add the capability.
4. In the Apple Pay section, select the Merchant ID you created in the Apple Developer Portal. If it does not appear, refresh the list using the circular arrow icon.

Before displaying the Apple Pay button, you need to check that the user's device is compatible and has at least one card configured in the Wallet app. To do this, run the following code.

import MPApplePay
import PassKit
import UIKit

class YourCheckoutViewController: UIViewController {
    let applePayButton: PKPaymentButton = PKPaymentButton(paymentButtonType: .plain, paymentButtonStyle: .black)
    let mpApplePay: MPApplePay = .init()

    override func viewDidLoad() {
        super.viewDidLoad()
        applePayButton.isHidden = !MPApplePay.canMakePayments()
        applePayButton.addTarget(self, action: #selector(handleApplePayButton), for: .touchUpInside)
    }
}

Button customization

You can change the button type and style in the PKPaymentButton(paymentButtonType:paymentButtonStyle:) initializer. For more appearance and Apple Pay interface options, see the official Apple documentation.

In the method that runs when the user taps the Apple Pay button, create the payment request with the transaction data, configure the summary items, and present the Apple Pay sheetModal screen that Apple shows the buyer with the payment summary, selected card, and authorization request with Touch ID or Face ID.. See the elements to complete in the table below.

@objc
func handleApplePayButton() {
    let request = MPApplePay.paymentRequest(
        withMerchantIdentifier: "merchant.your-identifier",
        currency: "BRL"
    )

    let item = PKPaymentSummaryItem(
        label: "Product name",
        amount: NSDecimalNumber(value: 10),
        type: .final
    )

    let totalItem = PKPaymentSummaryItem(
        label: "YOUR STORE",
        amount: NSDecimalNumber(value: 10),
        type: .final
    )

    request.paymentSummaryItems = [item, totalItem]

    let paymentController = PKPaymentAuthorizationController(paymentRequest: request)
    paymentController.delegate = self
    paymentController.present()
}

Implement the PKPaymentAuthorizationControllerDelegate method to receive the Apple token, convert it to a card token with the SDK, and send it to your backend.

extension YourCheckoutViewController: PKPaymentAuthorizationControllerDelegate {
    
    func paymentAuthorizationController(
        _ controller: PKPaymentAuthorizationController,
        didAuthorizePayment payment: PKPayment,
        handler completion: @escaping (PKPaymentAuthorizationResult) -> Void
    ) {
        Task {
            do {
                let response = try await mpApplePay.createToken(
                    payment.token
                )


                // send the token to your backend to process the payment
                await sendYourBackend(response.token)
                
                completion(
                    PKPaymentAuthorizationResult(
                        status: .success,
                        errors: nil
                    )
                )

            } catch {
                completion(
                    PKPaymentAuthorizationResult(
                        status: .failure,
                        errors: [error]
                    )
                )
            }
        }
    }
    
    func paymentAuthorizationControllerDidFinish(
        _ controller: PKPaymentAuthorizationController
    ) {
        controller.dismiss()
    }
}

You can simulate different payment outcomes in development by passing the status parameter when creating the token:

let response = try await mpApplePay.createToken(
    payment.token,
    status: "APRO" 
)