# Liquidaciones (beta)

La API de liquidaciones de MONEI te permite enviar dinero a particulares mediante Bizum o tarjetas.

aviso

La API de liquidaciones se encuentra actualmente en beta cerrada. Para solicitar acceso, contacta con nuestro [equipo de soporte](https://support.monei.com/hc/requests/new). Ten en cuenta que la API de liquidaciones no está disponible en el entorno de pruebas.

## Antes de empezar[​](#antes-de-empezar "Enlace directo al Antes de empezar")

Para activar las liquidaciones de MONEI, es imprescindible mantener un saldo positivo en la cuenta del comercio en todo momento. Además, se requiere una recarga inicial mínima de 5.000 € en el saldo de la cuenta del comercio para activar completamente la funcionalidad de liquidaciones.

## Liquidaciones con Bizum[​](#liquidaciones-con-bizum "Enlace directo al Liquidaciones con Bizum")

Antes de comenzar, asegúrate de tener Bizum habilitado en [MONEI Dashboard → Ajustes → Métodos de pago](https://dashboard.monei.com/settings/payment-methods). Si no tienes Bizum configurado, contacta con nuestro [equipo de soporte](https://support.monei.com/hc/requests/new).

Para probar tu integración de liquidaciones con Bizum:

Puedes usar el [endpoint de la API de MONEI](https://docs.monei.com/es/es/apis/rest/bizum/.md) para comprobar si el número de teléfono está registrado en Bizum antes de enviar el dinero al usuario final.

Las liquidaciones de Bizum no requieren confirmación por parte del cliente. Solo necesitas conocer su número de teléfono.

### 1. Crea un nuevo pago en tu servidor.[​](#1-crea-un-nuevo-pago-en-tu-servidor "Enlace directo al 1. Crea un nuevo pago en tu servidor.")

<!-- -->

* cURL
* Node.js
* PHP

POST https\://api.monei.com/v1/payments

```
curl --request POST 'https://api.monei.com/v1/payments' \

--header 'Authorization: pk_test_3c140607778e1217f56ccb8b50540e00' \

--header 'Content-Type: application/json' \

--data-raw '{

    "amount": 110,

    "currency": "EUR",

    "orderId": "14379133960355",

    "description": "Test Shop - #14379133960355",

    "transactionType": "PAYOUT",

    "paymentMethod": {

      "bizum": {

        "phoneNumber": "+34500000000"

      }

    }

}'
```

server.js

```
const {Monei, TransactionTypes} = require('@monei-js/node-sdk');

const monei = new Monei('pk_test_36cf3e8a15eff3f5be983562ea6b13ec');

monei.payments.create({

  amount: 110,

  currency: 'EUR',

  orderId: '14379133960355',

  description: 'Test Shop - #14379133960355',

  transactionType: TransactionTypes.PAYOUT,

  paymentMethod: {

    bizum: {

      phoneNumber: '+34500000000'

    }

  }

});
```

server.php

```
$monei = new Monei\MoneiClient('pk_test_36cf3e8a15eff3f5be983562ea6b13ec');

$monei->payments->create([

  'amount' => 110,

  'currency' => 'EUR',

  'orderId' => '14379133960355',

  'description' => 'Test Shop - #14379133960355',

  'transactionType' => 'PAYOUT',

  'paymentMethod' => [

    'bizum' => [

      'phoneNumber' => '+34500000000'

    ]

  ]

]);
```

Los siguientes parámetros son obligatorios:

* **amount** `positive integer` - Importe que se desea cobrar con este pago. Un entero positivo que representa cuánto cobrar en la unidad monetaria más pequeña (p. ej., 100 céntimos para cobrar 1,00 USD).
* **currency** `string` - Código de moneda [ISO](https://en.wikipedia.org/wiki/ISO_4217) de tres letras, en mayúsculas. Debe ser una moneda admitida.
* **orderId** `string` - Un ID de pedido de tu sistema. Un identificador único que puede usarse para conciliar el pago con tu sistema interno.
* **transactionType** `string` - `PAYOUT`
* **paymentMethod** `object` - Objeto del método de pago. Debe contener el objeto `bizum` con la propiedad `phoneNumber`.

Consulta todos los [parámetros de solicitud](https://docs.monei.com/es/es/apis/rest/payments-create/.md) disponibles.

### 2. Gestiona la respuesta[​](#2-gestiona-la-respuesta "Enlace directo al 2. Gestiona la respuesta")

Ejemplo de respuesta:

Las liquidaciones de Bizum se ejecutan de inmediato. Si la solicitud es correcta, recibirás el estado `PAID_OUT` en la respuesta.

```
{

  "id": "af6029f80f5fc73a8ad2753eea0b1be0",

  "amount": 110,

  "currency": "EUR",

  "orderId": "14379133960355",

  "description": "Test Shop - #14379133960355",

  "livemode": true,

  "status": "PAID_OUT",

  "statusCode": "E000",

  "statusMessage": "Transaction approved",

  "createdAt": 1685430038,

  "updatedAt": 1685430039,

  "paymentMethod": {

    "method": "bizum",

    "bizum": {

      "phoneNumber": "+34500000000",

      "integrationType": "REST"

    }

  },

  "nextAction": {

    "type": "COMPLETE",

    "redirectUrl": "https://secure.monei.com/payments/af6029f80f5fc73a8ad2753eea0b1be0/receipt"

  }

}
```

Consulta la lista completa de [parámetros de respuesta](https://docs.monei.com/es/es/apis/rest/schemas/payment/.md) devueltos.

Opcionalmente, puedes redirigir al cliente a `nextAction.redirectUrl` para mostrar el estado de la liquidación o el recibo.

## Liquidaciones con tarjetas[​](#liquidaciones-con-tarjetas "Enlace directo al Liquidaciones con tarjetas")

Las liquidaciones son compatibles con todas nuestras integraciones. Puedes usar una página de pago prediseñada o crear un checkout personalizado para que tu cliente introduzca los datos de su tarjeta y reciba la liquidación.

Pasa el parámetro `transactionType` con el valor `PAYOUT` para crear una liquidación en el primer paso de nuestras guías.

* [Usar una página de pago prediseñada](https://docs.monei.com/es/es/integrations/use-prebuilt-payment-page/.md)
* [Crear un checkout personalizado](https://docs.monei.com/es/es/integrations/build-custom-checkout/.md)

Las liquidaciones solo son compatibles con pagos mediante tarjeta y Bizum, por lo que debes pasar el parámetro `allowedPaymentMethods` con los valores `card` o `bizum` (en caso de que tengas más métodos de pago habilitados).