Create Payment Transaction

apikey

string

Your individual API key. It identifies the merchant, determines the contract, and grants access to the API. 40 alphanumeric digits like 6801fxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx7ace.

payment_type

string

Determines the payment method:

• prepay (advance payment)

• debit (SEPA direct debit)

• invoice

• creditcard

• sofort

You can only use the contracted methods. The same method might be active in demo mode or not. Please ask our customer service for more payment methods.

demo

boolean|number| string

Optional demo flag:

• 0 or false (real transaction)

• 1 or true (demo transaction)

If ommitted, it defaults to false. Then it is a real transaction.

payment_action

string

Optional. Determines the workflow:

• sale

• authorization

In the sale flow the buyer completes the payment process with a pay now button. This is the final closure, and the money is captured immediately.

Having the authorization flow, the payment is only authorized. It needs a subsequent interface call to capture the money. You would use this flow if the final closure is done at your site after the customer returned to it.

If omitted, the payment action defaults to sale.

language

string

Optional, the language of the payment window:

• de_DE for German

• en_US for English

If omitted, it defaults to de_DE.

title

string

Optional "Mr" or "Mrs".

firstname

string

First name(s), like "Max-Johann", or "John M."

lastname

string

Last name(s), like "Mustermann", "Mustermann-Müller", or "van Mustermann".

company

string

Optional company name, like "Musterfirma GmbH & Co. KG". It is mandatory, if the customer is a company.

street

string

Street without house number, like "Musterallee", or "Dr.-Max-Mustermann-Platz".

housenumber

string

Full house number (including additions for split or joined properties; for example, "101-103", or "21 b").

zip

string

Postal code, like "09555".

city

string

Official town name.

country

string

Country as ISO-3166 Alpha-2 code; for example "DE" for Germany, or "CH" for Switzerland. See language for the translation of the payment window.

telephone

string

Phone number (international format), like "+493515555555".

dob

string

Optional date of birth (format example 31.01.2020); needed for scoring when you offer invoice.

email

string

E-mail address.

ip

string

IP address of the buyer as string.

amount

string|int

Amount to pay in the smallest unit; for example 1995 with EUR means 1995 Euro Cents, or €19.95.

currency

string

Optional currency as ISO-4217 Alpha-3 code; for example EUR, GBP, or CHF. Special contract options are required in order to receive payments in currencies other than EUR.

If omitted, the currency defaults to Euro (EUR).

purpose

string

Optional purpose line. It is displayed for each position (a) at the bank statement of the payer, and (b) at our detailed advice note for the merchant. For example "order 5002012345 from 2020/01/31" or "hotel room, 1 p., b&b" .

apiversion

string

Optional API version, for example "2.11"

url_success

string

URL to return in case of success. See section Return Customer To Merchant Page.

url_failure

string

URL to return in any case of failure. See section Return Customer To Merchant Page.

url_push

string

URL to receive push messages on status changes. See section Receive Status Notifications (Push API).

status

string

Whether the query was successful or not:

• ok

• error

data/hash

string

Transaction identifier, needed for subsequent API calls.

data/iframe_url

string

URL for authorisation or payment, depending on the payment_action.