Amount in the smallest currency unit (e.g. EUR Cent). Please contact the

If OrderDesc(n) is used, there must be valid: Amount=ItemTotal+TaxTotal+SHAmount.

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den

Falls OrderDesc(n) verwendet wird, muss gelten: Amount=ItemTotal+TaxTotal+SHAmount

Auto or Manual: determines whether the requested amount is settled immediately or at a later stage.

Important Note: Please contact

Important Note: In case of Multi-Seller Payment (Marketplace functionality) only Auto is possible.

Auto oder Manual: bestimmt, ob der angeforderte Betrag sofort oder später abgerechnet wird.

Wichtiger Hinweis: Bitte wenden Sie sich an den

Wichtiger Hinweis: Bei einer Multi-Seller-Zahlung (Marktplatzfunktionalität) ist nur Auto möglich.

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

Customers shopping basket in the form:

OrderDesc(n)=Name,Amount,Number,Quantity,Description,Tax

OrderDesc2 to max. OrderDesc99 permissible

For correct execution of displaying function all OrderDesc(n) Amounts must equal to the

Example for transferring all variants:

Amount=1600
OrderDesc2=book,500,1111,1,Article,100&
OrderDesc3=book,600,2222,1,Article,100&
ItemTotal=1100&
TaxTotal=200&
ShAmount=300&

Example including discount:

Amount=400
Orderdesc2=book,500,1234,1,nice book,100&
Orderdesc3=Discount,-200,5678,1,nice book,0&
taxtotal=100&
itemtotal=300&

Warenkorb des Kunden im Format:

OrderDesc(n)=Name,Amount,Number,Quantity,Description,Tax

OrderDesc2 bis max. OrderDesc99 zulässig

Zur korrekten Ausführung der Anzeigefunktion müssen alle OrderDesc(n) Amounts gleich dem

Beispiel zur Übergabe aller Varianten:

Amount=1600 
OrderDesc2=book,500,1111,1,Article,100&
OrderDesc3=book,600,2222,1,Article,100&
ItemTotal=1100&
TaxTotal=200&
ShAmount=300&

Beispiel zusätzlich mit Rabatt / Discount:

Amount=400
Orderdesc2=book,500,1234,1,nice book,100&
Orderdesc3=Discount,-200,5678,1,nice book,0&
taxtotal=100&
itemtotal=300&

Language: AU, DE, FR, IT, GB, ES, US; default DE

If you would like to control the language for the customer on the PayPal login page, please note the sequence of checks at PayPal and how to influence the language accordingly.

1. The user cookie is primary with PayPal. If this is set it overwrites everything (if the browser language is German, then this always has priority).
2. The parameter Localcode – parameter Language on

   Multiexcerpt include
   SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt Wording

   – with a 5 digit ISO code (fr_FR). Please see PayPal documentation: https://developer.paypal.com/reference/locale-codes/.
3. The parameter ShipToCountry from the delivery address (if a delivery address is transferred)
4. The parameter Localcode – parameter Language on

   Multiexcerpt include
   SpaceWithExcerpt EN MultiExcerptName Platform-Kurz PageWithExcerpt Wording

   – with a 2 digit ISO code (FR)
5. The country code of the PayPal account. Please note, this takes place when the customer has logged into his PayPal account. At this point, the language can no longer be actively controlled.

Sprache: AU, DE, FR, IT, GB, ES, US; Standardwert DE

Wenn Sie die Sprache für den Kunden auf der PayPal-Anmeldeseite steuern möchten, beachten Sie bitte den Ablauf der Prüfungen bei PayPal und wie Sie die Sprache entsprechend beeinflussen können.

1. Das User-Cookie ist bei PayPal primär. Wenn dieses gesetzt ist, überschreibt es alles (ist die Browsersprache auf Deutsch, dann hat diese immer Vorrang).
2. Der Parameter localcode – Parameter Language am

   Multiexcerpt include
   SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt DE:Wording

   – mit einem 5-stelligen ISO-Code (fr_FR). Bitte beachten Sie die PayPal-Dokumentation: https://developer.paypal.com/reference/locale-codes/.
