Redsys TPV Virtual

https://pagosonline.redsys.es/desarrolladores-inicio/
Admin
Redsys TPV Virtual provides comprehensive documentation for developers to integrate with Redsys's...
Tokens:135,647
Snippets:640
Trust Score:9.8
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Integración inSite: formulario con redsysV3.js y getInSiteForm

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-tipos-de-integracion/desarrolladores-insite

Ejemplo de integración inSite que carga el script redsysV3.js de sandbox, registra un listener para recibir el ID de operación mediante storeIdOper y llama a getInSiteForm con un número de pedido generado aleatoriamente. Incluye una función de validación propia (merchantValidationEjemplo) que debe devolver true para continuar. Todos los parámetros de la llamada JavaScript deben ser cadenas (string).

```html
<html>  

<head>  
    <script src="https://sis-t.redsys.es:25443/sis/NC/sandbox/redsysV3.js"></script>  
</head>  

<body>  
    <div id="card-form" />  
    <form name="datos">  
        <input type="hidden" id="token"></input>  
        <input type="hidden" id="errorCode"></input>  
        <a href="javascript:alert(document.datos.token.value + '--' + document.datos.errorCode.value)"> ver</a>  
    </form>  

    <script>  
        function merchantValidationEjemplo() {  
            //Insertar validaciones…  
            alert("Esto son validaciones propias");  
            return true;  
        }  


    < !--Listener de recepción de ID de operación-- >  
            window.addEventListener("message", function receiveMessage(event) {  
                storeIdOper(event, "token", "errorCode", merchantValidationEjemplo);  
            });  



        function pedido() {  
            return "pedido" + Math.floor((Math.random() * 1000) + 1);  
        }  
        getInSiteForm('card-form', '', '', '', '', 'Texto botón pago', '999008881', '1', pedido(), 'ES', true);  

    </script>  
</body>  

</html>
```

--------------------------------

### Preauthorization REST Request (Ds_MerchantParameters only)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-tipos-de-integracion/desarrolladores-moto

JSON payload for a MOTO preauthorization request via REST. Requires the Ds_Merchant_DirectPayment parameter set to 'MOTO' and Ds_Merchant_TransactionType set to '1'. The example shows the Ds_MerchantParameters field without encoding.

```json
{
	"DS_MERCHANT_AMOUNT": "1000",
	"DS_MERCHANT_CURRENCY": "978",
	"DS_MERCHANT_CVV2": "123",
	"DS_MERCHANT_DIRECTPAYMENT": "MOTO",
	"DS_MERCHANT_EXPIRYDATE": "XXXX",
	"DS_MERCHANT_MERCHANTCODE": "999008881",
	"DS_MERCHANT_ORDER": "1524494336",
	"DS_MERCHANT_PAN": " XXXXXXXXXXXXXXXXXX ",
	"DS_MERCHANT_TERMINAL": "872",
	"DS_MERCHANT_TRANSACTIONTYPE": "1"
}
```

--------------------------------

### Integración por redirección simple con Redsys (PHP y Java)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/integrate-con-nosotros/librerias-de-integracion

Ejemplo mínimo de integración por redirección simple al TPV Virtual para un pago de 2,49€. Inicializa el merchant con una API key de prueba, define el importe y un número de pedido aleatorio, y genera la redirección de autorización. En Java, el formulario resultante debe renderizarse en la página.

```php
require_once "lib/autoload.php";

$token = "TEST_OTk5MDA4ODgxXzAwMV9zcTdIanJVT0JmS21DNTc2SUxnc2tENXNyVTg3MGdKNw";
$merchant = \Redsys\Merchant::initWithApiKey($token);
$params = new \Redsys\Parameters();
$params->amount = 249;
$params->order = \Redsys\Utils::randomString();

\Redsys\Redirect::authorisation($merchant, $params);
```

```java
package demo.examples.redirect;
import es.redsys.lib.*;

public class AuthorisationRedirectExample {
    public static void main() {
        final String token = "TEST_OTk5MDA4ODgxXzAwMV9zcTdIanJVT0JmS21DNTc2SUxnc2tENXNyVTg3MGdKNw";
        final Merchant merchant = Merchant.initWithApiKey(token);
        final Parameters params = new Parameters();
        
        params.setAmount("249");
        params.setOrder(Utils.randomString(12));

        final string redirectForm = GenerateRedirectForm.authorisation(merchant, params);

        //Rederizar redirectForm.
    }
}
```

