GiniHealth

public final class GiniHealth

GiniHealth is the main class for interacting with the Gini Health SDK. It provides a way to submit a document for reviewing its extracted payment details and let's the user make the payment with one of the payment providers.

The recommended flow is:

Call checkRequirements to make sure that the flow can be completed.
Call one of the overloads of setDocumentForReview, to submit a document.
Display ReviewFragment.

setDocumentForReview can be called with:

Document instance in the case the upload was performed with Gini Pay Api lib (GiniHealthAPI).
Document id, this will probably be the case when there's backend integration between the Health SDK and the Gini Health API. This method will make a network call to obtain a Document instance so the other one is preferred if you have the Document instance.

documentFlow, paymentFlow, openBankState are used by the ReviewFragment to observe their state, but they are public so that they can be observed anywhere, the main purpose for this is to observe errors.

Constructors

GiniHealth

GiniHealth GiniHealth(GiniHealthAPI giniHealthAPI)

Types

Companion

public class Companion

PaymentState

public class PaymentState

Functions

checkIfDocumentIsPayable

final Boolean checkIfDocumentIsPayable(String documentId)

Checks whether the document is payable by fetching the document and its extractions from the Gini Pay API and verifying that the extractions contain an IBAN.

checkRequirements

final List<Requirement> checkRequirements(PackageManager packageManager)

Checks the required conditions needed to finish the payment flow to avoid unnecessary document upload.

getDocumentFlow

final StateFlow<ResultWrapper<Document>> getDocumentFlow()

A flow for getting the Document set for review setDocumentForReview.

getGiniHealthAPI

final GiniHealthAPI getGiniHealthAPI()

getOpenBankState

final StateFlow<GiniHealth.PaymentState> getOpenBankState()

A flow that exposes the state of opening the bank.

getPaymentFlow

final StateFlow<ResultWrapper<PaymentDetails>> getPaymentFlow()

A flow for getting extracted PaymentDetails for the document set for review (see setDocumentForReview).

setDocumentForReview

final Unit setDocumentForReview(Document document)

Sets a Document for review.

final Unit setDocumentForReview(String documentId, PaymentDetails paymentDetails)

Sets a Document for review.

setSavedStateRegistryOwner

final Unit setSavedStateRegistryOwner(SavedStateRegistryOwner registryOwner, CoroutineScope retryScope)

Sets a lifecycle observer to handle state restoration after the system kills the app.

Properties

documentFlow

private final StateFlow<ResultWrapper<Document>> documentFlow

A flow for getting the Document set for review setDocumentForReview.

giniHealthAPI

private final GiniHealthAPI giniHealthAPI

openBankState

private final StateFlow<GiniHealth.PaymentState> openBankState

A flow that exposes the state of opening the bank.

paymentFlow

private final StateFlow<ResultWrapper<PaymentDetails>> paymentFlow

A flow for getting extracted PaymentDetails for the document set for review (see setDocumentForReview).