Batch Routing Configuration

Overview

The batch routing configuration may be used when a group of stores requests a routing update of the Issuer (Mastercard, Visa, etc.) in only a portion of its stores or when the number of stores make it impossible to configure one by one manually.

Prerequisites

As prerequisites, the stores and authorizers (issuers) that will have their routing updated must already be registered on Carat Portal. If not, check the Batch Store Registration documentation.

The routings and issuers must also be already configured on SiTef. To that end, contact our Carat Portal Support Team to ensure production operation.

Supported Routings/Acquirer Networks

The routings supported for batch routing configuration are:

Import File Format

ATTENTION: The import file must be generated with the UTF-8 encode.

The file will consist of the merchant code followed by the issuer you want to change and the routing/acquirer network through which the issuer will be routed, repeating one line per issuer, one or more lines per store.

Only the routings declared in the file will be changed, if the store has other issuers that were not declared, its configuration will be maintained.

Format to be received (Format per line):

field1;field2;field3;paramter1|paramter2|...|paramterN

Field	Description	Format	Required
`field1`	CNPJ (or `merchant code`, or `merchantId`). No formatting (alphanumeric).	< 15 AN	Yes
`field2`	Issuer/Authorizer code. Check the codes in the Issuer/Authorizer Codes section.	< 15 N	Yes
`field3`	Routing/Acquirer Network code. Check the codes in the Routing/Acquirer Network Codes section.	< 15 N	Yes
`paramter1`, `paramter2`, `paramterN`	Additional parameters that may vary according the acquirer network/routing.	-	No

Issuer/Authorizer Codes

Issuer/Authorizer	Code
`VISA`	1
`MASTERCARD`	2
`AMERICAN EXPRESS (AMEX)`	3
`HIPERCARD`	5
`AURA`	6
`CABAL`	12
`VALECARD`	28
`SOROCRED`	29
`DINERS`	33
`ELO`	41
`GOODCARD`	42
`JCB`	43
`DISCOVER`	44
`CHINA UNION PAY`	45
`CREDZ`	46
`AGIPLAN`	47
`VEROCHEQUE`	48
`PAN`	122
`AVISTA CREDITO`	192

Routing/Acquirer Network Codes

Additional Parameters

Some routings/acquirer networks requires additional parameters registered on Carat Portal to perform transactions. To register them, fill in the additional parameters from the field 4 onwards.

...;key1:value1|key2:value2|key3X:valueX

Additional parameters are not required, but if not sent, the parameters will be set to a default value.

Example

At first, all the stores in the XPTO group perform transactions with the issuers Visa, Mastercard, Hiper and Amex .

Initial state of the Group XPTO, including the stores 11111111111111, 22222222222222 and 333333333333333:

Merchants 11111111111111 and 22222222222222 after the update:

Merchant 333333333333333 after the update:

The final file to be generated will be as shown below:

11111111111111;1;1125;
11111111111111;2;409;salesAffiliationKey:ABC123DEF456|subAdquirenciaHabilitada:false
22222222222222;1;1125;
22222222222222;2;409;salesAffiliationKey:ABC123DEF457|subAdquirenciaHabilitada:false
33333333333333;1;1125;
33333333333333;3;409;salesAffiliationKey:ABC123DEF458|subAdquirenciaHabilitada:true

ATTENTION: If the field 4 is empty, don't forget to put a semicolon (;) at the end of the line.