--------------------------------

### Authorization REST Request (Ds_MerchantParameters only)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-tipos-de-integracion/desarrolladores-moto

JSON payload for a MOTO authorization request via REST. Requires the Ds_Merchant_DirectPayment parameter set to 'moto' and Ds_Merchant_TransactionType set to '0'. The example shows the Ds_MerchantParameters field without encoding.

```json
{
	"DS_MERCHANT_AMOUNT": "1000",
	"DS_MERCHANT_CURRENCY": "978",
	"DS_MERCHANT_CVV2": "123",
	"DS_MERCHANT_DIRECTPAYMENT": "moto",
	"DS_MERCHANT_EXPIRYDATE": "XXXX",
	"DS_MERCHANT_MERCHANTCODE": "999008881",
	"DS_MERCHANT_ORDER": "1524494336",
	"DS_MERCHANT_PAN": " XXXXXXXXXXXXXXXXXX ",
	"DS_MERCHANT_TERMINAL": "872",
	"DS_MERCHANT_TRANSACTIONTYPE": "0"
}
```

--------------------------------

### PayGold REST Request - Ds_MerchantParameters only (uncoded)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-tipos-de-integracion/desarrolladores-paygold/paygold-rest

Example REST request for PayGold with the mandatory Ds_Merchant_TransactionType set to 'F' and optional customer contact fields. The Ds_Merchant_P2F_XMLData field contains placeholders for customer name, address, free text, and email subject.

```json
1| {  
---|---
2| 	"DS_MERCHANT_AMOUNT": "145",  
3| 	"DS_MERCHANT_CURRENCY": "978",  
4| 	"DS_MERCHANT_CUSTOMER_MAIL": "Email.prueba@redsys.es ",  
5| 	"DS_MERCHANT_CUSTOMER_MOBILE": "666555444",  
6| 	"DS_MERCHANT_MERCHANTCODE": "999008881",  
7| 	"DS_MERCHANT_MERCHANTURL": "http://comercio.es/notificacion",  
8| 	"DS_MERCHANT_ORDER": "1453971987",  
9| 	"DS_MERCHANT_P2F_XMLDATA": {  
10| 		"NOMBRE DEL COMPRADOR  
11| 		 DIRECCION DEL COMPRADOR  
12| 		 TEXTO LIBRE  
13| 		 ASUNTO EMAIL"},  
14| 	"DS_MERCHANT_TERMINAL": "999",  
15| 	"DS_MERCHANT_TRANSACTIONTYPE": "F"  
16| }  

```

--------------------------------

### POST /sis/rest/trataPeticionREST (Pago manual)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-tipos-de-integracion/desarrolladores-moto

Realiza un pago manual (MOTO) mediante una conexión REST al TPV Virtual. Requiere el permiso de operación manual y los parámetros Ds_Merchant_TransactionType=0 y Ds_Merchant_DirectPayment=MOTO.

