Use o SDK nativo do Mercado Pago para integrar meios de pagamento em aplicações iOS. A seguir, mostramos como fazer a instalação e a inicialização do SDK.

Consulte o passo a passo para instalar o SDK no seu projeto Swift.

1. No Swift Package Manager, clique em File > Add Package Dependencies.
2. Cole a URL do repositório: https://github.com/mercadopago/sdk-ios.
3. Selecione a versão desejada do SDK.
4. Clique em Add Package para concluir a instalação.

Importe as dependências do SDK no seu projeto executando o código a seguir:

plain
Copiar
import CoreMethods

Depois de instalar o SDK e adicionar as dependências ao seu projeto, inicialize o SDK no início do ciclo de vida da aplicação. Isso garante que todas as configurações essenciais estejam definidas antes de qualquer operação de pagamento.

Para garantir o funcionamento correto, faça uma chamada a initialize() antes de usar qualquer outra funcionalidade do SDK. Para inicializar a biblioteca do Mercado Pago, é necessário usar suas credenciaisChaves de acesso únicas que usamos para identificar uma integração na sua conta, vinculadas à sua aplicação. Para mais informações, acesse o link abaixo.Credenciais, vinculadas à aplicaçãoEntidade registrada no Mercado Pago que atua como identificador para gerenciar suas integrações. Para mais informações, acesse o link abaixo.Detalhes da aplicação criada.

Nesta etapa, você deve usar sua Public Key de testesChave pública da aplicação criada no Mercado Pago, usada no frontend. Você pode acessá-la em Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste..

Copie a Public Key de testesChave pública da aplicação criada no Mercado Pago, usada no frontend. Você pode acessá-la em Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste. e inclua-a no código a seguir. O processo de inicialização varia conforme a tecnologia usada, seja UIKit ou SwiftUI.

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: // Insira o país da sua chave pública
        )
        MercadoPagoSDK.shared.initialize(configuration)
        
        return true
    }
}

import SwiftUI
import CoreMethods
@main
struct YourApp: App {
    init() {
        let configuration = MercadoPagoSDK.Configuration(
            publicKey: "<YOUR-PUBLIC-KEY>",
            country: "<Insira o país da sua chave pública>",
            locale: "pt-BR"
        )
        MercadoPagoSDK.shared.initialize(configuration)
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Os parâmetros de inicialização estão listados na tabela a seguir.

Para habilitar o Apple Pay na sua aplicação, configure as capacidades necessárias no XcodeAmbiente de desenvolvimento integrado (IDE) da Apple para criar aplicações para iOS, iPadOS, macOS, watchOS e tvOS.:

1. No Xcode, selecione o arquivo do projeto no Project Navigator e o Target principal da aplicação.
2. Vá à aba Signing & Capabilities e clique em + Capability.
3. Na busca, digite "Apple Pay" e adicione a capacidade.
4. Na seção Apple Pay, selecione o Merchant ID que você criou no Portal Apple Developer. Se não aparecer, atualize a lista usando o ícone de seta circular.

Antes de exibir o botão do Apple Pay, é necessário verificar se o dispositivo do usuário é compatível e se tem pelo menos um cartão configurado na aplicação Wallet. Para isso, execute o código a seguir.

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)
    }
}

Personalização do botão

Você pode alterar o tipo e o estilo do botão no inicializador PKPaymentButton(paymentButtonType:paymentButtonStyle:). Para mais opções de aparência e da interface do Apple Pay, consulte a documentação oficial da Apple.

No método executado ao tocar no botão do Apple Pay, crie a solicitação de pagamento com os dados da transação, configure os itens do resumo e apresente a tela do Apple PayTela modal que a Apple exibe ao comprador com o resumo do pagamento, o cartão selecionado e a solicitação de autorização com Touch ID ou Face ID.. Consulte os elementos a preencher na tabela a seguir.

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

    let item = PKPaymentSummaryItem(
        label: "Nome do produto",
        amount: NSDecimalNumber(value: 10),
        type: .final
    )

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

    request.paymentSummaryItems = [item, totalItem]

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

Implemente o método PKPaymentAuthorizationControllerDelegate para receber o token da Apple, convertê-lo em card token com o SDK e enviá-lo ao seu 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
                )


                // envie ao seu backend o token para realizar o pagamento
                await sendYourBackend(response.token)
                
                completion(
                    PKPaymentAuthorizationResult(
                        status: .success,
                        errors: nil
                    )
                )

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

Você pode simular diferentes resultados de pagamento em desenvolvimento passando o parâmetro status ao criar o token:

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