Recharge confirmation service

Call details

Resource: /v3/recharge/{nit}
HTTP Method: PUT
Request format: JSON
Response format: JSON
Header parameters:

Parameter	Description	Format	Mandatory
`Content-Type`	It must be sent with the value `application/json`.	= 15 AN	YES
`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 is an example of the recharge confirmation service call using the cURL tool.

Request:

curl
--request PUT "https://esitef-homologacao.softwareexpress.com.br/e-sitef/v3/recharge/asdfghjk12345678asdfghjk12345678asdfghjk12345678asdfghjk12345678"
--header "Content-Type: application/json"
--data-binary
{
   "confirm_recharge_request":{
      "confirm":"true",
      "merchant_key":"AOSDJF210349H3R0374H874H3T7AHG90SF"
   }
}
--verbose

Response:

{
   "confirm_recharge_response":{
      "esitef":{
         "message":"OK",
         "code":"0"
      },
      "status":"CON",
      "payment":{
         "status":"CON"
      }
   }
}

Request parameters

The table below describes the request parameters of the recharge confirmation service:

Parameter	Description	Format	Mandatory
`confirm`	It must receive the value `true` if it’s desired to confirm the recharge and its associated payment (if it exists). It must be set to `false` to undo the recharge and its associated payment (if any).	< 5 AN	YES
`merchant_key`	Merchant key on e-SiTef used on the recharge transaction.	< 80 AN	YES
used_payment_methods[]	Payment methods used to recharge. The user must follow the same rules described in Recharge effectuation service corresponding chapter to fill this field. In the case of TIM recharge, it is mandatory to send this field if you do not want the “Other forms” payment type (code 99) to be assumed.		COND.

Response parameters

In case of success, the HTTP response code will be 200. Any other code must be interpreted as an error. The table below describes de response parameters of the recharge confirmation 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
	payment
`status`	Status of the payment transaction on e-SiTef, if it exists. Learn more.	= 3 AN