```APIDOC
## POST /sis/rest/trataPeticionREST

### Description
Realiza un pago manual (MOTO) mediante una conexión REST al TPV Virtual. Requiere el permiso de operación manual y los parámetros Ds_Merchant_TransactionType=0 y Ds_Merchant_DirectPayment=MOTO.

### Method
POST

### Endpoint
https://sis-t.redsys.es:25443/sis/rest/trataPeticionREST (Sandbox) / https://sis.redsys.es/sis/rest/trataPeticionREST (Live)

### Parameters
#### Request Body
- **DS_MERCHANT_AMOUNT** (string) - Required - Importe de la operación en unidades mínimas.
- **DS_MERCHANT_CURRENCY** (string) - Required - Código ISO 4217 de la moneda.
- **DS_MERCHANT_CVV2** (string) - Required - CVV de la tarjeta.
- **DS_MERCHANT_DIRECTPAYMENT** (string) - Required - Valor "MOTO" para indicar pago manual.
- **DS_MERCHANT_EXPIRYDATE** (string) - Required - Fecha de caducidad de la tarjeta (XXXX si no se usa).
- **DS_MERCHANT_MERCHANTCODE** (string) - Required - Código de comercio.
- **DS_MERCHANT_ORDER** (string) - Required - Número de pedido.
- **DS_MERCHANT_PAN** (string) - Required - Número de tarjeta.
- **DS_MERCHANT_TERMINAL** (string) - Required - Número de terminal.
- **DS_MERCHANT_TRANSACTIONTYPE** (string) - Required - Tipo de transacción (0 para pago).

### Request Example
{
  "DS_MERCHANT_AMOUNT": "1000",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_CVV2": "123",
  "DS_MERCHANT_DIRECTPAYMENT": "moto",
  "DS_MERCHANT_EXPIRYDATE": "XXXX",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_ORDER": "1524494336",
  "DS_MERCHANT_PAN": " XXXXXXXXXXXXXXXXXX ",
  "DS_MERCHANT_TERMINAL": "872",
  "DS_MERCHANT_TRANSACTIONTYPE": "0"
}

### Response
#### Success Response (200)
- **Ds_Amount** (string) - Importe de la operación.
- **Ds_AuthorisationCode** (string) - Código de autorización.
- **Ds_CardNumber** (string) - Número de tarjeta enmascarado.
- **Ds_Card_Brand** (string) - Marca de la tarjeta.
- **Ds_Card_Country** (string) - País de la tarjeta.
- **Ds_Currency** (string) - Moneda.
- **Ds_Language** (string) - Idioma.
- **Ds_MerchantCode** (string) - Código de comercio.
- **Ds_MerchantData** (string) - Datos de comercio.
- **Ds_Order** (string) - Número de pedido.
- **Ds_Response** (string) - Código de respuesta (0000 = éxito).
- **Ds_SecurePayment** (string) - Indica si el pago es seguro.
- **Ds_Terminal** (string) - Terminal.
- **Ds_TransactionType** (string) - Tipo de transacción.

#### Response Example
{
  "Ds_Amount": "1000",
  "Ds_AuthorisationCode": "088767",
  "Ds_CardNumber": "454881********04",
  "Ds_Card_Brand": "2",
  "Ds_Card_Country": "840",
  "Ds_Currency": "978",
  "Ds_Language": "1",
  "Ds_MerchantCode": "999008881",
  "Ds_MerchantData": "",
  "Ds_Order": "1524494336",
  "Ds_Response": "0000",
  "Ds_SecurePayment": "0",
  "Ds_Terminal": "872",
  "Ds_TransactionType": "0"
}
```

--------------------------------

### Crear ApplePaySession y llamar a begin

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-otros-metodos-de-pago/otros-metodos-de-pago-apple-pay

Código para crear el objeto ApplePaySession con la versión 3 y el request, y llamar al método begin para iniciar la validación del comercio. Se añade a la función buttonClicked.

```javascript
  
// Create ApplePaySession  
const session = new ApplePaySession(3, request);  
session.begin();  
```

--------------------------------

### POST /trataPeticion

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-operativa/preautorizaciones-y-confirmaciones

Documentación de la petición REST para confirmar una preautorización en el TPV Virtual de Redsys.

