Virtual store's payment page

The merchant's payment page must contain the e-SiTef's script. Below are the URL's for download:

URL for Production environment:
https://esitef-ec.softwareexpress.com.br/js/esitefpayment-1.0.min.js

URL for Homologation environment:
https://esitef-homologacao.softwareexpress.com.br/js/esitefpayment-1.0.min.js

Fields with card data

The card fields must contain the classes specified below:

ParameterDescriptionFormatMandatory
esitef-cardnumberCustomer's card number (PAN).< 19 NYES
esitef-cardexpirydateCard expiry date in MMYY format.= 4 NYES
esitef-cardexpirymonth
& esitef-cardexpiryyear		Card expiry month and year, in MM and YY format, respectively. These fields can be sent instead of esitef-cardexpirydate. If all these fields are sent at the same time, the split date (esitef-cardexpirymonth and esitef-cardexpiryyear) will have priority.= 2 NYES
esitef-cardsecuritycodeCard security code.< 5 NYES
esitef-cardholderCard holder name. Only mandatory for payments with e-Rede, GetNet WS and VR (SmartNet).< 30 ANCOND.

Calling e-SiTef's script

When the customer fills the card data and clicks "pay", the merchant's page must call the esitefDoPayment JavaScript function, passing as argument a request with the following fields:

ParameterDescriptionFormatMandatory
nitTransaction identification in e-SiTef. The field nit received by the transaction creation service.= 64 ANYES
payTokenThe field pay_token received by the transaction creation service. This token can only be used once.= 66 ANYES
merchantIdMerchant code on e-SiTef. The production and certification codes will be different.< 15 ANYES
localeLanguage of the messages returned in validation errors (onInvalid callback). It can receive the following values:
pt - Portuguese
en - English
es - Spanish
If the locale is not sent, pt will be used.		= 2 ANO
isCardSecurityCode
Optional		Defines if the card security code will be validated as a mandatory or optional field. Send true if it's an optional field. If this field is not sent, the value false will be used (mandatory security code).< 5 T/FNO
onSuccessCallback function the will be called after a successful payment on e-SiTef. This function receives as argument the payment response described in Success and failure callbacks response.FYES
onFailureCallback function the will be called after an unsuccessful payment on e-SiTef. This function receives as argument the payment response described in Success and failure callbacks response.FYES
onInvalidCallback function that will be called after a JavaScript validation error. This function receives as argument the error list described in Validation error callback responseFYES

Success and failure callbacks response

The onSuccess and onFailure callback functions receive as argument an object containing information related to the payment. Below are the descriptions of these fields:

ParameterDescriptionFormat
codee-SiTef response code. Any code different from 0 (zero) means failure. For further information, refer to the Response codes.< 4 N
messagee-SiTef response message.< 500 AN
payment
authorizer_codeAuthorizer response code.< 10 AN
authorizer_messageAuthorizer response message.< 500 AN
statusStatus of the payment transaction on e-SiTef.= 3 AN
nitIdentifier of the payment transaction on e-SiTef.= 64 AN
order_idOrder code sent by the merchant on the creation of the transaction.< 40 AN
customer_receiptCustomer's receipt.< 4000 AN
authorizer_idCode of the authorizer used on the transaction.< 4 N

Validation error callback response

The onInvalid callback function receives as argument a list of error objects, containing the fields below:

ParameterDescriptionFormat
fieldName of the field in error.< 30 AN
causeError message.< 100 AN

Example

Below is an example of a page integrated with e-SiTef's JavaScript payment:

<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8" />
    <script type="text/javascript" src="https://esitef-
homologacao.softwareexpress.com.br/js/esitefpayment-1.0.min.js"></script>
    <script>
        function myPay() {
            var request = {
                onSuccess: function(response) {
                    console.log(response.code);
                    console.log(response.message);
                    console.log(response.payment.authorizer_code);
                    console.log(response.payment.authorizer_message);
                    console.log(response.payment.status);
                    console.log(response.payment.nit);
                    console.log(response.payment.order_id);
                    console.log(response.payment.customer_receipt);
                    console.log(response.payment.authorizer_id);
                },
                onFailure: function(response) {
                    console.log(response.code);
                    console.log(response.message);
                    console.log(response.payment.authorizer_code);
                    console.log(response.payment.authorizer_message);
                    console.log(response.payment.status);
                    console.log(response.payment.nit);
                    console.log(response.payment.order_id);
                    console.log(response.payment.authorizer_id);
                },
                onInvalid: function(errors) {
                    for (var i = 0; i < errors.length; i++) {
                        console.log(errors[i].field);
                        console.log(errors[i].cause);
                    }
                },
                nit: ‘1234567890123456789012345678901234567890123456789012345678901234',
                payToken: ‘123456789012345678901234567890123456789012345678901234567890123456',
                merchantId: 'xxxxxxxx',
                locale: 'pt',
                isCardSecurityCodeOptional: false
            };
            esitefDoPayment(request);
        }
    </script>
</head>

<body>
    <form method="POST">
        <input type="text" class="esitef-cardnumber" />
        <input type="text" class="esitef-cardexpirymonth" />
        <input type="text" class="esitef-cardexpiryyear" />
        <input type="text" class="esitef-cardsecuritycode" />
        <input type="button" onclick="myPay()" />
    </form>
</body>

</html>
← Transaction creation serviceTransaction query service →