Payment Features / Partial Approval - Android SDK

Intro

Partial approval means that in case a cardholder has insufficient funds to approve the transaction for the full amount. Example: when the total amount of the transaction is EUR 100,- and the balance of the cardholder account is EUR 80,- the transaction will be approved for EUR 80,-. In this example this means there will be a remainder EUR 20,- to be paid by other means.

Partial Approval is applicable to:

• Payments
• Reservations
• ReservationAdjustment
• Deferred payments (used in Unattended Petrol environment, but partial approval is already in use in this environment)

The TotalAmount present in the response shows the partial amount that is actually authorized. Now it is up to the POS to determine that the actual amount paid is EUR 80, and the remaining EUR 20,- still have to be paid.

The E-Journal is enhanced to report the partial approval. The following elements in the E-Journal are involved:

• ‘RequestedAmount’
• ‘TotalAmount’

When the cardholder has no means to pay the remaining amount, you need to a cancellation any to enable reversal of the partial approval amount. You can find how to do that here.

Example

    createTerminal(ExternalTerminal.TerminalType.ATTENDED_OPI_NL);
    PaymentApi paymentService = new PaymentService();

    PaymentDelegate paymentDelegate = new PaymentDelegate() {
        @Override
        public void onPaymentSuccess(PaymentResult result) {
            // The payment is completed successful!
            // The paymentResult contains all information about the transaction            
        }
    
        @Override
        public void onError(Error error) {
            // The payment failed
            // The Error object contains information about what went wrong
        }
    };

    Payment payment = Payment
            .builder()
            .type(Payment.Type.SALE)
            .amount(new Money(amount, Currency.getInstance("EUR")))
            .supportOfPartialApproval(true)
            .build();

    paymentService.payment(terminal, payment, delegate);