```APIDOC
## POST /trataPeticion

### Description
Envía una petición REST al TPV Virtual para confirmar una preautorización. El valor del parámetro Ds_Merchant_TransactionType debe ser 2. Se debe utilizar el mismo número de pedido de la operación de preautorización.

### Method
POST

### Endpoint
/trataPeticion

### Parameters
#### Request Body
- **DS_MERCHANT_ORDER** (string) - Requerido - Número de pedido de la operación a confirmar.
- **DS_MERCHANT_MERCHANTCODE** (string) - Requerido - Código de comercio.
- **DS_MERCHANT_TERMINAL** (string) - Requerido - Número de terminal.
- **DS_MERCHANT_TRANSACTIONTYPE** (string) - Requerido - Tipo de transacción, debe ser "2" para confirmación.
- **DS_MERCHANT_CURRENCY** (string) - Requerido - Código de moneda (ISO 4217).
- **DS_MERCHANT_AMOUNT** (string) - Requerido - Importe de la operación.

### Request Example
```json
{
  "DS_MERCHANT_ORDER": "1680071984",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_TERMINAL": "1",
  "DS_MERCHANT_TRANSACTIONTYPE": "2",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_AMOUNT": "0000002000"
}
```

### Response
#### Success Response (200)
- **Ds_Amount** (string) - Importe de la operación.
- **Ds_Currency** (string) - Código de moneda.
- **Ds_Order** (string) - Número de pedido.
- **Ds_MerchantCode** (string) - Código de comercio.
- **Ds_Terminal** (string) - Número de terminal.
- **Ds_Response** (string) - Código de respuesta. "0900" indica confirmación correcta.
- **Ds_AuthorisationCode** (string) - Código de autorización.
- **Ds_TransactionType** (string) - Tipo de transacción.
- **Ds_SecurePayment** (string) - Indicador de pago seguro.
- **Ds_Language** (string) - Idioma.
- **Ds_MerchantData** (string) - Datos del comercio.
- **Ds_Card_Country** (string) - País de la tarjeta.
- **Ds_Card_Brand** (string) - Marca de la tarjeta.
- **Ds_ProcessedPayMethod** (string) - Método de pago procesado.
- **Ds_Control_1680100010873** (string) - Control adicional.

#### Response Example
```json
{
  "Ds_Amount": "2000",
  "Ds_Currency": "978",
  "Ds_Order": "1680071984",
  "Ds_MerchantCode": "999008881",
  "Ds_Terminal": "1",
  "Ds_Response": "0900",
  "Ds_AuthorisationCode": "439764",
  "Ds_TransactionType": "2",
  "Ds_SecurePayment": "2",
  "Ds_Language": "1",
  "Ds_MerchantData": "",
  "Ds_Card_Country": "724",
  "Ds_Card_Brand": "1",
  "Ds_ProcessedPayMethod": "78",
  "Ds_Control_1680100010873": "1680100010873"
}
```
```

--------------------------------

### Crear iframe oculto para 3DSMethod con formulario POST

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-funcionalidades-avanzadas/operativa-dcc

Formulario oculto que envía el campo threeDSMethodData mediante HTTP POST a la URL devuelta en iniciaPeticion. Incluye un iframe oculto y la función ejecutar3DSMethod que envía el formulario. Debes sustituir la URL y el valor del campo con los datos reales de tu TPV Virtual y llamar a la función cuando tengas los datos necesarios.

```html
<body>
<form id="3dsmethod-form" action="https://urlDevueltaEniniciaPeticion.es" method="POST">
<input type="hidden" name="threeDSMethodData" value="eyJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImM5ODgzMzBiLTZjMmItNDg5My05ZjJhLTNjYjNiNzA4YmY3NCIsInRocmVlRFNNZXRob2ROb3RpZmljYXRpb25VUkwiOiJodHRwczovL3Npcy1kLnJlZHN5cy5lczoyNTQ0My9zaXMvc2VydmljZXMvcmVzdC9yZXN0M0RTL3Byb2Nlc2FyM0RTTWV0aG9kIn0=">
</form>
<iframe id="3dsmethod-iframe" name="3dsmethod" style="display:none;"></iframe>
</body>
<script>
function ejecutar3DSMethod() { 
var form = document.getElementById("3dsmethod-form"); 
var iframe = document.getElementById("3dsmethod-iframe"); 
form.target = "3dsmethod"; 
form.submit(); 
} 
</script>
```

--------------------------------

### Asignar método de pago con PaymentMethod (Java)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/integrate-con-nosotros/librerias-de-integracion

Asigna el método de pago Bizum usando setPayMethod con la constante PaymentMethod.BIZUM.

```Java
params.setPayMethod(PaymentMethod.BIZUM);
```

--------------------------------

### Asignar parámetros con la clase Parameters (PHP)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/integrate-con-nosotros/librerias-de-integracion

Crea una instancia de \Redsys\Parameters y asigna valores a propiedades como 'amount' o al nombre técnico 'DS_MERCHANT_ORDER'. Los valores deben seguir la guía de Parámetros y Respuestas del TPV Virtual.

```PHP
$params = new \Redsys\Parameters();
$params->amount = "249";
$params->DS_MERCHANT_ORDER = "ABCD1234";
```

--------------------------------

### getInSiteForm

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-funcionalidades-avanzadas/operativa-dcc

