Integrando

Dependências

Dependência	Versão	Instalação
hub-authentication	1.3.0	Instalada automaticamente
hub-interface	2.9.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 (não confundir com o token de autenticação da SiTef), 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

Sufixos:

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

Dispositivos suportados:

• pinpad
• gpos720
• gpos760
• gpos780

Kotlin

build.gradle.kts

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

Exemplo de importação usando Pinpad

build.gradle.kts

dependencies {
    implementation("com.getcard.hub.provider:sitef-pinpad:4.1.0-debug")
}

Groovy

build.gradle

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

Exemplo de importação usando Pinpad

build.gradle

dependencies {
    implementation 'com.getcard.hub.provider:sitef-pinpad:3.4.1-debug'
}

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

Configurações específicas

Algumas versões necessitam de configurações específicas.

GPOS780

É necessário adicionar esta linha no build.gradle a nível de módulo:

Kotlin

build.gradle.kts

defaultConfig {
    ndk {
        abiFilters.add("armeabi-v7a")
    }
    //...
}

Groovy

build.gradle

defaultConfig {
    ndk {
        abiFilters 'armeabi-v7a'
    }
    //...
}

Pinpad

Na versão do Sitef para Pinpads o targetSdk máximo suportado é 33, configurado no build.gradle.kts,

Kotlin

build.gradle.kts

defaultConfig {
    targetSdk = 33
}

Groovy

build.gradle

defaultConfig {
    targetSdk 33
}

Dependências adicionais

GPOS720

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