Individual parameter (per payment process)

Dynamic text element on account statements

CHAR(1..81)

(3 lines with 27 characters each) and credit card statements.

Indicates whether customer is “present” and can enter their data in the shop (=yes). Or customer is not present and can not enter any data (=no).

Value specifies business relation between merchant and customer

First name of customer; optional if company is used, i.e.: you may use

• "company"
• or "lastname"
• or "firstname" plus "lastname"

Company name of customer; The company name is optional if lastname is used, i.e.: you may use

• "company"
• or "lastname"
• or "firstname" plus "lastname"

CHAR(5..254)

RFC 5322

Special Remark email validation:

Max. length for email is 254 characters. Validation is set up in the following way:

• Username = Max. 63 characters
• Domain Name = Max. 63 characters
• Domain Suffixes = Max. 4 suffixes with max. 124 characters 

Example: username[63]@domain_name[63].suffix[60].suffix[60].suffix[4]

LIST 

f    

m

d

* currently not in use

Person specific numbers or characters, e.g. number of passport / ID card

Customer's IP-V4-address (123.123.123.123) or IP-V6-address

Account type/ country for use with BBAN (i.e. bankcode, bankaccount): DE

DE: Mandatory with bankcode, bankaccount, optional with IBAN

For other countries than DE please use IBAN or IBAN/BIC

Bank Identifier Code to be used for payment or to be checked

CHAR(8 or 11) Only capital letters and digits, no spaces

[0-9][A-Z]

BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required. 

Bank Identifier Code to be used for payment or to be checked

CHAR(8 or 11) Only capital letters and digits, no spaces

[0-9][A-Z]

BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required. 

URL for "payment successful"

URL for "faulty payment"

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

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

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

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")

Sequence number for this transaction within the payment process (1..n), e.g. PreAuthorization: 0, 1. Capture: 1, 2. Capture: 2

Required for multi partial capture (starting with the 2^nd capture)

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.

Dynamic text element on account statements

CHAR(1..81)

(3 lines with 27 characters each) and credit card statements.

Individual parameter (per payment process)

Dynamic text element on account statements

CHAR(1..81)

(3 lines with 27 characters each) and credit card statements.

Indicates whether customer is “present” and can enter their data in the shop (=yes). Or customer is not present and can not enter any data (=no).

Value specifies business relation between merchant and customer

First name of customer; optional if company is used, i.e.: you may use

• "company"
• or "lastname"
• or "firstname" plus "lastname"

Company name of customer; The company name is optional if lastname is used, i.e.: you may use

• "company"
• or "lastname"
• or "firstname" plus "lastname"

CHAR(5..254)

RFC 5322

Special Remark email validation:

Max. length for email is 254 characters. Validation is set up in the following way:

• Username = Max. 63 characters
• Domain Name = Max. 63 characters
• Domain Suffixes = Max. 4 suffixes with max. 124 characters 

Example: username[63]@domain_name[63].suffix[60].suffix[60].suffix[4]

LIST 

f    

m

d

* currently not in use

Person specific numbers or characters, e.g. number of passport / ID card

Customer's IP-V4-address (123.123.123.123) or IP-V6-address

Account type/ country for use with BBAN (i.e. bankcode, bankaccount): DE

DE: Mandatory with bankcode, bankaccount, optional with IBAN

For other countries than DE please use IBAN or IBAN/BIC

Bank Identifier Code to be used for payment or to be checked

CHAR(8 or 11) Only capital letters and digits, no spaces

[0-9][A-Z]

BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required. 

URL for "payment successful"

URL for "faulty payment"

URL for "Back" or "Cancel"

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

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

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

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")

Sequence number for this transaction within the payment process (1..n), e.g. PreAuthorization: 0, 1. Capture: 1, 2. Capture: 2

Required for multi partial capture (starting with the 2^nd capture)

Gross amount of debit (in smallest currency unit! e.g. cent, max. 19 999 999 99)

Credit: amount < 0

Payment request: amount > 0

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

Dynamic text element on account statements

CHAR(1..81)

(3 lines with 27 characters each) and credit card statements.

Bank Identifier Code to be used for payment or to be checked

CHAR(8 or 11) Only capital letters and digits, no spaces

[0-9][A-Z]

BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required. 

Account type/ country for use with BBAN (i.e. bankcode, bankaccount): DE

DE: Mandatory with bankcode, bankaccount, optional with IBAN

For other countries than DE please use IBAN or IBAN/BIC

Account number (BBAN)

• DE: bankcountry, bankcode and bankaccount may be used. Then IBAN will be generated by PAYONE platform and used for SEPA transactions.
• Not DE: Please use IBAN or IBAN / BIC.

Sort code (BBAN) (only in DE)

• DE: bankcountry, bankcode and bankaccount may be used. Then IBAN will be generated by PAYONE platform and used for SEPA transactions.
• Not DE: Please use IBAN or IBAN / BIC.

A SEPA mandate can be created if a payment is initiated (amount > 0). Can be used to enforce a merchant specific mandate identification. The mandate_identification has to be unique.

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

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

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")

Sequence number for this transaction within the payment process (1..n), e.g. PreAuthorization: 0, 1. Capture: 1, 2. Capture: 2

Required for multi partial capture (starting with the 2^nd capture)

Always provide a negative amount

NUMERIC(1..10), max. value +/- 19 999 999 99

Dynamic text element on account statements

CHAR(1..81)

(3 lines with 27 characters each) and credit card statements.

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

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