Función que genera el formulario de pago InSite y devuelve el idOper. Debe llamarse después de preparar el listener para la recepción de datos.

```APIDOC
## getInSiteForm

### Description
Genera el formulario de pago InSite y devuelve el idOper. Debe llamarse después de preparar el listener para la recepción de datos.

### Method
Función JavaScript

### Endpoint
No aplica (función cliente)

### Parameters
#### Parámetros de la función
- **idContenedor** (string) - Requerido - ID del contenedor donde se generará el formulario.
- **estiloBoton** (string) - Requerido - Estilo CSS para el botón de pago.
- **estiloBody** (string) - Requerido - Estilo CSS para el cuerpo del formulario.
- **estiloCaja** (string) - Requerido - Estilo CSS para la caja de introducción de datos.
- **estiloInputs** (string) - Requerido - Estilo CSS para los campos de texto.
- **textoBoton** (string) - Requerido - Texto a mostrar en el botón de pago.
- **fuc** (string) - Requerido - Valor del FUC del terminal (número de comercio).
- **terminal** (string) - Requerido - Identificador del terminal.
- **merchantOrder** (string) - Requerido - Número de pedido (cadena alfanumérica de 4 a 12 posiciones).
- **idioma** (string) - Opcional - Código de idioma según ISO 639-1. Si no se indica o es erróneo, se usa castellano.
- **mostrarLogo** (boolean) - Opcional - Indica si se muestra el logo de la entidad (true) o no (false).

### Request Example
```javascript
getInSiteForm('card-form', estiloBoton, estiloBody, estiloCaja, estiloInputs, 'Pagar con Redsys', fuc, terminal, merchantOrder, 'ES', true);
```

### Response
#### Success Response
- **idOper** (string) - ID de operación generado, almacenado en el elemento indicado por _idToken_.

#### Response Example
No se proporciona ejemplo de respuesta en la documentación.

### Notes
- El _merchantOrder_ utilizado en la carga del iframe y generación del idOper debe reutilizarse en la posterior petición de autorización.
- El proceso de autenticación tiene el mismo formato que una autorización REST, sustituyendo los datos de la tarjeta por el idOper.
- Se debe preparar un listener para recibir el idOper y los errores de validación.
```

--------------------------------

### Rest::genericInit

Source: https://pagosonline.redsys.es/desarrolladores-inicio/integrate-con-nosotros/librerias-de-integracion

Función genérica de la clase Rest para realizar operaciones REST no contempladas específicamente en la librería. Recibe la variable Merchant, los parámetros de la operación y el tipo de transacción.

```APIDOC
## Rest::genericInit

### Description
Función genérica de la clase Rest para realizar operaciones REST no contempladas específicamente en la librería. Recibe la variable Merchant, los parámetros de la operación y el tipo de transacción.

### Method
static

### Endpoint
\Redsys\Rest::genericInit($merchant, $parameters, $transactionType)

### Parameters
- **merchant** (Merchant) - Requerido - Variable inicializada de la clase Merchant.
- **parameters** (Parameters) - Requerido - Variable completada con los parámetros requeridos para operar.
- **transactionType** (string) - Requerido - Tipo de transacción a realizar (ej. "3").

### Request Example
```php
$response = \Redsys\Rest::genericInit($merchant, $parameters, "3");
```

```java
response = Rest.genericInit(merchant, params, "3");
```

### Response
#### Success Response
- **response** (Response) - Objeto de la clase Response con los datos de la respuesta del TPV Virtual.
```

--------------------------------

### \Redsys\Redirect::generic

Source: https://pagosonline.redsys.es/desarrolladores-inicio/integrate-con-nosotros/librerias-de-integracion

Documentación de la función genérica de la clase Redirect para operaciones de redirección.

```APIDOC
## \Redsys\Redirect::generic

### Description
Función genérica de la clase Redirect para realizar cualquier tipo de transacción no soportada de manera nativa por la biblioteca. Realiza la redirección de forma automática.

### Método
- `generic(Merchant $merchant, Parameters $parameters, TransactionType $transactionType)` - Ejecuta una transacción genérica.

### Parámetros
- `$merchant` (Merchant) - Instancia de la clase Merchant.
- `$parameters` (Parameters) - Instancia de la clase Parameters con los parámetros requeridos.
- `$transactionType` (TransactionType) - Tipo de transacción. Ejemplo: `\Redsys\TransactionType::$authentication`.

### Ejemplo de uso
```php
\Redsys\Redirect::generic($merchant, $parameters, \Redsys\TransactionType::$authentication);
```

### Notas
- También se puede asignar el tipo de transacción durante la recogida de parámetros y omitirlo en la llamada a la función genérica.
```

