View Source

Specific parameters for PPROCC

Besides the general parameters described above for the credit card connection, PPRO requires the following additional parameters. An authorisation with 3-D Secure is possible. The following table describes the encrypted payment request parameters:

Additional parameters for the credit card connection via form

Additional result parameters for URLNotify, URLSuccess and URLFailure

Specific parameters for PPROCC

Besides the general parameters described above for the credit card connection, PPRO requires the following additional parameters. An authorisation with 3-D Secure is possible. The following table describes the encrypted payment request parameters:

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Not with 3-D Secure:	Nicht mit 3-D Secure:
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise etc.
UserData	ans..1024	OC	Not with 3-D Secure: If specified at request, forwards the parameter with the payment result to the shop.	Nicht bei 3-D Secure: Wenn beim Aufruf angegeben, übergibt das die Parameter mit dem Zahlungsergebnis an den Shop
CreditCardHolder	ans..60	MC	Not with 3-D Secure: Name of the card holder in the format: <First name><space character><Last name>	Nicht bei 3-D Secure: Name des Karteninhabers im Format: <Vorname><Leerzeichen><Nachname>
CustomerID	ans..64	O	Customer number. Format must be mutually agreed beforehand with !	Kundennummer. Das Format muss vorher mit abgestimmt werden!
SellingPoint	ans..50	O	Selling point	Verkaufsstelle
Service	ans..50	O	Products or services sold	verkaufte Produkte oder Dienstleistungen
Channel	ans..64	O	configuration channel of the PPRO contract (account and ContractID are stored in the system). If it exists, it may overwrite channels stored in the system	Konfigurationskanal des PPRO-Vertrags (Account und ContractID sind im System hinterlegt). Wenn vorhanden, überschreibt er eventuell im System hinterlegten Channel.
AddrCountryCode	a2	M	Country code according to ISO-3166-1, alphanumeric 2 chars	Ländercode im Format ISO-3166-1, alphanumerisch 2-stellig
RTF	a1	O	for repeat payments (subscriptions): I = Initial payment of a new subscription R = Routine payment (Recurring)	bei wiederkehrenden Zahlungen (Abos): I = Initialzahlung eines neuen Abos, R = Wiederkehrende Zahlung (Recurring)
ChDesc	ans..256	O	Text printed on the customer’s credit card bill alongside the payee	Text, der auf der Kreditkartenabrechnung des Kunden neben dem Zahlungsempfänger angezeigt wird

Additional parameters for credit card payments via socket connection

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	OC	Not with 3-D Secure:	Nicht bei 3-D Secure:
UserData	ans..1024	OC	Not with 3-D Secure: If specified at request, forwards the parameter with the payment result to the shop.	Nicht bei 3-D Secure: Wenn beim Aufruf angegeben, übergibt das die Parameter mit dem Zahlungsergebnis an den Shop
PaymentPurpose	ans..26	M	Purpose of payment	Zahlungszweck
PaymentGuarantee	a..12	M	Payment guarantee NONE= no payment guarantee, VALIDATED= customer account valid, but no payment guarantee, FULL= payment guarantee Notice: This parameter is only returned if the Status=OK.	Zahlungsgarantie NONE= keine Zahlungsgarantie, VALIDATED= Kundenkonto valide, aber keine Zahlungsgarantie, FULL= Zahlungsgarantie Hinweis: Dieser Parameter wird nur zurückgegeben, falls der Status=OK ist.
ErrorText	ans..128	M	Detailed PPRO error message. Notice: Is returned only if Status=FAILED. Use is possible only in agreement with	Detaillierte PPRO Fehlermeldung. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit möglich.
CCBIN	n6	O	first six digits of the credit card number	erste sechs Stellen der Kreditkartennummer
Status	a..50	M	OK or AUTHORIZED as well as FAILED. For PPRO there is also AUTHORIZE_REQUEST.	OK oder AUTHORIZED sowie FAILED. Bei PPRO gibt es außerdem noch AUTHORIZE_REQUEST.

Additional response parameters for credit card payments via socket connection