> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/verifone-tap/vfi-tap-integration-guide-pt/primeiros-passos-com-o-verifone-tap.md).

# Primeiros passos com o Verifone Tap

Comece aqui para escolher o caminho mais rápido para o Verifone Tap.

{% if visitor.isSet === true && visitor.claims.hasAccessToSOFTPOS !== true %}
{% columns %}
{% column width="16.666666666666664%" %}

<figure><picture><source srcset="/spaces/YxYaIQQ51Y1kp5Oav4GZ/files/h8CUQCrn7gGJx3iTwKEZ" media="(prefers-color-scheme: dark)"><img src="/spaces/YxYaIQQ51Y1kp5Oav4GZ/files/rOelFPj8VuctGQ5lNjAC" alt=""></picture><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="83.33333333333334%" valign="middle" %}

<h3 align="center">Need access to this content? Contact your Verifone representative.</h3>
{% endcolumn %}
{% endcolumns %}
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

<h4 align="center"><strong>Please login or register to gain access to the detailed material on this page.</strong></h4>
{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a><a href="https://partner-registration.verifone.com/" class="button secondary">Register for an Account</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}

{% hint style="info" %}
Escolha o caminho que corresponde ao seu objetivo:

* Explore o Verifone Tap com a aplicação de demonstração — avalie a experiência sem criar ou integrar qualquer SDK.
* Crie e execute a aplicação de referência do Verifone Tap — crie o código-fonte da aplicação de exemplo fornecido, em vez de o integrar na sua própria aplicação.
* Integre o SDK do Verifone Tap na sua aplicação — adicione o SDK à sua própria base de código e crie o seu próprio fluxo de pagamento
  {% endhint %}

{% tabs %}
{% tab title="Explorar com a aplicação de demonstração" %}
{% hint style="info" %}

* Use este caminho se quiser explorar o Verifone Tap antes de o integrar.
* Não precisa de criar nem integrar nada.
  {% endhint %}

{% stepper %}
{% step %}

### Obter a aplicação de demonstração

<table data-header-hidden><thead><tr><th width="380.22222900390625" valign="top"></th><th align="center" valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Descarregue a aplicação de demonstração para Android ou iOS.</p><p>Com aplicações de demonstração pré-construídas, pode validar o fluxo antes de iniciar a integração.</p></td><td align="center" valign="top"><img src="/files/cbd82be35690261521822e99f1682bf18ef69afb" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/273123753d1bd3534d00d3a15e42447819ce9e9c" class="button primary" data-icon="desktop-arrow-down">Descarregar aplicações de demonstração</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Obter um código QR de teste

Contacte o Suporte Verifone para solicitar um código QR para ativação do dispositivo.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="https://verifone.atlassian.net/servicedesk/customer/portal/300" class="button primary" data-icon="tickets">Contactar o suporte para obter QR para ativação</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Testar a aplicação

1. Instale a aplicação.
2. Durante a inicialização, use o código QR para ativar o dispositivo.
3. Depois, execute um pagamento de teste.
4. Para testes no iPhone, inicie sessão com uma conta de testador do Apple Sandbox. O endereço de e-mail do testador do Sandbox nunca pode ter sido usado como uma Conta Apple.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/4a97ecb9c75d88f4002183e1613fcd614e9cc7e3" class="button primary" data-icon="mobile-screen-button">Rever a ativação do SDK</a><a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/0b0b44e4e102c23a0506b4c2dd13425600c8780b#testing-tap-to-pay-on-iphone-sandbox" class="button secondary" data-icon="apple">Preparar testes no Apple Sandbox</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Criar e executar a aplicação de referência" %}
{% hint style="info" %}

* Use este caminho se quiser criar e executar a aplicação de referência do Verifone Tap.
* Trabalha a partir do código-fonte da aplicação de exemplo.
* Ainda não adiciona o SDK à sua própria aplicação.
  {% endhint %}

{% stepper %}
{% step %}

### Descarregar a aplicação de referência

<table data-header-hidden><thead><tr><th width="380.22222900390625" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Abra a página da versão que pretende usar. Cada página de versão inclui os transferíveis da aplicação de referência. Escolha a versão que quer criar e use os respetivos ficheiros da aplicação de referência empacotados.</p><p></p></td><td align="center"><img src="/files/cbd82be35690261521822e99f1682bf18ef69afb" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/f1206da70c2814b749a01790c5bc5ef62520fc11" class="button primary" data-icon="desktop-arrow-down">Abrir transferências do SDK</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Obter um código QR de teste

Contacte o Suporte Verifone para solicitar um código QR para ativação do dispositivo.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="https://verifone.atlassian.net/servicedesk/customer/portal/300" class="button primary" data-icon="tickets">Contactar o suporte para obter QR para ativação</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Criar a aplicação

<table data-header-hidden><thead><tr><th width="380.22222900390625" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Use os guias de configuração da plataforma para criar a aplicação localmente.</p><p>Cada guia de configuração inclui uma breve nota para criar a aplicação de referência existente.</p><p></p></td><td align="center"><img src="/files/cd95a20dcd6e21e764d1fecda186da3e50ddc032" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/c6d4a696b6472f27b798831b3d89ff5343d6a2b8" class="button primary" data-icon="android">Abrir guia de configuração do Android</a><a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/0b0b44e4e102c23a0506b4c2dd13425600c8780b" class="button secondary" data-icon="apple">Abrir guia de configuração do iOS</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Efetuar o onboarding da aplicação Android

