7 - Termos e condições

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.

ℹ️

A partir da versão 3.4.3, você pode chamar TapOnPhone.processTermsAndConditions(...) sem inicializar o SDK antes.

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.