Valide a reapresentação dos Termos e Condições da Apple no Tap to Pay iOS quando precisar testar esse fluxo no seu app.

Esse método é opcional e, em ambiente produtivo, desnecessário. Na primeira vez que a conta usa o Tap to Pay, o próprio SDK já solicita os termos e condições e exibe a view da Apple automaticamente.

① Verificar a versão do SDK  →  ② Inicializar o SDK se necessário  →  ③ Chamar processTermsAndConditions()  →  ④ Tratar sucesso e erro

Antes de começar

• Adicione o SDK iOS ao projeto em 1 - Adicionar ao projeto.
• Importe TapOnPhoneSDK no arquivo em que fará a chamada.
• Mantenha o SDK inicializado antes da chamada se estiver usando uma versão anterior à 3.4.3.

1. Chame processTermsAndConditions()

Depois de preparar o SDK conforme a versão usada no projeto, chame o método e trate os callbacks de sucesso e erro.

import UIKit
import TapOnPhoneSDK

final class TermsAndConditionsViewController: UIViewController {

    func presentAppleTermsIfNeeded() {
        TapOnPhone.processTermsAndConditions(
            onSuccess: {
                print("Fluxo de termos e condições concluído com sucesso.")
            },
            onError: { [weak self] error in
                guard self != nil else { return }

                print("SDK error - code: \(error.code.rawValue)")
                print("name: \(error.code.description)")
                print("message: \(error.message)")
            }
        )
    }
}

Saída esperada

Fluxo de termos e condições concluído com sucesso.

Saída esperada em caso de erro

SDK error - code: <codigo>
name: <nome_do_erro>
message: <mensagem_do_erro>

2. Valide a implementação

Depois de adicionar o código, valide estes pontos no app:

1. Abra a tela em que você quer validar esse comportamento.
2. Garanta que o SDK já foi preparado se sua versão for anterior à 3.4.3.
3. Chame presentAppleTermsIfNeeded().
4. Confirme que a view da Apple foi exibida.
5. Se o callback onError for acionado, registre error.code.rawValue, error.code.description e error.message.

Troubleshooting

A view não apareceu

Valide se o método foi chamado no momento esperado do teste e, para versões anteriores à 3.4.3, confirme que o SDK já estava inicializado antes da chamada.

O callback onError foi acionado

Registre error.code.rawValue, error.code.description e error.message. Esses três valores ajudam a diagnosticar a falha retornada pelo SDK.

Verificação da Conta Apple ID

Verifica se a conta Apple ID já está vinculada ao Tap to Pay on iPhone sem abrir UI e sem vincular.

• Retorna true → conta já vinculada, pode seguir para pagamento.
• Retorna false → chame processTermsAndConditions() para vincular.

O método TapOnPhone.isAccountLinked() é opcional e não impede a realização de pagamentos caso não seja utilizado. No entanto, para que esse método funcione corretamente, é necessário chamar previamente o método setConfig().

Como usar

TapOnPhone.isAccountLinked(
    onSuccess: { isLinked in
        if isLinked {
            // Já vinculado — pode pagar
        } else {
            // Não vinculado — abrir fluxo de vínculo
        }
    },
    onError: { error in
        print("Erro \(error.code.rawValue): \(error.message)")
    }
)

Assinatura

TapOnPhone.isAccountLinked(
    onSuccess: @escaping (Bool) -> Void,
    onError: @escaping (TapOnPhoneError) -> Void
)