3. Der Parameter ShipToCountry aus der Lieferadresse (sofern eine Lieferadresse übergeben wird)
4. Der Parameter Localcode – Parameter Language am

   Multiexcerpt include
   SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt DE:Wording

   – mit einem 2-stelligen Ländercode (FR)
5. Der Ländercode des PayPal-Kontos. Bitte beachten Sie, dass dies erfolgt, wenn sich der Kunde an seinem PayPal-Konto angemeldet hat.Zu diesem Zeitpunkt kann die Sprache nicht mehr aktiv gesteuert werden.

2. Street name in the delivery address that contains additional information e.g. packing station or similar. In order to receive this as a response parameter, it needs to be activated separately by the

2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom

Handover NoShipping=1 prevents the delivery address registered with Paypal from being displayed.

Die Übergabe von NoShipping=1 verhindert, dass die bei Paypal hinterlegte Lieferadresse angezeigt wird.

Zusätzlich bietet das

Array of key-value pair (base64-encoded). List of keys has to be agreed with PayPal (can be different for different merchants) before usage of parameter RiskEvaluation.

Example:

{
 "additional_data": [
    {
      "key": "sender_first_name",
      "value": "John"
    },
    {
      "key": "sender_last_name",
      "value": "Doe"
    }
]
}

Array von Key-Value-Paaren (Base64-codiert). Die Liste der Schlüssel muss vor der Verwendung des Parameters RiskEvaluation mit PayPal vereinbart werden (kann bei verschiedenen Händlern unterschiedlich sein).

Beispiel:

{
 "additional_data": [
    {
      "key": "sender_first_name",
      "value": "John"
    },
    {
      "key": "sender_last_name",
      "value": "Doe"
    }
]
}

In case of Multi-Seller Payment (Marketplace functionality) each PaymentUnit(n) is related to a separate Seller (merchant within the Marketplace) and contains JSON object (base64-encoded) with the following format.

Example:

{
        merchantemailaddress: "merchant@example.com",
        merchantid: "XVRKM94GQDXB2",
        amount: "11000",
        itemtotal: "8000",
        taxtotal: "2000",
        shippingamount: "1000",
        invoiceid: "xxxxx",
        orderdescription: "yyyyy",
        orderitems: [
        {
            name: "zzzzz",
            quantity: "1",
            unitamount: "3000",
            tax: "1000",
            description: "xxxx",
            category: "PHYSICAL_GOODS"
        },
        {
            name: "xxxxx",
            quantity: "2",
            unitamount: "2500",
            tax: "500",
            description: "yyyyy",
            category: "DIGITAL_GOODS"
        }
    ]
}

• Where MerchantID is PayPal PayerID of the merchant.
• InvoiceID must be unique per MerchantID. Merchant cannot use the same InvoiceID twice.
• Valid values for Category are DIGITAL_GOODS, PHYSICAL_GOODS and DONATION. In scope of one PayPal transaction it is allowed to use 1) DIGITAL_GOODS and/or PHYSICAL_GOODS; 2) DONATION. DONATION cannot be combined with DIGITAL_GOODS or PHYSICAL_GOODS.
• ItemTotal is the summary of UnitAmount * Quantity of all Order Items related to this merchant.
• TaxTotal is the summary of Tax of all Order Items related to this merchant.
• Amount is the summary of ItemTotal, TaxTotal and ShippingAmount of this merchant.

Beispiel:

{
        merchantemailaddress: "merchant@example.com",
        merchantid: "XVRKM94GQDXB2",
        amount: "11000",
        itemtotal: "8000",
        taxtotal: "2000",
        shippingamount: "1000",
        invoiceid: "xxxxx",
        orderdescription: "yyyyy",
        orderitems: [
        {
            name: "zzzzz",
            quantity: "1",
            unitamount: "3000",
            tax: "1000",
            description: "xxxx",
            category: "PHYSICAL_GOODS"
        },
        {
            name: "xxxxx",
            quantity: "2",
            unitamount: "2500",
            tax: "500",
            description: "yyyyy",
            category: "DIGITAL_GOODS"
        }
    ]
}

