Preauthorization/Authorization

Additional parameters for use with "preauthorization" or “authorization”.

Request

Parameter

Required

Short explanation

clearingtype

+

Has to be "wlt"

wallettype

+

Has to be "ALP"

amount

+

Total amount (in smallest currency unit! e.g. cent)

Specifies the total gross amount of a payment transaction.

Value is given in smallest currency unit, e.g. Cent of Euro; Pence of Pound sterling; Öre of Swedish krona.

The amount must be less than or equal to the amount of the corresponding booking.

Format

NUMERIC(1..10)

Permitted values

max. +/- 19 999 999 99

currency

+

Currency (ISO 4217) only EUR, GBP,USD, SGD, AUD, NZD

Specifies currency for this transaction


Format

LIST 

Permitted values

 ISO 4217 (currencies) 3-letter-codes

Samples

EUR
USD
GBP

Response

Parameter

Required

Short explanation

status

+

REDIRECT / ERROR

Parameter (REDIRECT) (e-wallet)

redirecturl

+

Redirect URL

Redirect URL → zMerchant system has to redirect customer to this URL to complete payment

Format

CHAR(2..2000)

Parameter (ERROR)

errorcode

+

Error number

In case of error the PAYONE Platform returns an error code for your internal usage.

Format

NUMERIC(1..6)

errormessage

-

Error message

In case of error the PAYONE Platform returns an error message for your internal usage.

Format

CHAR(1..1024)

customermessage

-

Error message for the end customer

(Language selection is based on the end customer’s language, „language“)

The customermessage is returned to your system in order to be displayed to the customer.

(Language selection is based on the end customer's language, parameter "language")

Format

CHAR(1..1024)

Specials

  • Chinese characters are not supported by the PAYONE platform
  • Partial Captures are supported but the account of the customer will be debit with the Preauthorization
  • Partial Refunds are not supported
  • Reversal is not supported

Examples of Usage

Sale

Order & Delivery

Returns

  • No labels