Sipag

This item will display specific characteristics for the Sipag via SiTef routing.

REST Payment#

Payment Effectuation#

Below are the parameters with specific data for Sipag transactions which the merchant's application can send on the payment effectuation service:

ParameterDescriptionFormatMandatory
external_authentication
ucaf_sliContains the UCAF (Universal Cardholder Authentication Field), which corresponds to SLI's last digit (Security Level Indicator) from Mastercard Secure Code.= 1 NNO
version3DS version (1 or 2).= 1 NNO
reference_idDirectory Server identifier for 3DS 2.0 transactions.< 36 ANNO
tavvDSRP-UCAF tokenized transaction cryptogram.< 40 ANNO
cavvCardholder Authentication Verification Value - Codes that refers to card holder authentication result data.< 40 NNO

Split Payment#

The Sipag via Sitef routing allows split payment. For this mode, the parameter acquirer.submerchant_split must be filled.

Request:

To use this example, don't forget to define the variable {{url}} with the value
esitef-homologacao.softwareexpress.com.br

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/payments/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
"card":{
"number":"5555555555555555",
"expiry_date":"1222",
"security_code":"123"
},
"acquirer":{
"submerchant_split":[
{
"submerchant_code":"empresa01",
"submerchant_amount":"10"
},
{
"submerchant_code":"empresa02",
"submerchant_amount":"20"
},
{
"submerchant_code":"empresa03",
"submerchant_amount":"20"
},
{
"submerchant_code":"empresa04",
"submerchant_amount":"30"
},
{
"submerchant_code":"empresa05",
"submerchant_amount":"30"
}
]
}
}
--verbose

Response:

{
"code": "0",
"message": "OK. Transaction successful.",
"payment": {
"authorizer_code": "000",
"authorizer_message": "APROVADA",
"status": "CON",
"nit": "1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
"authorizer_id": "1",
"acquirer_id": "229",
"acquirer_name": "Sipag",
"authorizer_date": "29/03/2019T13:26",
"authorization_number": "000058",
"merchant_usn": "20180809",
"esitef_usn": "190329026585100",
"sitef_usn": "000058",
"host_usn": "003000058 ",
"amount": "13000",
"payment_type": "C",
"issuer": "1",
"authorizer_merchant_id": "000000000000000",
"payment_date": "29/03/2019T13:26"
}
}