List dealers service
Call details
- Resource:
/v3/rechargedealers - HTTP Method:
GET - Request format:
query string - Response format:
JSON - Header parameters:
| Parameter | Description | Format | Mandatory |
|---|---|---|---|
Authorization | Authenticity signature in Bearer {signature} format. Learn more.Example: Bearer hh39458f73hf45324765ft349h5f73t4h95f34.This field is mandatory if the transaction was created with the signature process. | < 2000 AN | COND. |
Examples
Below are some examples of the list dealers service call using the cURL tool.
List dealers of normal recharge
Request:
curl
--request GET "https://esitef-homologacao.softwareexpress.com.br/e-sitef/v3/rechargedealers?nit=asdfghjk12345678asdfghjk12345678asdfghjk12345678asdfghjk12345678&generalhash=0000000000000000"
--verbose
Response:
{
"list_dealers_response":{
"status":"NOV",
"esitef":{
"message":"OK. Transaction successful.",
"code":"0"
},
"authorizer":{
"message":"",
"code":"000"
},
"hashes":{
"general":"09A9681D09A9681D"
},
"dealers":[
{
"name":"Vivo",
"code":"001"
},
{
"name":"Claro",
"code":"002"
},
{
"name":"Oi",
"code":"003"
},
{
"name":"Tim",
"code":"004"
}
]
}
}
List dealers of other products recharge
Request:
curl
--request GET "https://esitef-homologacao.softwareexpress.com.br/e-sitef/v3/rechargedealers?nit=asdfghjk12345678asdfghjk12345678asdfghjk12345678asdfghjk12345678"
--verbose
Response:
{
"list_dealers_response":{
"status":"NOV",
"esitef":{
"message":"OK. Transaction successful.",
"code":"0"
},
"authorizer":{
"message":"",
"code":"000"
},
"hashes":{
"general":"09A9681D09A9681D"
},
"dealers":[
{
"name":"Vex-PIN",
"code":"905",
"branches":[
{
"name":"Vex-PIN",
"code":"97200000000"
}
],
"type_name":"PIN TELEFONE",
"type_code":"02"
},
{
"name":"TIM-Leste-PIN",
"code":"902",
"branches":[
{
"name":"TIM-Leste-PIN",
"code":"97001000000"
}
],
"type_name":"PIN TELEFONE",
"type_code":"02"
},
{
"name":"E-Prepag",
"code":"901",
"branches":[
{
"name":"Brancaleone-Migux",
"code":"98000000000"
},
{
"name":"HABBO HOTEL-Habbo Hotel",
"code":"98001000000"
},
{
"name":"ONGAME-Metin2",
"code":"98006000000"
}
],
"type_name":"PIN GAMES",
"type_code":"03"
},
{
"name":"Prepag",
"code":"900",
"branches":[
{
"name":"Level Up!",
"code":"99000000000"
},
{
"name":"OnGame",
"code":"99100000000"
},
{
"name":"Acclaim",
"code":"99300000000"
}
],
"type_name":"PIN GAMES",
"type_code":"03"
},
{
"name":"Crianca Esperanca",
"code":"908",
"branches":[
{
"name":"Crianca Esperanca",
"code":"97299000000"
}
],
"type_name":"DOACAO",
"type_code":"04"
},
{
"name":"Sorte Mania",
"code":"909",
"branches":[
{
"name":"Sorte Mania",
"code":"97298000000"
}
],
"type_name":"SEGURO",
"type_code":"05"
}
]
}
}
List dealers of signature invoice payment (invoice)
Request:
curl
--request GET "https://esitef-homologacao.softwareexpress.com.br/e-sitef/v3/rechargedealers?nit=asdfghjk12345678asdfghjk12345678asdfghjk12345678asdfghjk12345678"
--verbose
Response:
{
"list_dealers_response": {
"status": "NOV",
"esitef": {
"message": "OK. Transaction successful.",
"code": "0"
},
"authorizer": {
"message": "",
"code": "000"
},
"hashes": {
"general": "85E791AD85E791AD"
},
"dealers": [
{
"name": "Vivo SP Pos",
"code": "800",
"branches": [
{
"name": "Vivo SP Pos",
"code": "80019000000"
}
]
}
],
"questions": [
{
"id": "LPERG:126",
"display": "Identificação do cliente ou Número de contrato",
"rule": "0",
"min": "1",
"max": "11",
"type": "N"
}
]
}
}
List dealers with sent signature
Request:
curl
--request GET "https://esitef-homologacao.softwareexpress.com.br/e-sitef/v3/rechargedealers?nit=asdfghjk12345678asdfghjk12345678asdfghjk12345678asdfghjk12345678&generalhash=0000000000000000"
--header "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjaGFudF9pZCI6IkxPFGFURVNURSIsIm1lcmNoYW50X2tleSI6IkYxOURFMDAxNzdDMzAxREYyNEE4NjVGMTFBQTlCMjU2N0Y2MDQ4OTFGMEY0NEREQUVGRDY5RTMzOTlFMEI3RTEiLCJvcmRlcl9pZCI6IjEzMDE0ODU4NjYzIiwibWVyY2hhbnRfdXNuIjoiMTQ0NjY4MTAxNiIsInRpbWVzdGFtcCI6IjE2MDUzMDM1ODA5MzEifQ.JoYz8mQ8PZ8MCr5QXygbivAy2x9fvdUEGu_jSeOYF-BtSGm7ZSYWFVokyowabk1FM2NCklubb5eEB_-g9lCi1ntRQ9iqKhdldm-U8pl0V98u7Mv_hR-pcp6MHfqql0T-mhkOv1WkfYO1igck4N6EfsNu9iO126BwgvJQC456WjAUW5jgjRHboc6htvaak9NBs6yRVLNZY03cR9gKtQXMoHeXiCGeNU55_2W1SOeRJPk-OsyBzvVlZBX5RdfUjB2BOdRI7H2TDBBS-GZaMV3b2eS5_84JTySFnriCTXJ-Y1FzBnH60e4fTfAiYy1P_J-j9hyXjLYgtRu8jQd8ITfiFG3h4ZIysb4CA_lJNg_d4YuCqhBiZcpculcbfXlcrcfPV-CpDytfiLz34FDWH0Q7Vlna1YuSNOKPzDIUx1MOMZO9bpwaE6Q3kClkqri92-42yeLoUKH6PUrlMpE3JrfuBelALE4ce7QzCrNjcvoqR_KVmCm6ozBjPn9qY0s7x7qe6ZLur7hNUoX79JdWGZy1-bx8dSqqpLrU0SXbMBqtvch5FvdUkktbkJpZAr7q6e0nR13_mK3RTV7adOEw03E_ocUk__rEmjGDAHMSWGmiPowu14jD1-VZ2Yf8FeoKzHYcXmIbEReTVHshk9faBICMQzMS3SXaqow4WXqULZiLTwc"
--verbose
Response:
{
"list_dealers_response":{
"status":"NOV",
"esitef":{
"message":"OK. Transaction successful.",
"code":"0"
},
"authorizer":{
"message":"",
"code":"000"
},
"hashes":{
"general":"09A9681D09A9681D"
},
"dealers":[
{
"name":"Vivo",
"code":"001"
},
{
"name":"Claro",
"code":"002"
},
{
"name":"Oi",
"code":"003"
},
{
"name":"Tim",
"code":"004"
}
]
}
}
Request parameters
The table below describes the request parameters of the list dealers service:
| Parameter | Description | Format | Mandatory |
|---|---|---|---|
nit | Identification of the recharge transaction on e-SiTef | = 64 A | SIM |
generalhash | Identification code of the table with the data related to the recharges (dealers, branches, amount ranges, expiration periods, among others). | = 16 A | NÃO |
Response parameters
If successful, the HTTP response code will be 200. Any other code must be interpreted as an error. The table below describes the response parameters of the list dealers service:
| Parameter | Description | Format |
|---|---|---|
status | Status of the recharge transaction on e-SiTef. Learn more. | = 3 AN |
| esitef | ||
code | e-SiTef response code. Any code different from 0(zero) means failure. Learn more. | < 4 N |
message | e-SiTef response message. | < 500 AN |
| authorizer | ||
code | Response code returned by the authorizer | < 4 AN |
message | Message returned by the authorizer | < 64 AN |
| hashes | ||
general | Identification code of the table with the data related to the recharges (dealers, branches, amount ranges, expiration periods, among others). | = 16 AN |
| dealers[] | ||
code | Dealer code | = 3 N |
name | Dealer name | < 100 AN |
| dealers[].branches[] | ||
code | Branch code | = 11 N |
name | Branch name | < 100 AN |
| questions[] This field adds a list of questions for positive confirmation. The returned questions must, necessarily, be answered by the user and have their answers sent to e-SiTef in the next step (list branch data). | ||
id | Question identification code | < 20 AN |
display | Text of the question to be presented | < 180 AN |
rule | Indicates where the data must be collected. Learn more. | < 2 AN |
min | Indicates the minimum response size | < 4 N |
max | Indicates the maximum response size | < 5 N |
type | Indicates the data type of the response to be collected. Learn more. | < 3 AN |
min_value | Indicates the minimum response value | < 3 N |
max_value | Indicates the maximum response value | < 3 N |
Return of the questions.rule field
| Rule | Description |
|---|---|
0 | Operator keyboard |
1 | PinPad (Not applicable) |
2 | Magnetic track reading on PIN PAD (Not applicable) |
3 | Automation (The question should not be presented to the operator / customer to collect the response. In this case, the automation itself must answer the question without operator / customer intervention). |
4 | Supervisor password (not PINPAD) |
5 | Operator keyboard with double typing. The <Display> must contain two texts, the first one refers to the request for the input of the data and the second, refers to the confirmation of the input of the data, which must be the same as the first.The texts must be separated by ; as informed below.<Display> = Text for 1st collection; Text for 2nd collection (confirmation) |
6 | Barcode reader |
7 | Typing with confirmation (In this case, a screen must be displayed for confirmation of the collected data). |
Return of the questions.type field
| Type | Description |
|---|---|
A | Alphabetical. |
AN | Special alphanumeric (ans). |
LN | Letters (not accented) and numbers. |
Nx | Numeric where x is the number of decimal digits supported. |
Vx | Value with x decimal digits. |
S | Menu type Yes / No. |
Sc | Menu type Yes / No conditional. If the input is "No", the transaction must be aborted. |
M | Free menu. In this case, the <Display> field will have the following format: the menu text must be separated by a | character from the options. The options, in turn, should consist of index and text separated by :, while one option is separated by the other by ^. That is:<Display> = <Menu Text>|<option 1>^<option 2>^...^<option N>At where, <Menu Text> = Menu header text (Ex: Choose the banner of the card)<Option N> = <Index>:<Option Text> (Ex: 1:Visa) |
Mc | Free menu with confirmation. Here is the Free Menu rule, where: <Display> = <Menu Text>|<Confirmation Text>|<option 1>^<option 2>^...^<option N> |
M0 | Free menu type 0 (zero). (Not applicable) It follows the rule of the Free Menu with confirmation, however, the selection indexes of the menu in the display must be suppressed and only selected with the POS arrows. Free Menu Display Example: 1 – Yes2 – NoSample Free Menu Display Type 0: Yes No |