La operativa Bizum se puede realizar de diferentes formas, desde una integración directamente en la pasarela de pago, por la que no tendrás que realizar ningún tipo de adaptación ni desarrollo en tu página web, o mediante la inclusión del método de pago en tu web en el momento de dirigir a tu cliente a la pasarela de pagos.
En este apartado, vas a aprender a cómo integrar la segunda opción. En la mayoría de casos, la integración por redirección de Bizum es prácticamente idéntica a la de un pago normal con tarjeta, por lo que seguramente tendrás que cambiar pocas cosas para poder incorporar esta integración a tus métodos de pago ofrecidos.
Para todas las operaciones se deben enviar tres campos:
| Campo | Tipo | Descripción |
|---|---|---|
| Ds_MerchantParameters | Cadena | Son los parámetros de la operación, donde se incorporan los datos básicos de la misma, como el importe, el número de pedido, etcétera… Esta cadena se trata de un JSON con los parámetros que se desea enviar, codificada en base64URL. |
| Ds_Signature | Cadena | Es la firma de los parámetros enviados. Esta firma permite tener la certeza de que los datos no han sido alterados «en vuelo» y que la operación y sus atributos mantiene su integridad. Tienes más información sobre cómo se calcula en este enlace. |
| Ds_SignatureVersion | Cadena | Es una constante que indica la versión de firma que se está utilizando, en este caso HMAC_SHA512_V2. |
Dentro del campo Ds_MerchantParameters, se encuentran todos los parámetros necesarios para procesar la operación. Algunos de ellos son obligatorios, y la operación no podrá continuar si no se envían correctamente, por ello vamos a ver un ejemplo de todos los necesarios para procesar una operación. Tienes más información sobre todos los parámetros que se pueden adjuntar en una operación en la sección del glosario de parámetros.
| Parámetro | Tipo y longitud máxima | Descripción |
|---|---|---|
| Ds_Merchant_Amount | Numérico. 12 posiciones. | Es el importe de la operación, expresado en la unidad fraccionaria más baja que tenga la moneda (por ejemplo en el Euro, en céntimos). Es decir, en el importe no se enviarán decimales, y la moneda enviada determinará el valor real (de nuevo, en Euro: en una operación de 12,49€ se enviaría 1249). |
| Ds_Merchant_Currency | Numérico. 3 posiciones. | Es el valor numérico del código ISO-4217 de la moneda que se utilizará en la operación. En el caso del Euro, sería el 978. Tienes la tabla de monedas completa en este enlace. |
| Ds_Merchant_MerchantCode | Numérico. 9 posiciones. | Es el código FUC asignado a tu comercio y que te debió facilitar tu entidad bancaria por correo cuando diste de alta tu TPV Virtual. |
| Ds_Merchant_Order | Alfanumérico. 12 posiciones. | Es el número de pedido que identificará a la orden dentro del Portal de Administración del TPV Virtual y en los informes que puedas obtener en dicho portal. Te recomendamos que tenga más de 4 posiciones para evitar posibles problemas en el proceso de totalización. |
| Ds_Merchant_Terminal | Numérico 3 posiciones. | Es el número de terminal de tu comercio sobre el que vas a operar. Debe estar junto al número de comercio que te envió tu entidad bancaria y, en la mayoría de casos, es el 001. |
| Ds_Merchant_TransactionType | Numérico. 1 posición. | Es el tipo de operación que se va a efectuar. Tienes más información sobre los tipos de operación disponibles en la sección del glosario de parámetros. |
| Ds_Merchant_PayMethods | Alfanumérico. 1 posición. | Es el tipo de operativa que vas a enviar al TPV Virtual y que debe tener el valor «z» para poder ser redirigido directamente a Bizum. |
Las pruebas de Bizum deberás realizarlas usando los parámetros de prueba que se enuncian a continuación, o de lo contrario no podrás completar ningún flujo.
| Número de teléfono Bizum | Caso de prueba / Resultado de la operación |
|---|---|
| 700 000 000 | Operación autorizada con éxito. |
| ko@ko.ko | Error de autenticación en clave Bizum. |
Para probar las diferentes casuísticas, deberás tener en cuenta los importes que se detallan en la siguiente tabla.
| Importe | Cliente Bizum | Cliente RTP | Resultado | Descripción en consulta RTP | Descripción en pago vía REST |
|---|---|---|---|---|---|
| Inferior a 5€ | OK | OK | OK | El teléfono usuario tiene activo RTP y acepta exenciones. | En la petición inicial se recibe OK y se comprueba que autentica. |
| Entre 5€ y 10€ | OK | OK | KO | El teléfono usuario tiene activo RTP pero no exenciones. | En la petición inicial se recibe OK, pero se comprueba que se deniega. |
| Entre 10€ y 15€ | OK | KO | – | El teléfono usuario no tiene activo RTP. | Se recibe denegación con error BIZ00202. |
| Entre 75€ y 80€ | OK | OK | OK | – | Se recibe respuesta de que se permite respaldar y, al terminar flujo, la operación queda autorizada. |
| Entre 80€ y 85€ | OK | OK | KO | – | Se recibe respuesta de que se permite respaldar y, al terminar flujo, la operación queda denegada. |
| Resto de importes | KO | KO | KO | El teléfono usuario no tiene activo Bizum. | Se recibe denegación con error BIZ00009. |
Realización de un pago usando una integración vía Redirección con Bizum
¿Debes cumplir con PCI DSS?
Con este tipo de integración, no tendrás que preocuparte de cumplir con la directiva europea PCI-DSS, ya que el tratamiento de datos de la tarjeta se realiza dentro de nuestros servidores, y ningún dato real de la tarjeta del cliente es procesado por tu sitio web.
En la modalidad de redirección, deberás tener en cuenta que tienes que capturar todos los datos relevantes de la transacción para enviarla al TPV Virtual mediante una petición POST a nuestros servidores. La petición se deberá realizar a una de las siguientes URLs según el entorno donde te encuentres trabajando, ya sea haciendo pruebas en nuestro entorno de Test, o ya en producción en nuestro entorno de Real.
| Entorno | URL de Conexión |
|---|---|
| Pruebas | https://sis-t.redsys.es:25443/sis/realizarPago |
| Real | https://sis.redsys.es/sis/realizarPago |
Envío de la petición al TPV Virtual
Sabiendo los datos que se deben enviar, a continuación se muestra un ejemplo del proceso de envío de datos al TPV Virtual. En nuestro caso vamos a realizar una operación de autorización por importe de 2,49€, al comercio 999008881 y terminal 001, usando la clave de firma de pruebas. Los datos para realizar pruebas los tienes disponibles en la sección de entornos y datos de pruebas.
En primer lugar, el campo Ds_MerchantParameters se compondría de un JSON con la siguiente información:
Nótese que se incluye un campo llamado Ds_Merchant_MerchantURL. En este campo se indica la URL a la cual se enviará la notificación con el resultado de la operación, que se enviará una vez se haya procesado la misma.
Además, se incorpora el parámetro Ds_Merchant_PayMethods con el valor «z» para llamar directamente a Bizum.
{
"DS_MERCHANT_ORDER": "00014338z744",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_TERMINAL": "001",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_TRANSACTIONTYPE": "0",
"DS_MERCHANT_PAYMETHODS": "z",
"DS_MERCHANT_AMOUNT": "249",
"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"
}
Los parámetros Ds_Merchant_URLOK y Ds_Merchant_URLKO son la distintas URLs hacia donde se enviará al cliente cuando finalice la operación en nuestro sistema. Puedes configurar desde el Portal de Administración del TPV Virtual, que en estas URLs se envíe también el resultado de la operación, para que así puedas mostrarle al cliente, el importe, número de pedido, etc… en la pantalla de información. Recuerda que siempre se enviará la notificación a la URL que hayas configurado en Ds_Merchant_MerchantURL independientemente de que indiques o no URLs de OK y de KO.
Ten en cuenta que también puedes incorporar el parámetro Ds_Merchant_Bizum_MobileNumber con el número de teléfono móvil del cliente incluyendo el prefijo, normalmente +34, para que cuando tu cliente llegue al TPV Virtual, su teléfono ya esté relleno y sólo tenga que confirmar la operación.
El objeto JSON resultante, deberás codificarlo en base64URL, tal cual lo tienes. Consiguiendo un resultado parecido al siguiente (habiendo minificado el JSON anterior):
ew0KICAiRFNfTUVSQ0hBTlRfT1JERVIiOiAiMDAwMTQzMzh6NzQ0IiwNCiAgIkRTX01FUkNIQU5UX01FUkNIQU5UQ09ERSI6ICI5OTkwMDg4ODEiLA0KICAiRFNfTUVSQ0hBTlRfVEVSTUlOQUwiOiAiMDAxIiwNCiAgIkRTX01FUkNIQU5UX0NVUlJFTkNZIjogIjk3OCIsDQogICJEU19NRVJDSEFOVF9UUkFOU0FDVElPTlRZUEUiOiAiMCIsDQogICJEU19NRVJDSEFOVF9QQVlNRVRIT0RTIjogInoiLA0KICAiRFNfTUVSQ0hBTlRfQU1PVU5UIjogIjI0OSIsDQogICJEU19NRVJDSEFOVF9NRVJDSEFOVFVSTCI6ICJodHRwOi8vd3d3LnBydWViYS5jb20vdXJsTm90aWZpY2FjaW9uLnBocCIsDQogICJEU19NRVJDSEFOVF9VUkxPSyI6ICJodHRwOi8vd3d3LnBydWViYS5jb20vdXJsT0sucGhwIiwNCiAgIkRTX01FUkNIQU5UX1VSTEtPIjogImh0dHA6Ly93d3cucHJ1ZWJhLmNvbS91cmxLTy5waHAiDQp9
Posteriormente, deberás firmar esta cadena siguiendo los pasos de creación de firma que puedes consultar en el apartado firmar una operación, usando la clave de firma del comercio. La cadena resultante será el campo Ds_Signature. Por último, se adjuntará a la petición la versión del algoritmo de firma a usar en el campo Ds_SignatureVersion, en este caso HMAC_SHA512_V2. Como resultado, obtendremos finalmente un formulario HTML como el que se muestra, y que se deberá enviar vía HTTP POST a la URL del TPV Virtual tal y como se indica en la línea resaltada.
<form name="from" action="https://sis-t.redsys.es:25443/sis/realizarPago" method="POST">
<input type="hidden" name="Ds_SignatureVersion"
value="HMAC_SHA512_V2" />
<input type="hidden" name="Ds_MerchantParameters"
value="ew0KICAiRFNfTUVSQ0hBTlRfT1JERVIiOiAiMDAwMTQzMzh6NzQ0IiwNCiAgIkRTX01FUkNIQU5UX01FUkNIQU5UQ09ERSI6ICI5OTkwMDg4ODEiLA0KICAiRFNfTUVSQ0hBTlRfVEVSTUlOQUwiOiAiMDAxIiwNCiAgIkRTX01FUkNIQU5UX0NVUlJFTkNZIjogIjk3OCIsDQogICJEU19NRVJDSEFOVF9UUkFOU0FDVElPTlRZUEUiOiAiMCIsDQogICJEU19NRVJDSEFOVF9QQVlNRVRIT0RTIjogInoiLA0KICAiRFNfTUVSQ0hBTlRfQU1PVU5UIjogIjI0OSIsDQogICJEU19NRVJDSEFOVF9NRVJDSEFOVFVSTCI6ICJodHRwOi8vd3d3LnBydWViYS5jb20vdXJsTm90aWZpY2FjaW9uLnBocCIsDQogICJEU19NRVJDSEFOVF9VUkxPSyI6ICJodHRwOi8vd3d3LnBydWViYS5jb20vdXJsT0sucGhwIiwNCiAgIkRTX01FUkNIQU5UX1VSTEtPIjogImh0dHA6Ly93d3cucHJ1ZWJhLmNvbS91cmxLTy5waHAiDQp9" />
<input type="hidden" name="Ds_Signature"
value="gdqnlJuSYXeygVTH1KGAJIl_ddAfFT7p1oO6yeVAxPNmvcJIXt1JyouXPX7p_edq67PPgVdBtdBq62PsqdRT-w" />
</form>
Respuesta del TPV Virtual
Una vez realizada la petición utilizando el navegador del cliente que está comprando en tu sitio Web, nuestro servidor tomará el control de la navegación del cliente, mostrando una serie de pantallas para poder introducir los datos de su tarjeta y autenticarse, así como los datos de la operación para que pueda saber, por ejemplo, por valor de cuánto importe está realmente comprando.
Cuando este proceso haya terminado, ocurrirán dos cosas: primero de todo, se enviará una notificación HTTP POST a la URL que el comercio especificó en el parámetro Ds_Merchant_MerchantURL que contendrá los detalles de la operación y el resultado de la misma. Posteriormente, el cliente será devuelto automáticamente o cuando pulse «continuar», según sea la configuración de tu TPV Virtual, a tu página web y, con esta redirección a tu Web, se acompañará si así lo has solicitado a tu entidad bancaria, los datos de la operación por vía HTTP GET para que puedas presentar en tu front el resultado de la operación a tu cliente si tienes personalizada la página de vuelta o los valores de URLOK y URLKO.
Tratamiento de la notificación HTTP POST
Nuestro servidor no enviará una notificación en caso de que se produzca un error con los parámetros de entrada, o lo que es lo mismo, en caso de que los parámetros básicos de una operación que debes envíar a nuestro servidor (número de pedido, firma, importe, moneda,…) esté mal formado o se produzca un error (número de pedido repetido, error de firma,…) no recibirás respuesta alguna de la petición. Por ello, te recomendamos que pruebes todos los casos de uso de tu sistema para cerciorarte de que no se producen este tipo de errores ya que, una vez en producción, no tendrás forma de saber que se están produciendo salvo que te notifiquen tus clientes, que sí estarán viendo una pantalla de error parecida a esta:

