# Checkout

Iniciar um pagamento com FaciPayCheckout.start.

`FaciPayCheckout.start(...)` apresenta o checkout (WebView num bottom-sheet) e devolve o
resultado pelo `FaciPayCallback`.

```kotlin
FaciPayCheckout.start(
    activity = this, // FragmentActivity
    references = listOf(
        PaymentReference(
            referenceNumber = "ORDER-2024-001",
            referenceAmount = 5000.0 // AOA
        )
    ),
    createOrder = {
        // Crie a ordem no seu backend e devolva o merchantTransactionId
        val response = api.createOrder(cart)
        CreateOrderResult.success(merchantTransactionId = response.transactionId)
    },
    customerInfo = CustomerInfo(name = "João Silva", phone = "923456789"),
    config = FaciPayConfig.Builder()
        .language(Language.PORTUGUESE)
        .theme(Theme.LIGHT)
        .defaultPaymentMethod(PaymentMethod.MCX_EXPRESS)
        .showUIOfProcessingInfo(true)
        .build(),
    callback = object : FaciPayCallback {
        override fun onApprove(result: PaymentResult) { /* ... */ }
        override fun onPending(result: PaymentResult) { /* ... */ }
        override fun onCancel() { /* ... */ }
        override fun onError(error: FaciPayException) { /* ... */ }
    }
)
```

## Parâmetros

<ParamField path="activity" type="FragmentActivity" required>
  A Activity que apresenta o checkout.
</ParamField>

<ParamField path="references" type="List<PaymentReference>" required>
  Itens a pagar. Cada `PaymentReference` tem `referenceNumber`, `referenceAmount` (Kwanzas),
  `referenceQuantity` (predefinição 1) e `referenceTotalQuantity` (opcional).
</ParamField>

<ParamField path="createOrder" type="suspend () -> CreateOrderResult" required>
  Cria a ordem no seu backend. Devolve `CreateOrderResult.success(merchantTransactionId)` ou
  `CreateOrderResult.failure(message)`.
</ParamField>

<ParamField path="customerInfo" type="CustomerInfo">
  `name`, `phone` (`244XXXXXXXXX` ou `9XXXXXXXX`), `email` (opcional).
</ParamField>

<ParamField path="config" type="FaciPayConfig">
  `language`, `theme`, `defaultPaymentMethod`, `allowedPaymentMethods`,
  `showUIOfProcessingInfo`, `showAmount`, `referencePaymentLifeSpan` (definido via
  `(duração, TimeUnit)`, 1–720 h).
</ParamField>

<ParamField path="presentationMode" type="PresentationMode">
  `WEBVIEW` (predefinição). `CUSTOM_TABS` e `NATIVE` planeados para versões futuras.
</ParamField>

<Card title="Próximo passo: Callbacks & resultado" icon="arrow-right" href="/pt/android/callbacks">
  Tratar aprovação, pendência, cancelamento e erros.
</Card>