--------------------------------

### POST /sis/rest/trataPeticionREST (Preautorización)

Source: https://pagosonline.redsys.es/desarrolladores-inicio/documentacion-tipos-de-integracion/desarrolladores-moto

Realiza una preautorización mediante una conexión REST al TPV Virtual. Requiere el permiso de preautorización y los parámetros Ds_Merchant_TransactionType=1 y Ds_Merchant_DirectPayment=MOTO.

```APIDOC
## POST /sis/rest/trataPeticionREST

### Description
Realiza una preautorización mediante una conexión REST al TPV Virtual. Requiere el permiso de preautorización y los parámetros Ds_Merchant_TransactionType=1 y Ds_Merchant_DirectPayment=MOTO.

### Method
POST

### Endpoint
https://sis-t.redsys.es:25443/sis/rest/trataPeticionREST (Sandbox) / https://sis.redsys.es/sis/rest/trataPeticionREST (Live)

### Parameters
#### Request Body
- **DS_MERCHANT_AMOUNT** (string) - Required - Importe de la operación en unidades mínimas.
- **DS_MERCHANT_CURRENCY** (string) - Required - Código ISO 4217 de la moneda.
- **DS_MERCHANT_CVV2** (string) - Required - CVV de la tarjeta.
- **DS_MERCHANT_DIRECTPAYMENT** (string) - Required - Valor "MOTO" para indicar pago manual.
- **DS_MERCHANT_EXPIRYDATE** (string) - Required - Fecha de caducidad de la tarjeta (XXXX si no se usa).
- **DS_MERCHANT_MERCHANTCODE** (string) - Required - Código de comercio.
- **DS_MERCHANT_ORDER** (string) - Required - Número de pedido.
- **DS_MERCHANT_PAN** (string) - Required - Número de tarjeta.
- **DS_MERCHANT_TERMINAL** (string) - Required - Número de terminal.
- **DS_MERCHANT_TRANSACTIONTYPE** (string) - Required - Tipo de transacción (1 para preautorización).

### Request Example
{
  "DS_MERCHANT_AMOUNT": "1000",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_CVV2": "123",
  "DS_MERCHANT_DIRECTPAYMENT": "MOTO",
  "DS_MERCHANT_EXPIRYDATE": "XXXX",
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_ORDER": "1524494336",
  "DS_MERCHANT_PAN": " XXXXXXXXXXXXXXXXXX ",
  "DS_MERCHANT_TERMINAL": "872",
  "DS_MERCHANT_TRANSACTIONTYPE": "1"
}

### Response
#### Success Response (200)
- **Ds_Amount** (string) - Importe de la operación.
- **Ds_AuthorisationCode** (string) - Código de autorización.
- **Ds_CardNumber** (string) - Número de tarjeta enmascarado.
- **Ds_Card_Brand** (string) - Marca de la tarjeta.
- **Ds_Card_Country** (string) - País de la tarjeta.
- **Ds_Currency** (string) - Moneda.
- **Ds_Language** (string) - Idioma.
- **Ds_MerchantCode** (string) - Código de comercio.
- **Ds_MerchantData** (string) - Datos de comercio.
- **Ds_Order** (string) - Número de pedido.
- **Ds_Response** (string) - Código de respuesta (0000 = éxito).
- **Ds_SecurePayment** (string) - Indica si el pago es seguro.
- **Ds_Terminal** (string) - Terminal.
- **Ds_TransactionType** (string) - Tipo de transacción.

#### Response Example
{
  "Ds_Amount": "1000",
  "Ds_AuthorisationCode": "088767",
  "Ds_CardNumber": "454881********04",
  "Ds_Card_Brand": "2",
  "Ds_Card_Country": "840",
  "Ds_Currency": "978",
  "Ds_Language": "1",
  "Ds_MerchantCode": "999008881",
  "Ds_MerchantData": "",
  "Ds_Order": "1524494336",
  "Ds_Response": "0000",
  "Ds_SecurePayment": "0",
  "Ds_Terminal": "1",
  "Ds_TransactionType": "1"
}
```

