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.