digetpay-sdk/com.digetpay.sdk/DigetPay

DigetPay

Public entry point of the DigetPay SDK.

Typical usage:

// once, e.g. in Application.onCreate()
DigetPay.initialize(context, DigetPayConfig(apiKey = "...", environment = Environment.SANDBOX))

// whenever the user pays
DigetPay.checkout(activity, request, callback)

Functions

capture

@JvmStatic

fun capture(paymentId: String, amount: Double, callback: OperationCallback<TransactionResult>)

Captures (settles) a previously authorized payment. Use after a successful authorization (CardPaymentRequest.auth = true).

checkout

@JvmStatic

fun checkout(activity: Activity, request: CheckoutRequest, callback: PaymentCallback)

Starts a hosted checkout: creates the session, opens the payment screen and reports the outcome to callback. Exactly one callback method runs, on the main thread.

getMerchantTransactions

@JvmStatic

fun getMerchantTransactions(callback: OperationCallback<MerchantTransactionsResult>)

Lists merchant-wide POS transactions across all linked terminals.

@JvmStatic

fun getMerchantTransactions(page: Int, pageSize: Int, dateFrom: String?, dateTo: String?, status: String?, callback: OperationCallback<MerchantTransactionsResult>)

getRecurringTransactions

@JvmStatic

fun getRecurringTransactions(callback: OperationCallback<RecurringTransactionsResult>)

Lists recurring payment records returned by GET /v1/payment/s2s/recurring.

getTransactionStatus

@JvmStatic

fun getTransactionStatus(paymentId: String, callback: OperationCallback<TransactionStatusResult>)

Queries live transaction status from the gateway (GET /payment/checkout/status). paymentId is the UUID returned as paymentId (S2S) or id (checkout).

initialize

@JvmStatic

fun initialize(context: Context, config: DigetPayConfig)

Stores the merchant configuration. Safe to call more than once.

payWithCard

@JvmStatic

fun payWithCard(activity: Activity, request: CardPaymentRequest, callback: PaymentCallback)

Starts a server-to-server (S2S) card payment: computes the hash, calls the sale endpoint, then shows the 3-D Secure page (if any) and reports the outcome.

recurring

@JvmStatic

fun recurring(request: RecurringRequest, callback: OperationCallback<RecurringResult>)

Charges a stored card using a recurring token obtained from the original sale that was started with recurringInit = true.

refund

@JvmStatic

fun refund(paymentId: String, amount: Double, callback: OperationCallback<RefundResult>)

Refunds part or all of a settled payment.

void

@JvmStatic

fun void(paymentId: String, callback: OperationCallback<TransactionResult>)

Voids (cancels) a payment before it is settled.

voidPayment

@JvmStatic

fun voidPayment(paymentId: String, callback: OperationCallback<TransactionResult>)

Java-friendly alias for void. Java callers cannot invoke a method named void directly because it is a reserved keyword.