• Dabei ist MerchantID die PayPal PayerID des Händlers.
• InvoiceID muss pro MerchantID eindeutig sein.Der Händler darf dieselbe InvoiceID nicht zweimal verwenden.
• Gültige Werte für die Category sind DIGITAL_GOODS, PHYSICAL_GOODS und DONATION. Für eine PayPal-Transaktion ist die Verwendung von 1) DIGITAL_GOODS und/oder PHYSICAL_GOODS; 2) DONATION. DONATION kann nicht mit DIGITAL_GOODS oder PHYSICAL_GOODS kombiniert werden.
• ItemTotal ist die Zusammenfassung von UnitAmount * Quantity aller Bestellartikel, die sich auf diesen Händler beziehen.
• TaxTotal ist die Zusammenfassung von Tax aller Bestellartikel dieses Händlers.
• Amount ist die Zusammenfassung von ItemTotal, TaxTotal und ShippingAmount dieses Händlers.

If mode="redirect" is sent, it means that the merchant does not use PayPal Smart Button and

if mode is not sent (or sent with any other value except "redirect"), it means that the merchant uses PayPal Smart Button and

Common notes:

• We recommend to use the PayPal Smart Button for additional fraud protection and improved user experience

Wenn mode="redirect" gesendet wird, bedeutet dies, dass der Händler den PayPal Smart Button nicht verwendet und

Allgemeine Hinweise:

• Wir empfehlen, die Verwendung des PayPal Smart Button für zusätzlichen Betrugsschutz und ein verbessertes Benutzererlebnis

OK, AUTHORIZE_REQUEST or Timeout (only if Capture=Manual) on the URLSuccess page or FAILED on the URLFailure page.

AUTHORIZE_REQUEST – is returned actively only for request parameter "TxType=auth" or "PayPalMethod=shortcut". When using TxType=auth or without TxType the final status is returned directly.

Timeout – all open payments with status AUTHORIZE_REQUEST will be closed ~ 3hours later automatically and are reported as Timeout.

OK, AUTHORIZE_REQUEST oder Timeout (nur bei Capture=Manual) auf der URLSuccess-Seite oder FAILED auf der URLFailure-Seite.

AUTHORIZE_REQUEST – wird nur bei Anfrageparameter „TxType=auth“ oder „PayPalMethod=shortcut“ aktiv zurückgegeben. Bei Verwendung von TxType=auth oder ohne TxType wird direkt der finale Status zurückgegeben.

Timeout – alle offenen Zahlungen mit Status AUTHORIZE_REQUEST werden etwa 3 Stunden später automatisch geschlossen und als Timeout gemeldet

2. Street name in the delivery address that contains additional information e.g. packing station or similar. In order to receive this as a response parameter, it needs to be activated separately by the

2. Straßenname in der Lieferadresse, der weitere Informationen zu Packstation o.ä. enthält. Damit dieser Parameter in der Antwort zurückgeliefert werden kann, muss dieser separat vom

Error code from PayPal if agreed with

Fehlercode von PayPal, wenn mit

If <YES> is transferred, the possible open order of PayPal is closed on capture. (Reason: a 115% capture is permissible on the part of PayPal. If a capture reached 100%,

Wenn <YES> übergeben wird, wird die eventuell offene Bestellung von PayPal bei der Buchung geschlossen. (Grund: Seitens PayPal ist eine 115%ige Buchung zulässig. Wenn eine Buchung 100% erreicht, sendet das

Error code from PayPal if agreed with

Fehlercode von PayPal, wenn mit

MassPay: E-Mail subject to recipient

Notice: If you want to use the MassPay functionality, please contact the

MassPay: E-Mail-Betreff an den Empfänger

Wenn Sie die MassPay-Funktionalität nutzen möchten, wenden Sie sich bitte an den

Error code from PayPal if agreed with

Fehlercode von PayPal, wenn mit