--------------------------------

### POST /realizarPago

Source: https://pagosonline.redsys.es/desarrolladores-inicio/integrate-con-nosotros/parametros-de-entrada-y-salida

Documentación del endpoint de pago del TPV Virtual, incluyendo los parámetros de entrada y sus condiciones.

```APIDOC
## [POST] /realizarPago

### Description
Realiza un pago en el TPV Virtual. Este endpoint permite procesar transacciones de pago con tarjeta, incluyendo operaciones de autorización, preautorización, devolución y otras según el tipo de operación indicado.

### Method
POST

### Endpoint
/realizarPago

### Parameters
#### Request Body
- **DS_MERCHANT_AMOUNT** (12 / N) - Obligatorio - Importe de la operación. Las últimas posiciones hacen referencia a los decimales de la moneda. Ejemplo: En el caso del EURO 43,45 Euros habría que indicar 4345.
- **DS_MERCHANT_AUTHORISATIONCODE** (6 / AN) - Opcional - Código de autorización necesario para identificar de manera inequívoca la transacción original sobre la que se desea realizar la devolución. No se trata de un valor único por transacción, se puede repetir. Este parámetro tiene sentido en aquellos comercios que permiten repetir el número de pedido.
- **DS_MERCHANT_COF_INI** (1 / AN) - Opcional - Obligatorio para operativa COF Visa y MC. Valores posibles: "S": Sí es primera transacción COF (almacenar credenciales), "N": No es primera transacción COF. Cualquier otro valor no se tendrá en cuenta y la operación no se procesará como COF.
- **DS_MERCHANT_COF_TXNID** (15 / AN) - Opcional - Identificador de transacción COF. Este identificador es devuelto en la respuesta de la primera operación COF (almacenamiento de credenciales), y deberá enviarse en transacciones sucesivas realizadas con las credenciales que generaron este mismo Id_txn.
- **DS_MERCHANT_COF_TYPE** (1 / AN) - Opcional - Tipo de transacción COF. Valores posibles: "I": Installments, "R": Recurring, "H": Reauthorization, "E": Resubmission, "D": Delayed, "M": Incremental, "N": No Show, "C": Otras.
- **DS_MERCHANT_CONSUMERLANGUAGE** (3 / N) - Opcional - Idioma del titular.
- **DS_MERCHANT_CURRENCY** (4 / Núm.) - Obligatorio - Código numérico de la moneda según el ISO-4217.
- **DS_MERCHANT_CVV2** (3-4 / N) - Condicional - Código CVV2 de la tarjeta. Opcional si se envía el parámetro DS_MERCHANT_PAN y en función de la configuración del comercio.
- **DS_MERCHANT_DIRECTPAYMENT** (4 / N) - Opcional - Indicador de pago sin autenticación. Valores posibles: "true": identifica la intención de realizar la operación sin autenticación. Este valor no se tendrá en cuenta si la tarjeta está afectada por PSD2. (En test ya está activo este control). "moto": identifica la operación como pago MOTO.
- **DS_MERCHANT_EMV3DS** (Variable / JSON Object) - Opcional - Contiene toda la información necesaria para autenticación EMV3DS (V1 o V2). Con el fin de mejorar la experiencia del usuario en el proceso de autenticación, se recomienda añadir en la petición de pago los siguientes parámetros definidos en la versión EMV 3DS v2 (Recomendación que aportan datos adicionales del titular de la tarjeta y del dispositivo que se está utilizando.

### Request Example
{
  "DS_MERCHANT_AMOUNT": "4345",
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_CVV2": "123",
  "DS_MERCHANT_DIRECTPAYMENT": "true"
}

### Response
#### Success Response (200)
- **DS_MERCHANT_COF_TXNID** (15 / AN) - Identificador de transacción COF devuelto en la respuesta de la primera operación COF.

#### Response Example
{
  "DS_MERCHANT_COF_TXNID": "123456789012345"
}
```
Tokens:
Raw