Feature guidence

The ECR can optionally specify conditions for a specific transaction

The ECR can optionally specify conditions for a specific transaction, which will affect how the transaction is processed. Currently supported transaction conditions are:

Brand restriction

Brand restriction can be used when the ECR needs to ensure the allowed card brands for a transaction is restricted to the set of card brands explicitly allowed by the ECR.

To set a brand restriction for a transaction, the ECR can:

  1. specify a list of brand categories
  2. specify a list of brands
  3. use a combination of 1 and 2

Brands are assigned to categories in the terminal configuration profile. A brand can only be member of one category.

Examples

Restriction by ECRResult
...
"TransactionConditions": {
    "AeAllowedPaymentBrandCategory": [
    	"VOUCHER"
   	]
}
...
The terminal will only allow:
  • Any brand in the VOUCHER category
...
"TransactionConditions": {
    "AeAllowedPaymentBrandCategory": [
    	"NORMAL"
   	]
}
...
The terminal will only allow:
  • Any brand in the NORMAL category
...
"TransactionConditions": {
	"AllowedPaymentBrand": [
		"VISA",
        "MASTERCARD"
	]
}
...
The terminal will only allow:
  • VISA, and:
  • MASTERCARD
...
"TransactionConditions": {
	"AllowedPaymentBrand": [
		"VISA",
        "MASTERCARD"
	],
    "AeAllowedPaymentBrandCategory": [
    	"VOUCHER"
   	]
}
...
The terminal will only allow:
  • VISA, and:
  • MASTERCARD, and:
  • Any brand in the VOUCHER category
No restriction provided by ECRThe terminal will allow any brand enabled in the configuration profile

Notes:

  • The 'TransactionConditions' property is part og the 'PaymentRequest' message. See the Payment message reference for a full example message.
  • The 'LoginResponse' message includes the list of categories and brands that are currently configured in the terminal. See the Login message reference for a full example message.

Did this page help you?