Supporting regional payment flows

The Remote Pay SDKs support regional payment flow differences with parameters specific to each region. These parameters are passed as key-value pairs in SaleRequest, AuthRequest, and PreAuthRequest.

Regional parameters for Argentina

Clover devices in Argentina display two additional screens during the default payment flow: the fiscal invoice and installment screens.

The following table describes the parameters specific to Argentine flows. The names are constants defined in the RegionalExtras class.

Name

Description

FISCAL_INVOICE_NUMBER_KEY

Number associated with the transaction. Valid invoice numbers are four digits, one dash, then eight more digits with no spaces (dddd-dddddddd).

INSTALLMENT_NUMBER_KEY

The number of payment installments. If passed a number, the installments screen is skipped. If no number is passed, the installments screen appears and prompts the customer for a selection.

INSTALLMENT_PLAN_KEY

The name (or other identifier) of the payment plan. The value must be a number between 1-99.

SKIP_FISCAL_INVOICE_NUMBER_SCREEN_VALUE

Pass this value to FISCAL_INVOICE_NUMBER_KEY to skip the invoice screen without using an invoice number

INSTALLMENT_NUMBER_DEFAULT_VALUE

Default value for INSTALLMENT_NUMBER_KEY which can be used skip the installment screen.

This sample shows a SaleRequest which skips both the fiscal invoice and installment screens by using the SDK-provided values for FISCAL_INVOICE_NUMBER_KEY and INSTALLMENT_NUMBER_KEY.

private saleRequest setupSaleRequest() {
  SaleRequest saleRequest = new SaleRequest();
  saleRequest.setExternalId(ExternalIdUtils.generateNewID()); //required
  Map<String, String> extras = new HashMap<>();
  extras.put(RegionalExtras.FISCAL_INVOICE_NUMBER_KEY, RegionalExtras.SKIP_FISCAL_INVOICE_NUMBER_SCREEN_VALUE);
  extras.put(RegionalExtras.INSTALLMENT_NUMBER_KEY, RegionalExtras.INSTALLMENT_NUMBER_DEFAULT_VALUE);
  saleRequest.setRegionalExtras(extras);
}

Did this page help you?