# Payouts (beta)

La API de Payouts de MONEI te permite enviar dinero a particulares mediante Bizum o tarjetas. Para una visión general de cómo funcionan los payouts, el modelo de saldo prefinanciado y cómo obtener acceso, consulta [Envía payouts a clientes](https://docs.monei.com/es/payments/payouts-to-customers.md).

aviso

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

## Antes de empezar[​](#before-you-begin "Enlace directo al Antes de empezar")

Para activar los payouts 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 payouts.

## Payouts con Bizum[​](#payouts-with-bizum "Enlace directo al Payouts con Bizum")

Antes de comenzar, asegúrate de tener Bizum habilitado en [MONEI Dashboard → Configuración → Métodos de pago → Bizum](https://dashboard.monei.com/settings/payment-methods/bizum). Si no tienes Bizum configurado, contacta con nuestro [equipo de soporte](https://docs.monei.com/es/contact-support.md).

![Página Métodos de pago en los ajustes del panel de MONEI, con Bizum activado](/img/dashboard/es/settings-payment-methods.png)

Página Métodos de pago en los ajustes del panel de MONEI, con Bizum activado

Para probar tu integración de payouts con Bizum:

Puedes usar el [endpoint de la API de MONEI](https://docs.monei.com/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.

Los payouts 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-create-a-new-payment-on-your-server "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, PaymentTransactionType} = 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: PaymentTransactionType.PAYOUT,

  paymentMethod: {

    bizum: {

      phoneNumber: '+34500000000'

    }

  }

});
```

server.php

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

$monei->payments->create(new Monei\Model\CreatePaymentRequest([

  'amount' => 110,

  'currency' => 'EUR',

  'order_id' => '14379133960355',

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

  'transaction_type' => 'PAYOUT',

  'payment_method' => new Monei\Model\PaymentPaymentMethodInput([

    'bizum' => new Monei\Model\PaymentPaymentMethodBizumInput([

      'phone_number' => '+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/apis/rest/payments-create.md) disponibles.

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

Ejemplo de respuesta:

Los payouts 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/apis/rest/schemas/payment.md) devueltos.

Opcionalmente, puedes redirigir al cliente a `nextAction.redirectUrl` para mostrar el estado del payout o el recibo.

## Payouts con tarjetas[​](#payouts-with-cards "Enlace directo al Payouts con tarjetas")

Los payouts son compatibles con todas nuestras integraciones. Puedes usar la página de pago alojada o crear un checkout personalizado para que tu cliente introduzca los datos de su tarjeta y reciba el payout.

Pasa el parámetro `transactionType` con el valor `PAYOUT` para crear un payout en el primer paso de nuestras guías.

* [Página de pago alojada](https://docs.monei.com/es/integrations/use-prebuilt-payment-page.md)
* [Crear un checkout personalizado](https://docs.monei.com/es/integrations/build-custom-checkout.md)

Los payouts 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).