Integrando

Dependências

Dependência	Versão	Instalação
hub-authentication	1.3.0	Instalada automaticamente
hub-interface	2.6.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:3.3.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.3.0-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
}

Exemplos

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

• Exemplos de integração