A aplicação de referência Android ainda tem de concluir o onboarding antes dos testes.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/6f4044ed1a94429e51f8a4690d944e3f51be30ab" class="button primary" data-icon="cloud-arrow-up">Onboarding da aplicação Android</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Preparar testes no Apple Sandbox

Para testes no iPhone, inicie sessão com uma conta de testador do Apple Sandbox. O endereço de e-mail do testador do Sandbox nunca pode ter sido usado como uma Conta Apple.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/0b0b44e4e102c23a0506b4c2dd13425600c8780b#testing-tap-to-pay-on-iphone-sandbox" class="button primary" data-icon="apple">Preparar testes no Apple Sandbox</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Testar a aplicação

1. Instale a aplicação.
2. Durante a inicialização, use o código QR para ativar o dispositivo.
3. Depois, execute um pagamento de teste.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/4a97ecb9c75d88f4002183e1613fcd614e9cc7e3" class="button primary" data-icon="mobile-screen-button">Rever a ativação do SDK</a><a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/8a096c5462315a767e4750d6b4601b6beb4fe37a" class="button secondary" data-icon="basket-shopping">Executar um teste de venda</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Integrar o SDK do Verifone Tap" %}
{% hint style="info" %}

* Use este caminho se quiser integrar o SDK do Verifone Tap na sua aplicação.
* Adiciona o SDK ao seu próprio projeto.
* Configura a sua aplicação, o fluxo de pagamento e a implementação.
* Use este caminho para uma integração real.
* Use os outros caminhos apenas para avaliação ou configuração de uma aplicação de exemplo.
  {% endhint %}

{% stepper %}
{% step %}

### Preparar a configuração do comerciante e do terminal

<table data-header-hidden><thead><tr><th width="380.22216796875" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Conclua o onboarding para configurar o comerciante e o terminal.</p><p>Se o onboarding ainda estiver em curso, solicite um código QR temporário ao Suporte Verifone.</p></td><td align="center"><img src="/files/c4f868ad83395c726e57b44990da831063d1247f" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/e8f092f6a315e214889af34d7bcc6105896adc51" class="button primary" data-icon="ticket-airline">Rever o onboarding do comerciante</a><a href="https://verifone.atlassian.net/servicedesk/customer/portal/300" class="button secondary" data-icon="tickets">Contactar o suporte para obter QR para ativação</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Descarregar o SDK do Verifone Tap

<table data-header-hidden><thead><tr><th width="382.888916015625" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Descarregue o SDK mais recente para Android ou iOS.</p><p>Com exemplos prontos a copiar e colar e autenticação rápida, pode começar rapidamente.</p><p></p></td><td align="center"><img src="/files/cbd82be35690261521822e99f1682bf18ef69afb" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/f1206da70c2814b749a01790c5bc5ef62520fc11" class="button primary" data-icon="down-to-bracket">Obter o SDK do Verifone Tap</a>
{% endif %}
{% endstep %}

{% step %}

### Seguir o guia de desenvolvimento

Escolha a sua plataforma e conclua os passos de configuração.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/c6d4a696b6472f27b798831b3d89ff5343d6a2b8" class="button primary" data-icon="android">Configuração de desenvolvimento Android</a><a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/0b0b44e4e102c23a0506b4c2dd13425600c8780b" class="button secondary" data-icon="apple">Configuração de desenvolvimento iOS</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Rever a API de Pagamento

Use a API de Pagamento para inicializar o SDK e executar fluxos de pagamento.

Configurar a sua primeira chamada de API deve ser a parte mais fácil de começar.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/053a5495509198f28eddb45b070566821f5f74d9" class="button primary" data-icon="gear-complex-api">Ver a API de Pagamento</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Efetuar o onboarding da aplicação Android

{% hint style="warning" %}
Este passo aplica-se apenas ao Android.
{% endhint %}

Carregue a sua aplicação Android integrada para a plataforma segura de onboarding. O iOS não requer onboarding da aplicação. Em vez disso, ative o entitlement Tap to Pay durante a configuração do iOS.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/6f4044ed1a94429e51f8a4690d944e3f51be30ab" class="button primary" data-icon="cloud-arrow-up">Onboarding da aplicação Android</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Preparar testes no Apple Sandbox

Para testes no iPhone, inicie sessão com uma conta de testador do Apple Sandbox. O endereço de e-mail do testador do Sandbox nunca pode ter sido usado como uma Conta Apple.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/0b0b44e4e102c23a0506b4c2dd13425600c8780b#testing-tap-to-pay-on-iphone-sandbox" class="button primary" data-icon="apple">Preparar testes no Apple Sandbox</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Testar a aplicação

Ative a aplicação no dispositivo de teste e execute testes de pagamento end-to-end.

{% if visitor.isSet === true && (visitor.claims.hasAccessToDEVPORTAL\_VFI || visitor.claims.hasAccessToSOFTPOS === true) %} <a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/4a97ecb9c75d88f4002183e1613fcd614e9cc7e3" class="button primary" data-icon="mobile-screen-button">Rever a ativação do SDK</a><a href="/spaces/vsRxJiuZaHCKAl7pPm90/pages/8a096c5462315a767e4750d6b4601b6beb4fe37a" class="button secondary" data-icon="basket-shopping">Executar um teste de venda</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Implementar a sua aplicação

Implemente através da sua solução MDM, da App Store ou do Google Play. Após a instalação no dispositivo do comerciante, conclua a ativação e comece a aceitar pagamentos.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verifone.com/verifone-tap/vfi-tap-integration-guide-pt/primeiros-passos-com-o-verifone-tap.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
