# Payout Message

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The exact message the user signs to pay out euros from their EUR account to a bank account — step 1 of a payout.

## Overview

- `amount` in euros, as a decimal string (`"10.00"`; a comma is read as the decimal point). `destinationIban` is the bank account; without it, the IBAN of the user's own EUR account.
- The answer: `message` — `Send EUR <amount> to <IBAN> at <time>`, the IBAN in full —, `resolvedIban` and `gnosisAddress`, the address that signs. Sign `message` unchanged with `personal_sign` by that address, and send it to [Pay Out to a Bank](https://docs.aureahub.com/docs/cards-payout.md) with the same `amount` and `resolvedIban`.
- `422` without a smart account, or when no IBAN can be found (send `destinationIban`); `503` until your tenant's EUR account access is set up; `423` when a freeze stops the user, the wallet or your tenant from signing.

## Endpoint

### `GET /v1/gnosis/payout/message`

Authentication: bearer token required.

The payout message to sign.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `amount` | string | yes | Euros, e.g. `10.00` |
| `destinationIban` | string | no | The bank account; default the user's own EUR account |
| `isTestnet` | string | no | `true` for the issuer's test environment |

**Responses**

`200` OK

```json
{
  "message": "Send EUR 10.00 to IT60X0542811101000000123456 at 2026-10-14T09:00:00.000Z",
  "resolvedIban": "IT60X0542811101000000123456",
  "gnosisAddress": "0x2f4b6c2e9a1d5f3b7c8e0a4d6b2c9e1f3a5d7b90"
}
```

**Example request**

```bash
curl "https://api.aureahub.com/v1/gnosis/payout/message?amount=10.00&destinationIban=IT60X0542811101000000123456" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#cards-payout-message