Redsys | Desarrolladores

Preautorización y confirmación

Este tipo de operación permite al comercio bloquear un cierto importe en la tarjeta del cliente, esto no supone realizar el pago, sino que trata de asegurar, previo a un pago, que el importe estará disponible en su momento.

IMPORTANTE: En la petición REST, el valor del parámetro Ds_Merchant_TransactionType debe ser "1".

Una autorización puede realizarse mediante las siguientes vías de integración:

Modalidad REST

Ejemplo de pago con autorización vía REST.

Petición preautorización REST
Respuesta preautorización REST

							
{
  "DS_MERCHANT_AMOUNT": "145",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_CVV2": "123",
  "DS_MERCHANT_EXPIRYDATE": "1512",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_ORDER": "4366",
  "DS_MERCHANT_PAN": "454881********04",
  "DS_MERCHANT_TERMINAL": "1",
  "DS_MERCHANT_TRANSACTIONTYPE": "1"
}

Se recibe la respuesta, cuyo parámetro "Ds_Response" indica que se ha realizado correctamente la preautorización si su valor es "0000":

								
{
  "Ds_Amount": "145",
  "Ds_AuthorisationCode": "547481",
  "Ds_CardNumber": "4548810000000003",
  "Ds_Card_Brand": "1",
  "Ds_Card_Country": "724",
  "Ds_Currency": "978",
  "Ds_ExpiryDate": "3912",
  "Ds_Language": "1",
  "Ds_MerchantCode": "999008881",
  "Ds_MerchantData": "",
  "Ds_Order": "4366",
  "Ds_Response": "0000",
  "Ds_SecurePayment": "0",
  "Ds_Terminal": "1",
  "Ds_TransactionType": "1"
}

IMPORTANTE: Para hacer efectivo el cargo de la preautorización es necesario realizar una segunda petición, con el valor del parámetro Ds_Merchant_TransactionType a "2", utilizando el mismo número de pedido y terminal que en la preautorización.

Petición confirmación preautorización REST
Respuesta confirmación preautorización REST

										
{
  "DS_MERCHANT_AMOUNT": "145",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_ORDER": "4366",
  "DS_MERCHANT_TERMINAL": "1",
  "DS_MERCHANT_TRANSACTIONTYPE": "2"
}

Cuya respuesta, si se ha realizado correctamente, nos devuelve el parámetro "Ds_Response" con un valor "0900":

								
{
  "Ds_Amount": "145",
  "Ds_AuthorisationCode": "313844",
  "Ds_Card_Brand": "1",
  "Ds_Card_Country": "724",
  "Ds_Card_Type": "C",
  "Ds_Currency": "978",
  "Ds_Language": "1",
  "Ds_MerchantCode": "999008881",
  "Ds_MerchantData": "",
  "Ds_Order": "4366",
  "Ds_Response": "0900",
  "Ds_SecurePayment": "0",
  "Ds_Terminal": "1",
  "Ds_TransactionType": "2"
}

Modalidad Redirección

Ejemplo de pago con preautorización vía Redirección.

Petición preautorización Redirección
Respuesta preautorización Redirección

							
{
  "DS_MERCHANT_ORDER":"1575967259",
  "DS_MERCHANT_MERCHANTCODE":"999008881",
  "DS_MERCHANT_TERMINAL":"999",
  "DS_MERCHANT_CURRENCY":"978",
  "DS_MERCHANT_TRANSACTIONTYPE":"1",
  "DS_MERCHANT_AMOUNT":"1000",
  "DS_MERCHANT_MERCHANTURL":"http://www.prueba.com/urlNotificacion.php",
  "DS_MERCHANT_URLOK":"http://www.prueba.com/urlOK.php",
  "DS_MERCHANT_URLKO":"http://www.prueba.com/urlKO.php"
}

Se recibe la respuesta, cuyo parámetro "Ds_Response" indica que se ha realizado correctamente la preautorización si su valor es "0000":

								
{
  "Ds_Date":"10%2F12%2F2019",
  "Ds_Hour":"09%3A41",
  "Ds_SecurePayment":"0",
  "Ds_Card_Type":"D",
  "Ds_Card_Country":"724",
  "Ds_Amount":"1000",
  "Ds_Currency":"978",
  "Ds_Order":"1575967259",
  "Ds_MerchantCode":"999008881",
  "Ds_Terminal":"1",
  "Ds_Response":"0000",
  "Ds_MerchantData":"",
  "Ds_TransactionType":"1",
  "Ds_ConsumerLanguage":"1",
  "Ds_AuthorisationCode":"372663",
  "Ds_Card_Brand":"2"
}