En caso de que todo vaya correctamente, nuestro servidor responderá con un formulario exactamente igual que el que enviaste, que contiene Ds_MerchantParameters, Ds_Signature y Ds_SigantureVersion. Te recomendamos que, antes de realizar cualquier acción, firmes los parámetros recibidos siguiendo nuestro apartado de firmar una operación y compruebes que la firma que has calculado y la que has recibido de nuestro servidor coinciden, para así estar seguro que los datos no han sido interceptados y modificados en el camino.
Una vez hecho, procede a descodificar el campo Ds_MerchantParameters que has recibido en base64, para encontrar dentro de estos los parámetros de la operación, con algún campo más. El más importante, el campo Ds_Response, que indica el resultado de la operación de manera numérica: si en él se recibe 0000, significa que la operación ha ido correctamente, en cualquier otro caso, indicará el código de error.
Deberás utilizar la información incluida en la notificación HTTP POST para validar el pedido y realizar los procedimientos que creas oportunos en tu web ya que, a partir de este punto, el control de la gestión del pedido es todo tuyo.
{
"Ds_Date": "10%2F11%2F2026",
"Ds_Hour": "16%3A28",
"Ds_SecurePayment": "1",
"Ds_Amount": "500",
"Ds_Currency": "978",
"Ds_Order": "00014338z744",
"Ds_MerchantCode": "999008881",
"Ds_Terminal": "001",
"Ds_Response": "0000",
"Ds_TransactionType": "0",
"Ds_AuthorisationCode": "000000",
"Ds_Card_Number": "000000******0000",
"Ds_ConsumerLanguage": "1",
"Ds_Bizum_CuentaTruncada": "ES51XXXXXXXXXXXXXXXX0001",
"Ds_Bizum_MobileNumber": "347XXXXX000",
"Ds_Bizum_IdOper": "21299716593977804822818564200702835",
"Ds_ProcessedPayMethod": "68",
"Ds_Control_1794324499943": "1794324499943"
}
Tratamiento del retorno de navegación y datos recibidos vía HTTP GET
¡Tenlo en cuenta!
Te recomendamos que nunca utilices los datos enviados vía HTTP GET para validar tu pedido, y que utilices sólo los enviados en la notificación HTTP POST tal y como se ha explicado anteriormente; ya que el cliente podría cerrar la pantalla de pago una vez vea que la operación se ha realizado correctamente y nunca sabrías el resultado de la operación.
Cuando la operación se complete en nuestro servidor, el cliente podrá ver un cuadro de confirmación de la operación, denominado «Recibo Redsys», y que será muy parecido a este:

