## Parameters The following parameters can be used either as query parameters in a `GET` request or as JSON fields in a `POST` request.


iban: String REQUIRED

The [international bank account number](https://en.wikipedia.org/wiki/International_Bank_Account_Number?target="_blank") of the recipient. Any spaces between the blocks are removed. For example, `AT00 0000 0000 0000 0000` becomes `AT000000000000000000`


recipient: String REQUIRED

The recipients name. The name can be maximum 70 characters long.


bic: String

The bank identifier code of the recipient's bank. Often known as SWIFT code.


amount: Float

The amount to be paid with a maximum of two decimal places. The value is optional, but recommended. If the amount is not specified, the payer must enter it in the banking app itself.


currency: String = EUR

The currency according to [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) (USD, EUR etc.).


reference: String

The payment reference which can be maximum 35 characters long.


text: String

The bank transfer text. The text can be up to 140 characters long and may not be used in the banking app if the `reference` parameter is set.


message: String

A user hint which can be maximum 70 characters long.


size: Integer = 300

The size of the QR code in pixels. The value must be between 100 and 2000 pixels.


frame: Boolean = false

`true` to draw a frame around the QR code. If all parameters are used, a possible request body may look like the following: ```json { "iban": "AT57 2011 1400 1440 0144", "recipient": "Austrian Red Cross", "bic": "GIBAATWWXXX", "amount": 10.00, "currency": "EUR", "reference": "Donation", "text": "Emergency relief", "message": "Thank you for your donation", "size": 250, "frame": true } ``` ## Possible errors | Identifier | Description | |----------------------------------------------------|-----------------------------------------------------------------------------------------------------| | `message.ibanMustNotBeBlank` | Parameter `iban` is required. | | `message.recipientMustNotBeBlank` | Parameter `recipient` is required. | | `message.ibanMustBeValid` | Parameter `iban` must be provided in a valid format. | | `message.bicMustBeValid` | Parameter `bic` must be provided in a valid format. | | `message.currencyMustBeValid` | Parameter `currency` must be valid and provided as an ISO 4217 currency code. | | `message.recipientMustNotBeLongerThan70Characters` | Parameter `recipient` must be maximum 70 characters long. | | `message.referenceMustNotBeLongerThan35Characters` | Parameter `reference` must be maximum 75 characters long. | | `message.textMustNotBeLongerThan140Characters` | Parameter `text` must be maximum 140 characters long. | | `message.messageMustNotBeLongerThan70Characters` | Parameter `message` must be maximum 70 characters long. | | `message.sizeMustNotBeSmallerThan100Pixels` | Parameter `size` must be between 100 and 2000 pixels. | | `message.sizeMustMotBeBiggerThan2000Pixels` | Parameter `size` must be between 100 and 2000 pixels. | | `message.failedToGenerateQrCode` | An unexpected error occurred when generating the QR code. Please retry the request at a later time. |

Cargando API Playground