Developers

Partial Approval

Contents

Overview

This chapter describes how to process partial approval transactions through the Nuvei Gateway integration.

A situation may arise where a customer wishes to make a purchase or deposit while lacking sufficient funds to complete the transaction. This may be caused by an insufficient balance on a prepaid card or a lack of approval on the part of the issuing bank. In such a case for a deposit, the customer is charged for the remainder of the existing funds and the transaction is completed. If the transaction is a purchase, the remaining part of the sum total of the transaction is required to complete the transaction; however, the total amount of the remaining sum is charged immediately.

This option is enabled by contacting customer support.

If this option is enabled, you should take the necessary steps to notify your customers of the partial approval due to their lack of funds to ensure “user-friendliness” and adherence to the applicable laws and standards governing your business.

As mentioned above, once a transaction is approved, even with less funds than needed to complete the requested deposit/purchase, the transaction for the available funds is executed and submitted for approval. If you wish to supply your customers with an option to cancel on the submitted transaction, a new reversal transaction must be implemented on your part to reimburse the funds previously charged to the customer.

This option is not available for all issuers and is only available via Nuvei Acquirer.

Checkout Page Support

To activate Partial Approval on the Payment Page, please contact your account manager. Once activated and a deposit transaction is partially approved, a dialog window opens allowing the customer to confirm or cancel the transaction. Clicking ‘Cancel’ triggers execution of a void transaction and a DMN is sent to the merchant. Clicking ‘Confirm’ triggers a confirmation DMN to the merchant.

The Partial Approval feature can be activated only for merchants that are using Open Amount functionality by setting item_open_amount_1 to true. Merchants  that set item_open_amount_1 to false or that are not including this parameter in their requests cannot utilize the Partial Approval feature.



Following the partial approval operation in Nuvei’s Checkout Page solution, the DMN notification is triggered and the following parameters are sent with the following values:

  • isPartialApproval – 1 in case of a partially approved transaction; 0 or not present when the transaction was not approved partially.
  • requestedAmount – The original requested amount.
  • requestedCurrency – The requested currency.
  • partialApprovalStatus – PENDING, APPROVED, CANCELLED, AUTO_VOID
    • PENDING – There was partial approval and a dialogue was shown to the user to confirm or cancel.
    • APPROVED – The user confirmed the partially approved transaction.
    • CANCELLED – The user cancelled the partially approved transaction.
    • AUTO_VOID – The transaction was automatically voided because the amount was below the minimum limit.

Reversing a Partial Approval

A situation may arise where the customer is not interested in continuing with a transaction if it can only be carried out partially. Since the partial approval is authenticated automatically, it is incumbent on the merchant to be prepared for this scenario and to offer the merchant an option for the customer to back out of the transaction. The partial approval transaction cannot be reversed and instead must be voided by the merchant; therefore, merchants must be sure to provide their customers an easy option to reimburse their funds if needed.

The Checkout Page allows the customer to void the partially approved transaction by presenting a dialog with a “Confirm” button and a “Cancel transaction” button. Clicking ‘Cancel transaction’ issues a void transaction with the partially approved amount and currency.

Direct API Solution

The Nuvei API also offers support to the partial approval feature.