Una vez que el cliente ha realizado el proceso de pago, al pulsar sobre «Continuar», se le redirigirá de nuevo a tu tienda usando la URL comunicada como parámetro en la llamada inicial al TPV Virtual o, en su defecto, se obtendrá la configuración del Módulo de Administración del TPV Virtual.
- Ten en cuenta que, si no estableces una URLOK y URLKO, ya sea enviándolas en la petición o directamente en el Portal de Administración del TPV Virtual, cuando tu cliente pulse sobre continuar en el recibo de la operación, se cerrará la ventana donde se encuentra ya que no hay ningún punto a donde redirigir.
- Si usas URLOK y URLKO, en cada una de ellas deberás decidir como se realiza el flujo, por ejemplo mostrando una pantalla de información con los datos del pedido en URLOK y una pantalla de error y un botón de volver al carrito en URLKO. Si tuvieras configuradas estas URLs en el Portal de Administración del TPV Virtual, se cogerá la información de este lugar y, si además las envías en la petición al TPV Virtual, serán las que envíes las que tendrán preferencia sobre las configuradas en el Portal de Administración del TPV Virtual.
La operativa de doble flujo te permite realizar de manera separada la autenticación y la autorización de la operación del cliente. La autenticación se realiza mediante una petición por conexión de redirección al TPV Virtual, usando el tipo de operación 7.
{
"DS_MERCHANT_ORDER": "00014338z744",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_TERMINAL": "001",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_TRANSACTIONTYPE": "7",
"DS_MERCHANT_PAYMETHODS": "z",
"DS_MERCHANT_AMOUNT": "249",
"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"
}
Una vez hayas realizado la autenticación, tendrás un máximo de 30 días para poder lanzar la autorización de la operación. Debes tener en cuenta que esta petición de autorización se debe realizar usando conexión REST, que se explica en el apartado siguiente a la conexión por redirección. La petición se deberá realizar usando el tipo de operación 8.
Hasta que no hagas la petición de autorización, el pago no será efectivo.
Realización de un pago usando una integración vía REST
Para utilizar la operativa Bizum a través de una integración REST, es obligatorio que el titular, es decir, tu cliente que está pagando, tenga habilitada la funcionalidad Request to Pay (RTP) en su entidad bancaria. No te preocupes por esto porque actualmente la práctica totalidad de los usuarios tienen esta funcionalidad activada y funcionando.
En este modelo, el comercio envía una petición REST al TPV Virtual indicando que la transacción debe gestionarse mediante RTP. Una vez recibida y procesada, Bizum genera y envía una notificación push al teléfono móvil del titular a través de la app de su banco. Esta notificación contiene la solicitud de pago, que el titular deberá revisar y aceptar o rechazar desde su aplicación bancaria, sin necesidad de regresar al navegador o a la página del comercio.
Pese a que la gran mayoría de usuarios ya están adheridos a la operativa RTP, recomendamos encarecidamente que el proceso de consulta de funcionalidad RTP esté incorporado en el flujo habitual que sigas durante el proceso de pago por Bizum. El servicio de consulta te responderá con el estado de Bizum del cliente dado:
- El cliente tiene el servicio de Bizum activo y además soporta RTP. En este caso, podrás solicitar el pago por Bizum tanto en modalidad Redirección como en la modalidad REST que explicamos en este apartado.
- El cliente tiene el servicio de Bizum activo pero no soporta RTP. En este caso, deberás solicitar el pago por Bizum por redirección.
- El cliente no tiene el servicio de Bizum activo. No podrás procesar el pago por Bizum y deberás utilizar un método de pago alternativo, como pago con tarjeta.
Además de otras comprobaciones según los parámetros que pongas en la petición.
Solicitud de consulta Request to Pay
Como en cualquier tipo de integración REST, deberás enviar una petición POST con los parámetros generales de cualquier petición al TPV Virtual, véase Ds_MerchantParameters, Ds_SignatureVersion y Ds_Signature. Estos parámetros deben enviarse al TPV Virtual, según el entorno, a las siguientes URLs:
| Entorno | URL de Conexión |
|---|---|
| Pruebas | https://sis-t.redsys.es:25443/sis/rest/RTP/checkRtpUsuario |
| Real | https://sis.redsys.es/sis/rest/RTP/checkRtpUsuario |
Para poder realizar la consulta, deberás enviar los datos básicos de la operación y el número de teléfono del titular. Recuerda que el número de teléfono siempre debe ir con el prefijo de país, en la mayoría de casos +34.
{
"DS_MERCHANT_ORDER": "1612280107",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_TERMINAL": "871",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_AMOUNT": "145",
"DS_MERCHANT_BIZUM_MOBILENUMBER": "+34700000000"
}
{
"Ds_RtpStatus": "OK",
"Ds_RtpResponse": "BIZ00000",
"Ds_RtpDescription": "Operacion realizada correctamente",
"Ds_MerchantCode": "999008881",
"Ds_Terminal": "871",
"Ds_Order": "1612280505",
"Ds_Currency": "978",
"Ds_Amount": "145"
}
En la respuesta, debes fijarte en los campos que comience por Ds_Rtp:
- Ds_RtpStatus: Indica si el cliente está enrolado para usar Request to Pay. Si se recibiera «KO», debes consultar el campo Ds_RtpResponse para verificar si la respuesta recibida es debido a un error o no.
- Ds_RtpResponse: Código de estado de la petición de consulta. En caso de que la petición sea correcta, se devolverá BIZ00000. La tabla de códigos la encontrarás más adelante. En este caso, si recibes KO en el Ds_RtpStatus pero luego un código BIZ00000 en este parámetro, significará que el cliente no soporta Request to Pay, pero sí tiene Bizum.
- Ds_RtpDescription: Descripción del estado de la petición de consulta. En caso de producirse algún error, la explicación vendrá en este campo.
Sobre las exenciones de SCA
Puedes consultar todas las exenciones disponibles en la página de información de PSD2 y Autenticación reforzada (SCA).
Inicio de solicitud de pago RTP vía REST
Debes tener en cuenta que si decides integrar Bizum vía REST, es obligatorio que soportes el respaldo en autenticación. Tienes más detalles en la siguiente pestaña.
El flujo de integración vía REST de Bizum sigue el siguiente esquema:
- El comercio solicita el inicio de Request to Pay.
- Se intenta realizar el inicio de Request to Pay.
- Si el cliente tiene activo RTP y la comunicación con la entidad se produce correctamente, Bizum responde con el éxito del intento del inicio RTP enviando BIZ00000 en Ds_RtpResponse.
- En cualquier otra situación, Bizum responde con el código de error y la descripción.
- En caso de que el inicio de RTP haya sido satisfactorio, cuando se confirme o deniegue la solicitud, el sistema recibirá una notificación con el resultado de esta, y en función de la respuesta y del tipo de operación a procesar, se realizará:
- Confirmación: Con un tipo de operación 0, se procederá a autorizar la operación y se actualizará el estado de la operación con el resultado de la autorización. Con un tipo de operación 7, se actualizará el estado de la operación quedando autenticada y estando pendiente de ser autorizada (Bizum de doble flujo).
- Denegación: Se actualizará el estado de la operación quedando denegada.
- Por último, se notificará al comercio con el resultado final de la operación.
La petición de procesamiento de la operación se deberá realizar a las siguientes URLs:
| Entorno | URL de Conexión |
|---|---|
| Pruebas | https://sis-t.redsys.es:25443/sis/rest/RTP/trataPeticionREST |
| Real | https://sis.redsys.es/sis/rest/RTP/trataPeticionREST |
La respuesta del TPV Virtual será doble: recibirás una respuesta de la operativa de Bizum RTP con el resultado de la transacción. Posteriormente, recibirás una notificación del TPV Virtual vía HTTP POST con el resultado de la operación en sí misma.
{
"DS_MERCHANT_ORDER": "1614092745",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_TERMINAL": "871",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_AMOUNT": "145",
"DS_MERCHANT_TRANSACTIONTYPE": "0",
"DS_MERCHANT_PAYMETHODS": "z",
"DS_MERCHANT_MERCHANTURL": "https:\/\/sis-d.redsys.es\/sis-simuladorweb\/notificacion\/reciboNotif.jsp",
"DS_MERCHANT_BIZUM_MOBILENUMBER": "+34700000000"
}
{
"Ds_Amount": "145",
"Ds_Currency": "978",
"Ds_Order": "1614092745",
"Ds_MerchantCode": "999008881",
"Ds_Terminal": "871",
"Ds_Response": "9998",
"Ds_AuthorisationCode": "",
"Ds_TransactionType": "0",
"Ds_SecurePayment": "0",
"Ds_Language": "1",
"Ds_MerchantData": "",
"Ds_ProcessedPayMethod": "68",
"Ds_RtpResponse": "BIZ00000",
"Ds_RtpDescription": "Operacion realizada correctamente"
}
{
"Ds_Date": "23%2F02%2F2021",
"Ds_Hour": "16%3A07",
"Ds_SecurePayment": "1",
"Ds_Amount": "145",
"Ds_Currency": "978",
"Ds_Order": "1614092745",
"Ds_MerchantCode": "999008881",
"Ds_Terminal": "871",
"Ds_Response": "0000",
"Ds_MerchantData": "",
"Ds_TransactionType": "0",
"Ds_ConsumerLanguage": "1",
"Ds_AuthorisationCode": "123456",
"Ds_ProcessedPayMethod": "68"
}
Respaldo de una operación iniciada como Request to Pay
El respaldo se utiliza cuando no es posible continuar una operación por RTP y el sistema así te lo indica. Para que una operación pueda ser respaldada, se debe tener una respuesta parecida a la siguiente:
{
"Ds_Amount": "7600",
"Ds_Currency": "978",
"Ds_Order": "1765796037",
"Ds_MerchantCode": "999008881",
"Ds_Terminal": "810",
"Ds_Response": "9998",
"Ds_AuthorisationCode": "",
"Ds_TransactionType": "0",
"Ds_Language": "1",
"Ds_MerchantData": "",
"Ds_Bizum_IdOper": "18446848272627838632289363136087587",
"Ds_ProcessedPayMethod": "68",
"Ds_Control_1765796041708": "1765796041708",
"Ds_RtpResponse": "BIZ00233",
"Ds_RtpDescription": "Error en la autenticacion. La operacion puede respaldarse",
"Ds_RtpBackupHtml":
"PCFET0NUWVBFIEhUTUw+PGh0bWwgbGFuZz0iJHtsYW5ndWFnZX0iPjxoZWFkPjxtZXRhIGNoYXJzZXQ9InV0Zi04Ij48bWV0YSBodHRwLWVxdWl2PSJYLVVBLUNvbXBhdGlibGUiIGNvbnRlbnQ9IklFPWVkZ2UiPiI8bWV0YSBuYW1lPSJ2aWV3cG9ydCIgY29udGVudD0id2lkdGg9ZGV2aWNlLXdpZHRoLCBpbml0aWFsLXNjYWxlPTEiPjxtZXRhIGh0dHAtZXF1aXY9IkNhY2hlLUNvbnRyb2wiY29udGVudD0ibm8tY2FjaGUsIG5vLXN0b3JlLCBtdXN0LXJldmFsaWRhdGUsIG1heC1hZ2U9MCIvPjxtZXRhIGh0dHAtZXF1aXY9IlByYWdtYSIgY29udGVudD0ibm8tY2FjaGUiLz48bWV0YSBodHRwLWVxdWl2PSJFeHBpcmVzIiBjb250ZW50PSIwIiAvPjxsaW5rIHJlbD0iaWNvbiIgaHJlZj0iZmF2aWNvbi5wbmciPjx0aXRsZT5QYWdvIEJpenVtPC90aXRsZT48c2NyaXB0IHNyYz0iaHR0cHM6Ly9hamF4Lmdvb2dsZWFwaXMuY29tL2FqYXgvbGlicy9qcXVlcnkvMS4xMS4zL2pxdWVyeS5taW4uanMiPjwvc2NyaXB0PjxsaW5rIGhyZWY9Imh0dHBzOi8vcHBpaS1pLnJlZHN5cy5lcy9jMmVyLWF1dGgvc3RhdGljL2Nzcy9ib290c3RyYXAubWluLmNzcyIgcmVsPSJzdHlsZXNoZWV0IiAvPjxsaW5rIGhyZWY9Imh0dHBzOi8vcHBpaS1pLnJlZHN5cy5lcy9jMmVyLWF1dGgvc3RhdGljL2Nzcy9tYWluLmNzcz92PTFfMiIgcmVsPSJzdHlsZXNoZWV0IiAvPjxzdHlsZT5AaW1wb3J0IHVybCgnaHR0cHM6Ly9mb250cy5nb29nbGVhcGlzLmNvbS9jc3MyP2ZhbWlseT1NdWxpc2g6aXRhbCx3Z2h0QDAsMjAwLi4xMDAwOzEsMjAwLi4xMDAwJmRpc3BsYXk9c3dhcCcpO0BpbXBvcnQgdXJsKCdodHRwczovL2ZvbnRzLmdvb2dsZWFwaXMuY29tL2NzczI/ZmFtaWx5PUxhdG86aXRhbCx3Z2h0QDAsMTAwOzAsMzAwOzAsNDAwOzAsNzAwOzAsOTAwOzEsMTAwOzEsMzAwOzEsNDAwOzEsNzAwOzEsOTAwJmRpc3BsYXk9c3dhcCcpO2h0bWwsIGJvZHksIGRpdiwgc3BhbiwgYXBwbGV0LCBvYmplY3QsIGlmcmFtZSwgaDEsIGgyLCBoMywgaDQsIGg1LCBoNiwgcCxibG9ja3F1b3RlLCBwcmUsIGEsIGFiYnIsIGFjcm9ueW0sIGFkZHJlc3MsIGJpZywgY2l0ZSwgY29kZSwgZGVsLCBkZm4sZW0sIGltZywgaW5zLCBrYmQsIHEsIHMsIHNhbXAsIHNtYWxsLCBzdHJpa2UsIHN0cm9uZywgc3...",
"Ds_RtpBackupTemplate":
"eyJjaGFsbGVuZ2VJbmZvVGV4dCI6IkludHJvZHV6Y2EgZWwgY8OzZGlnbyBxdWUgaGEgbGxlZ2FkbyBhIHN1IHRlbMOpZm9ubyIsInN1Ym1pdEF1dGhlbnRpY2F0aW9uTGFiZWwiOiJFbnZpYXIiLCJpc3N1ZXJJbWFnZSI6Imh0dHBzOi8vcHBpaS1pLnJlZHN5cy5lcy9jMmVyLXdlYi9zdGF0aWMvaW1nL2xvZ29zLzk5OTkucG5nIiwiaWRPcGVyYWNpb24iOiIxODQ0Njg0ODI3MjYyNzgzODYzMjI4OTM2MzEzNjA4NzU4NyIsImJpenVtSW1hZ2UiOiJodHRwczovL3BwaWktaS5yZWRzeXMuZXMvYzJlci13ZWIvc3RhdGljL2ltZy9sb2dvLWJpenVtLnBuZyJ9"
}
En esta respuesta, que se habría obtenido al solicitar RTP, se puede observar cómo se obtiene el valor BIZ00233 en el campo Ds_RtpResponse. Únicamente se puede intentar un respaldo si se recibe este código de error.
Para realizar un respaldo de Bizum cuando se ha iniciado una petición RTP se dispone de tres métodos. En esta página, se explicará el más sencillo de integrar, pero dispones de los otros dos en la guía de integración de Bizum, también disponible en el área de descargas.
Respaldo manejado por TPV Virtual y Bizum
Para hacer un respaldo por TPV Virtual y Bizum basta con realizar una operación de redirección con los mismos datos utilizados para la operación original, añadiendo el parámetro Ds_Merchant_Bizum_IdOper con el valor recibido en la respuesta dentro del parámetro Ds_Bizum_IdOper y marcando Ds_Merchant_PayMethods con el valor «z», como es habitual.
Este parámetro te llegará en el rechazo del intento RTP.
{
"DS_MERCHANT_AMOUNT": "7600",
"DS_MERCHANT_ORDER": "1765796037",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_TRANSACTIONTYPE": "0",
"DS_MERCHANT_TERMINAL": "810",
"DS_MERCHANT_PAYMETHODS": "z",
"DS_MERCHANT_BIZUM_IDOPER": "18446848272627838632289363136087587"
}
{
"Ds_SignatureVersion": "HMAC_SHA512_V2",
"Ds_MerchantParameters":
"eyJEU19NRVJDSEFOVF9BTU9VTlQiOiI3NjAwIiwiRFNfTUVSQ0hBTlRfT1JERVIiOiIxNzY1Nzk2MDM3IiwiRFNfTUVSQ0hBTlRfTUVSQ0hBTlRDT0RFIjoiOTk5MDA4ODgxIiwiRFNfTUVSQ0hBTlRfQ1VSUkVOQ1kiOiI5NzgiLCJEU19NRVJDSEFOVF9UUkFOU0FDVElPTlRZUEUiOiIwIiwiRFNfTUVSQ0hBTlRfVEVSTUlOQUwiOiI4MTAiLCJEU19NRVJDSEFOVF9QQVlNRVRIT0RTIjoieiIsIkRTX01FUkNIQU5UX0JJWlVNX0lET1BFUiI6IjE4NDQ2ODQ4MjcyNjI3ODM4NjMyMjg5MzYzMTM2MDg3NTg3In0",
"Ds_Signature":
"Blw9MKcn5aSMT4F5OGQv5IhZXSk4VCtwlfXnluT__KUaRvPH7aqON1VqE_EfoIYOa1nISFISf_iyIpZpWhjNGw"
}
Recuerda que, como siempre, debes convertir este objeto a Base64URL, firmarlo y enviarlo como cualquier petición al TPV Virtual. Cuando hagas la petición, tu cliente será redirigido a Bizum y se desencadenará automáticamente el envío de un SMS a su teléfono, para que sólo tenga que rellenar el código para confirmar la operación.
El cliente verá una página como la siguiente:

