# Instalação

Adicionar a FaciPay Android SDK via Gradle (Maven Central).

## Dependências Gradle

Adicione os artefactos ao `build.gradle(.kts)` do módulo:

<CodeGroup>
```kotlin build.gradle.kts
dependencies {
    implementation("com.faciconnect:facipay-core:1.0.0-beta01")
    implementation("com.faciconnect:facipay-android:1.0.0-beta01")
}
```

```groovy build.gradle
dependencies {
    implementation 'com.faciconnect:facipay-core:1.0.0-beta01'
    implementation 'com.faciconnect:facipay-android:1.0.0-beta01'
}
```
</CodeGroup>

Garanta que o **Maven Central** está nos repositórios:

```kotlin settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
```

## Inicialização

Inicialize cedo (recomendado no `Application`). O ambiente é detetado pelo prefixo da chave
(`pk_live_`, `pk_test_` — `pk_dev__` é de uso interno).

```kotlin
// Simples
FaciPay.init(context, "pk_test_xxx")

// Com callback
FaciPay.init(context, "pk_test_xxx") { success, error ->
    if (success) { /* SDK pronta */ } else { /* tratar erro */ }
}

// Com configuração
FaciPay.init(context, "pk_test_xxx") {
    language(Language.PORTUGUESE)
    theme(Theme.LIGHT)
    defaultPaymentMethod(PaymentMethod.MCX_EXPRESS)
    allowedPaymentMethods(listOf(PaymentMethod.MCX_EXPRESS, PaymentMethod.REFERENCE))
    referencePaymentLifeSpan(24, TimeUnit.HOURS)
}
```

<Warning>
Mantenha o `clientSecret` e o `webhookSecret` **fora da app** — vivem só no seu backend. A app
usa apenas a `publishableKey`.
</Warning>

<Card title="Próximo passo: Checkout" icon="arrow-right" href="/pt/android/checkout">
  Iniciar um pagamento.
</Card>