Capítulo 3

Liberar version codes

  • É preciso cadastrar um “Range” das versões (version codes) da sua aplicação. Sem esse passo, o seu aplicativo pode receber erro de atestação na integração com a nossa SDK.

Requisitos

  • Credenciais CSO (Mais informações com o nosso suporte)
  • o packageName do seu aplicativo (Exemplo: com.zoop.sdk.taponphone.sample)
  • Postman ou Insomnia

Configuração do novo token

  • Iremos utilizar o Postman nesse exemplo. O passo inicial é configurar um novo Token, para poder ter acesso aos endpoints corretamente.
  1. Acesse a aba de Authorization, e selecione o ‘Auth Type’ como OAuth 2.0
  2. Na opção de Configure new token, em Grant Type, selecione Client Credentials
  3. Em Access Token URL, insira https://login.microsoftonline.com/common/oauth2/v2.0/token
  4. Em Client ID, adicione o client id
  5. Em Client Secret, adicione o client secret
  6. Em Scope, insira https://mpplivece.onmicrosoft.com/625f88e3-3b1c-4209-a160-e06c1b7d0718/.default
  7. Em Client Authentication, selecione Send client credentials in body
  8. Após adicionar os parâmetros acima, clique em GET NEW ACCESS TOKEN.
  • Após gerar um token válido, você poderá utilizar os endpoints abaixo.

Utilizando a API

GET - Exibe versionCodes aceitos no Android Play Integrity do seu aplicativo

  • Basta substituir com o seu packageName

https://api-na1.mypinpad.io/risk/policies/analysers/android-play-integrity/{packageName}/versions

{ "versionCodes": 1 }

Exemplo de resposta de sucesso (200 OK)

PUT - Insere/Atualiza versionCodes aceitos na Android Play Integrity do seu aplicativo

  • Você precisa fornecer o versionCode atual do seu aplicativo, e adicionar um “range” para ele
  • Por exemplo, se seu aplicativo encontra-se no versionCode 1, você pode acrescentar um range de 1-50
  • Não há um limite de range. Você pode determinar o range que quiser.
  • Basta substituir com o seu packageName

https://api-na1.mypinpad.io/risk/policies/analysers/android-play-integrity/{packageName}/versions

No body da request, Selecione a opção raw, e insira o JSON a seguir:

{
    "versionCodes": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10
    ]
}

Collection de exemplo

  • Disponibilizamos abaixo uma collection de exemplo, com alguns parãmetros pré-configurados, para auxiliar na utilização da API, bastando apenas inserir suas credenciais CSO, em CLIENT ID e CLIENT SECRET