Bradescard
The merchant has the possibility to configure the routing of transactions made in e-SiTef, one of these routings is Bradescard.
Supported e-SiTef interfaces
We will use the following interfaces for integration with Bradescard routing:
- REST Payment
- HTML Payment
- REST Cancellation
- Cancellation via Merchant's Portal
- REST Generic operations for Bradescard queries
Bradescard query service
In the Bradescard queries, it is possible to make the statement summary query and to make the balance query of a specific card.
Call details
The Bradescard query service is provided by the generic operation interface (Learn more). The Bradescard query operation is mandatory the authenticity token for each query performed, so it is necessary to obtain the token (Learn more) and then perform the generic operation call (Learn more).
The Bradescard query is identified with operation code 172 (use this value in the operation field in the request).
Parameters of Bradescard queries
Below are the parameters that are used by the request for Bradescard query operation.
| Parameter | Description | Format | Mandatory |
|---|---|---|---|
date | Fiscal date. | N | No |
time | Fiscal hour. | N | No |
subfunction | Query transaction subfunction. The following queries are planned: 01 - Balance query 02 - Statement Summary query | 2 N | No |
card_entry_mode | Entry mode. The possible values for this field are: 1 – Magnetic card 2 – Card number entered | 1 N | Yes |
card_number | This field must be filled with the card number. | N | Conditional Yes, if card_entry_mode_type is equal to "2" |
track1 | This field must be filled with the track 1 of the card. | < 99 AN | Conditional Yes, if card_entry_mode_type is equal to "1" |
track2 | This field must be filled with the track 2 of the card. | < 99 N | Conditional Yes, if card_entry_mode_type is equal to "1" |
card_expiry_date | Card expiration date. | 4 N (MMYY) | Conditional Yes, if card_entry_mode_type is equal to "2" |
card_security_code | Security code. | < 10 N | Conditional Yes, if requested in the card query (Learn more). |
card_issue_date | Card issue date. | 6 N (MMYYYY) | Conditional Yes, if requested in the card query (Learn more). |
Response parameters
If successful, the HTTP response code will be 200. Any other code must be interpreted as an error. In the table below is the description of the response parameters of the Bradescard query service:
| Parameter | Description |
|---|---|
response_code | E-SiTef response code. |
response_message | Reply message from e-SiTef. |
authorizer_response_code | Authorizer response code. |
authorizer_response_message | Authorizer reply message. |
parameters.date | Date. |
parameters.time | Hour. |
parameters.acquirer_id | Acquirer id in SiTef. |
parameters.host_usn | Host USN. |
parameters.sitef_usn | SiTef USN. |
parameters.institution_response_code | Authorizer/acquirer response code. |
parameters.institution_name | Institution Name. |
parameters.authorization_number | Authorization number. |
parameters.affiliation_code | Merchant affiliation code in authorizer/acquirer. |
parameters.confirmation_data | Confirmation data. |
parameters.customer_receipt | Customer's receipt. |
parameters.merchant_receipt | Merchant's receipt. |
parameters.sale_response_data | Sale response data. |