IMPORTANTE: Para hacer efectivo el cargo de la preautorización es necesario realizar una segunda petición, con el valor del parámetro Ds_Merchant_TransactionType a "2", utilizando el mismo número de pedido y terminal que en la preautorización.

Petición confirmación preautorización Redirección
Respuesta confirmación preautorización Redirección

										
{
  "DS_MERCHANT_ORDER":"1575967259",
  "DS_MERCHANT_MERCHANTCODE":"999008881",
  "DS_MERCHANT_TERMINAL":"999",
  "DS_MERCHANT_CURRENCY":"978",
  "DS_MERCHANT_TRANSACTIONTYPE":"2",
  "DS_MERCHANT_AMOUNT":"1000",
  "DS_MERCHANT_MERCHANTURL":"http://www.prueba.com/urlNotificacion.php",
  "DS_MERCHANT_URLOK":"http://www.prueba.com/urlOK.php",
  "DS_MERCHANT_URLKO":"http://www.prueba.com/urlKO.php"
}

Cuya respuesta, si se ha realizado correctamente, nos devuelve el parámetro "Ds_Response" con un valor "0900":

								
{
  "Ds_Date":"10%2F12%2F2019",
  "Ds_Hour":"09%3A41",
  "Ds_SecurePayment":"0",
  "Ds_Card_Type":"D",
  "Ds_Card_Country":"724",
  "Ds_Amount":"1000",
  "Ds_Currency":"978",
  "Ds_Order":"1575967259",
  "Ds_MerchantCode":"999008881",
  "Ds_Terminal":"1",
  "Ds_Response":"0900",
  "Ds_MerchantData":"",
  "Ds_TransactionType":"2",
  "Ds_ConsumerLanguage":"1",
  "Ds_AuthorisationCode":"372663",
  "Ds_Card_Brand":"2"
}

Modalidad InSite

Ejemplo de pago con autorización vía InSite.

Petición preautorización InSite
Respuesta preautorización InSite

							
{
  "DS_MERCHANT_AMOUNT": "145",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_ORDER": "1446068581",
  "DS_MERCHANT_IDOPER": "9c75f357629acb672e0f5444401d138f02e834ad ",
  "DS_MERCHANT_TERMINAL": "1",
  "DS_MERCHANT_TRANSACTIONTYPE": "1"
}

Se recibe la respuesta, cuyo parámetro "Ds_Response" indica que se ha realizado correctamente la preautorización si su valor es "0000":

								
{
  "Ds_Amount": "145",
  "Ds_AuthorisationCode": "501602",
  "Ds_CardNumber": "4548810000000004",
  "Ds_Card_Brand": "1",
  "Ds_Card_Country": "724",
  "Ds_Currency": "978",
  "Ds_Language": "1",
  "Ds_MerchantCode": "999008881",
  "Ds_Order": "1446068581",
  "Ds_Response": "0000",
  "Ds_SecurePayment": "0",
  "Ds_Terminal": "1",
  "Ds_TransactionType": "1"
}

IMPORTANTE: Para hacer efectivo el cargo de la preautorización es necesario realizar una segunda petición, con el valor del parámetro Ds_Merchant_TransactionType a "2", utilizando el mismo número de pedido y terminal que en la preautorización.

Petición confirmación preautorización InSite
Respuesta confirmación preautorización InSite

										
{
  "DS_MERCHANT_AMOUNT": "145",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_ORDER": "1446068581",
  "DS_MERCHANT_TERMINAL": "1",
  "DS_MERCHANT_TRANSACTIONTYPE": "2"
}

Cuya respuesta, si se ha realizado correctamente, nos devuelve el parámetro "Ds_Response" con un valor "0900":

								
{
  "Ds_Amount": "145",
  "Ds_AuthorisationCode": "501602",
  "Ds_CardNumber": "4548810000000004",
  "Ds_Card_Brand": "1",
  "Ds_Card_Country": "724",
  "Ds_Currency": "978",
  "Ds_Language": "1",
  "Ds_MerchantCode": "999008881",
  "Ds_Order": "1446068581",
  "Ds_Response": "0900",
  "Ds_SecurePayment": "0",
  "Ds_Terminal": "1",
  "Ds_TransactionType": "2"
}