Integrando

dica

É recomendado ler as definições da Estrutura Padrão durante a integração, já que lá definimos tudo quer é utilizado dentro do provider.

Dependências

Dependência	Versão	Instalação
hub-authentication	1.3.0	Instalada automaticamente
hub-interface	2.8.0	Instalada automaticamente

aviso

Se seu projeto integra com mais de um provider, é necessário que as versões das bibliotecas provider dependam das mesmas versões das dependências acima.

Autenticação

Para utilizar a biblioteca é necessário estar autenticado com a Hub API. A autenticação é feita por meio de um token, que deverá ser solicitado ao suporte da GetCard. Este token autentica o cliente integrador (Software House, desenvolvedor...) durante a integração no ambiente de homologação, e o cliente final no produto final no ambiente de produção.

observação

O token utilizado no ambiente de homologação não é o mesmo no ambiente de produção.

Instalação

• Adicione o nosso repositório Maven no settings.gradle do seu projeto:

Kotlin

build.gradle.kts

dependencyResolutionManagement {
    //...
    repositories {
        maven {
            url = uri("https://dev-hubpay.tefbr.com.br/repo/repository/getcard-public/")
            credentials {
                username = "getcard-public"
                password = "aq:z.wQy^w#.Zg[)1k>|D#QNK}JgL5GL"
            }
        }
        //...
    }
}

Groovy

build.gradle

dependencyResolutionManagement {
    //...
    repositories {
        maven {
            url 'https://dev-hubpay.tefbr.com.br/repo/repository/getcard-public/'
            credentials {
                username 'getcard-public'
                password 'aq:z.wQy^w#.Zg[)1k>|D#QNK}JgL5GL'
            }
        }
        //...
    }
}

• Adicione a seguinte dependência no build.gradle do módulo do app:

informação

Dispositivos:

• pinpad -> dispositivos Android que utilizam PIN Pad
• gpos720 -> POS Gertec GPOS 720
• l400 -> POS Positivo L400

Sufixos:

• debug -> versão para uso em ambiente de desenvolvimento
• release -> versão otimizada para uso em ambiente de produção

Kotlin

build.gradle.kts

dependencies {
    implementation("com.getcard.hub.provider:scope-<dispositivo>:<número-versão>-<sufixo>")
}

Groovy

build.gradle

dependencies {
    implementation 'com.getcard.hub.provider:scope-<dispositivo>:<número-versão>-<sufixo>'
}

Após adicionar, sincronize o projeto para garantir que todas as bibliotecas sejam corretamente carregadas.

Dependências adicionais

Ainda é necessário adicionar uma biblioteca .aar diretamente no projeto integrador.
Para obter esta biblioteca entre em contato com nossa equipe informando o(s) tipo(s) de dispositivo(s) que será(ão) integrado(s).

Exemplos

Aqui você pode encontrar um exemplo de uso da nossa biblioteca:

• Exemplos de integração