Otras funcionalidades
Anulación de una operación
Debido a la naturaleza del pago por Bizum, que son pagos inmediatos, no se puede anular una operación que se ha pagado usando Bizum. Sin embargo, y para asemejar la funcionalidad a la operativa con tarjetas, se podrá solicitar una anulación utilizando el parámetro Ds_Merchant_TransactionType con el valor 45, unido a los detalles de la operación que se quiere anular.
Esta operación será procesada como una devolución y se acoge a los tiempos de procesamiento de una devolución. Si todo va correctamente, la respuesta informará el campo Ds_Response con el valor 0900.
| Código | Descripción |
|---|---|
| BIZ00000 | Operación realizada correctamente. |
| BIZ00001 | Parámetro de entrada obligatorio no completado. |
| BIZ00002 | El formato de algún parámetro es incorrecto. |
| BIZ00003 | No se encontró el elemento. |
| BIZ00005 | Error interno del sistema. |
| BIZ00006 | Error de seguridad 3DES o MAC X9.19 |
| BIZ00007 | Operación no permitida. |
| BIZ00008 | Beneficiario no encontrado. |
| BIZ00009 | Ordenante no encontrado. |
| BIZ00202 | Funcionalidad aún no implementada. |
| BIZ00213 | Error de autenticación en la petición recibida. Fallo en la secuencia de seguridad. |
| BIZ00224 | La respuesta de la entidad a la autenticación por RTP es KO. |
| BIZ00225 | La autenticación por Request to Pay no ha finalizado con éxito. |
| BIZ00233 | Error en la autenticación. La operación puede respaldarse. |
¡No evalúes el número de parámetros que llegan en la respuesta!
Te recomendamos que nunca evalúes el número total de parámetros que recibes como respuestas a las peticiones del TPV Virtual, ya que es muy probable que por actualizaciones de la normativa, se introduzcan más parámetros o se alteren la posición de estos. Tu sistema debe estar preparado para recibir más parámetros de los que inicialmente ves aquí (por ejemplo, un nuevo campo con la IP del comprador).