Getting Started

ūüĎć

VERSÃO ATUAL

**Sempre disponível na lateral esquerda superior da documentação

Aplicação Demo

ūüďė

Para te ajudar a desenvolver essa integração, criamos uma aplicação que exemplifica todas as etapas da integração.
Você pode acessar o App Demo neste link

Para iniciar a integração com o SDK, você precisa:

  1. Adicionar os nossos repositórios no build.gradle do seu projeto:
repositories {
  maven { url "https://packagecloud.io/priv/${token}/stone/pos-android/maven2" }
}

ūüďė

Token de Acesso ao PackageCloud

Para acessar as nossas bibliotecas de desenvolvimento, é necessário que você possua um token de acesso do serviço de distribuição de artefatos utilizado atualmente para as releases do Stone SDK, o PackageCloud.

Esse token é gerado automaticamente no processo de credenciamento e enviado por e-mail junto com as credenciais de acesso.

Caso já esteja credenciado, você deve solicitar esse token a equipe de Parcerias através do canal no Slack
Stone Partner Community, ou entre em contato com seu Biz Dev (business development)

ūüöß

Utilização do Token de Acesso

Recomendamos o uso do token de acesso da PackageCloud via local.properties do seu projeto por motivos de segurança

token = localProp["packageCloudReadToken"]

Dependências

  1. Adicionar a dependência para o core da SDK:
dependencies {
  implementation "br.com.stone:stone-sdk:$stone_sdk_version"
}
  1. Caso você esteja utilizando um dispositivo POS Android, é necessário adicionar a dependência do módulo de POS Android e a dependência do seu terminal.
dependencies {
  implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
}
  • Terminais Ingenico:
dependencies {
  implementation "br.com.stone:stone-sdk:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid-ingenico:$stone_sdk_version"
}
  • Terminais Positivo:
dependencies {
  implementation "br.com.stone:stone-sdk:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid-positivo:$stone_sdk_version"
}
  • Terminais Sunmi:
dependencies {
  implementation "br.com.stone:stone-sdk:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid-sunmi:$stone_sdk_version"
}
  • Terminais Gertec:
dependencies {
  implementation "br.com.stone:stone-sdk:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
  implementation "br.com.stone:stone-sdk-posandroid-gertec:$stone_sdk_version"
}

‚ĚóÔłŹ

Compartilhamento de Dados com apps Stone

A partir da vers√£o 3.6.0, todos os dados transacionais e de ativa√ß√£o s√£o compartilhados entre o SDK Android e o POS Android da Stone, permitindo que se visualize as transa√ß√Ķes no Relat√≥rio Stone ou as cancele pelo app da Stone.

Por√©m, informa√ß√Ķes transacionais do SDK anterior √† essa vers√£o ser√£o perdidas na atualiza√ß√£o, por isso recomendamos que o comportamento seja comunicado aos seus clientes.