Przelewy24 · Schema
TransferRequestPostBody
PaymentsPayment GatewayBank TransferBLIKCard PaymentsE-CommercePolandPolishMulti-CurrencyFintech
Properties
| Name | Type | Description | ||
|---|---|---|---|---|
| transfer | object | Object of transfer | ||
| type | string | Payment types available: wallet, p24, p24mobile | ||
| express | boolean | Default setting - True: True – upon payment, the transfer will be sent in the express mode, False – upon payment, the transfer will be sent in the elixir mode. |
||
| currency | string | Transfer currency in which the funds will be collected for specific payment types: wallet – funds will be collected from the wallet in a given currency; p24, p24mobile – the currency in whic |
||
| send | integer | Values: 0 - none, 1 – send an email with the url to the recipient of the transfer , 2 – send an email with the url to the sender of the transfer, 4 – send an email with a confirmat |
||
| regulations | boolean | Acceptance of Przelewy24 regulations: false – display consent on p24 website (default), true – consent granted, do not display. In case the „true” parameter is sent, the consent – worded |
||
| id | string | Unique transfer ID, UUID recommended | ||
| sign | string | Signature calculated separately for each transfer. For more information see Calculation of sign parameter | ||
| label | string | Additional fields used solely for payments of the following types p24, p24mobile. Additional description in the transfer title. Can be send in the object of transfer, in the l |
||
| ttl | integer | Additional fields used solely for payments of the following types p24, p24mobile. Timestamp – date and time after which it will not be possible to pay the transaction NOTE! For the |
||
| paymentMethod | integer | Additional fields used solely for payments of the following types p24, p24mobile. The payment method selected in P24, see returnUrl |
string | Additional fields used solely for payments of the following types p24, p24mobile. The address to which the client will be redirected after processing the payment in Przelewy24.pl. By defaul |
| sdkVersion | string | Additional fields used solely for payments of the following type p24mobile. Mobile library version number must be provided. This parameter may be obtained directly from the library (iOS - |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TransferRequestPostBody",
"properties": {
"transfer": {
"description": "Object of transfer",
"allOf": [
{
"$ref": "#/components/schemas/TransferObjectBody"
}
]
},
"type": {
"type": "string",
"description": "Payment types available: wallet, p24, p24mobile",
"example": "wallet"
},
"express": {
"type": "boolean",
"description": "Default setting - True: <br/>True \u2013 upon payment, the transfer will be sent in the express mode,<br/> False \u2013 upon payment, the transfer will be sent in the elixir mode.",
"default": true,
"example": true
},
"currency": {
"type": "string",
"maxLength": 3,
"description": "Transfer currency in which the funds will be collected for specific payment types:<br/> wallet \u2013 funds will be collected from the wallet in a given currency;<br/> p24, p24mobile \u2013 the currency in which the client will pay in their funds,<br/>",
"example": "PLN"
},
"send": {
"type": "integer",
"description": "Values:<br/> 0 - none,<br/> 1 \u2013 send an email with the url to the recipient of the transfer ,<br/> 2 \u2013 send an email with the url to the sender of the transfer,<br/> 4 \u2013 send an email with a confirmation of completion to the recipient,<br/> 8 \u2013 send an email with a confirmation of completion to the sender.<br/> In order to choose, e.g. two options, provide the sum of the respective values: email with url to the sender + to the recipient + email with confirmation to the sender:<br/> 2 + 1 + 8 = 11 -> value to be provided",
"example": 11
},
"regulations": {
"type": "boolean",
"default": false,
"description": "Acceptance of Przelewy24 regulations: <br/>false \u2013 display consent on p24 website (default),<br/>true \u2013 consent granted, do not display.<br/>In case the \u201etrue\u201d parameter is sent, the consent \u2013 worded as follows \u2013 must be displayed on the Partner\u2019s website: \u201eI hereby state that I have read the [regulations](https://www.przelewy24.pl/regulamin) and [information obligation](https://www.przelewy24.pl/obowiazekinformacyjny) of \u201dPrzelewy24\u201d. <br/>Under words <i>regulations</i> and <i>information obligation</i> there must be hyperlinks redirecting to websites with these documents. The checkbox must not be ticked by default."
},
"id": {
"type": "string",
"maxLength": 255,
"description": "Unique transfer ID, UUID recommended"
},
"sign": {
"type": "string",
"maxLength": 255,
"description": "Signature calculated separately for each transfer. For more information see <a href=\"#tag/Calculation-of-sign-parameter\"><b>Calculation of sign parameter</b></a>"
},
"label": {
"type": "string",
"maxLength": 20,
"description": "<b>Additional fields used solely for payments of the following types p24, p24mobile.</b><br/> Additional description in the transfer title.<br/><br/> Can be send in the object of transfer, in the <b>label</b> parameter. Value from the object overwirtes value from this parameter"
},
"ttl": {
"type": "integer",
"description": "<b>Additional fields used solely for payments of the following types p24, p24mobile.</b><br/>Timestamp \u2013 date and time after which it will not be possible to pay the transaction<br/><br/>NOTE! For the parameter to work in P24 system, please send a request to [email protected]<br/>Example:<br/><br/> 1577833200 = 2020-01-01 00:00:00<br/>0 = no limit (as default)"
},
"paymentMethod": {
"type": "integer",
"description": "<b>Additional fields used solely for payments of the following types p24, p24mobile.</b><br/> The payment method selected in P24, see <a href=\"#tag/Ekspres-P24-API/paths/~1express~1v1~1payment~1methods/get\"><b>v1/payment/methods</b></a>"
},
"returnUrl": {
"type": "string",
"maxLength": 255,
"description": "<b>Additional fields used solely for payments of the following types p24, p24mobile.</b><br/>The address to which the client will be redirected after processing the payment in Przelewy24.pl. By default, the client will return to the URL address generated upon transfer registration."
},
"sdkVersion": {
"type": "string",
"maxLength": 10,
"default": "3.0",
"description": "<b>Additional fields used solely for payments of the following type p24mobile.</b><br/> Mobile library version number must be provided. This parameter may be obtained directly from the library (iOS - class P24, Android - class P24SdkVersion). The default value sent is \u201e3.0\u201d."
}
},
"required": [
"transfer",
"type",
"currency",
"send",
"id",
"sign"
]
}