Die XML-Struktur welche die spezifischen Zahlungseingangsdaten für die Plattform PayPal enthält ist als Kindelement in das Element specific_payment_data in den Response-Daten von fetchPayments eingebettet.
Wird im Request die Version 1.0.0 abgefragt, werden nur rudimentäre Informationen zur Lieferadresse zurückgeliefert. Bei Version 1.1.0 kommen noch detailliertere Daten zur PayPal-Transaktion zurück, die dann nicht mehr in einem paypal_address-Knoten, sondern in einem allgemeinen paypal-Knoten eingebettet sind. Die erweiterten PayPal-Daten enhalten zusätzliche Werte, wie z.B. die PayPal-Transaction-ID.
Hinweis zu Änderungen an den PayPal-Zahlungen:
Nach einem Abgleich der PayPal-Transaktionen setzt jede Änderung an den PayPal-Feldern das Änderungsdatum des zugehörigen Zahlungseingangs neu. Anpassungen kommen von PayPal und werden nicht durch Speed4Trade CONNECT gemacht. Offizielle Antwort auf die Frage, warum sich der Status einer Transaktion nachträglich ändert:
"... There is no strict procedure on how to plan for these types of events, as we cannot predict when payments will be held. ..."
Spezifischer Response (Beispiel)
<specific_payment_data> <paypal_address><!-- Version 1.0.0 --> <first_name>Max</first_name> <last_name>Mustermann</last_name> <street>Musterplatz</street> <house_number>21</house_number> <street_additional>2. Stock</street_additional> <postal_code>95432</postal_code> <city>Teststadt</city> <country_code_iso>DE</country_code_iso> <email>contact@speed4trade.com</email> </paypal_address> <paypal><!-- Version 1.1.0 --> <first_name>Max</first_name> <last_name>Mustermann</last_name> <street>Musterplatz</street> <house_number>21</house_number> <street_additional>2. Stock</street_additional> <postal_code>95432</postal_code> <city>Teststadt</city> <country_code_iso>DE</country_code_iso> <email>contact@speed4trade.com</email> <paypal_account> <mandator_id>1</mandator_id> <account_id>2</account_id> <account_identifier>emailaddress</account_identifier> </paypal_account> <paypal_transaction_id/> <paypal_parent_transaction_id/> <transaction_timestamp/> <transaction_type/> <transaction_type_info/> <payment_type/> <payment_status/> <pending_reason/> <reversal_reason/> <gross_amount/> <gross_currency/> <fee_amount/> <fee_currency/> <subject/> <memo/> <receipt_id/> <invoice_id/> <first_name/> <last_name/> <street/> <house_number/> <street_additional/> <postal_code/> <city/> <region/> <country_code_iso/> <email/> <phone_number/> </paypal> </specific_payment_data> |
Name |
Beschreibung |
Anz. |
Typ |
sonstiges |
paypal_address |
Wrapper-Element, das die PayPal-Daten für Version 1.0.0 zusammenfasst |
0..1 |
Element |
Version 1.0.0 |
first_name |
Vorname |
0..1 |
string |
Länge: 0 – 100 Zeichen |
last_name |
Nachname |
0..1 |
string |
Länge: 0 – 200 Zeichen |
street |
Straße |
0..1 |
string |
Länge: 0 – 200 Zeichen |
house_number |
Hausnummer |
0..1 |
string |
Länge: 0 – 50 Zeichen |
street_addition |
Zusatzinformation für die Adresse (z.B. bei Müller) |
0..1 |
string |
Länge: 0 – 200 Zeichen |
postal_code |
Postleitzahl |
0..1 |
string |
Länge: 0 – 50 Zeichen |
city |
Ort |
0..1 |
string |
Länge: 0 – 200 Zeichen |
country_code_iso |
ISO-Code des Landes |
0..1 |
string |
Länge: 0 – 100 Zeichen |
PayPal E-Mail-Adresse |
0..1 |
string |
Länge: 0 – 100 Zeichen |
|
paypal |
Wrapper-Element, das die PayPal-Daten für Version 1.1.0 zusammenfasst |
0..1 |
Element |
Version 1.1.0 |
paypal_account |
Wrapper-Element für die Account-Daten |
1 |
Element |
|
mandator_id |
Mandant-ID |
1 |
integer |
|
account_id |
Account-ID |
1 |
integer |
|
account_identifier |
Account-Bezeichner |
1 |
string |
|
paypal_transaction_id |
PayPal Transaction ID |
0..1 |
string |
|
paypal_parent_transaction_id |
PayPal Parent Transaction ID |
0..1 |
string |
|
transaction_timestamp |
Zeitstempel der Transaktion. |
0..1 |
datetime |
|
transaction_type |
Transaktionstyp |
0..1 |
string |
Feste Werte. |
transaction_type_info |
Info des Transaktionstyp (z.B. cart, send-money) |
0..1 |
string |
|
payment_type |
Zahlungstyp |
0..1 |
string |
|
payment_status |
Zahlungsstatus |
0..1 |
string |
|
pending_reason |
Grund für die Verzögerung |
0..1 |
string |
|
reversal_reason |
Grund des Zahlungsumkehrung |
0..1 |
string |
|
gross_amount |
Bruttobetrag |
0..1 |
decimal |
|
gross_currency |
Währung des Bruttobetrags |
0..1 |
string |
|
fee_amount |
Gebühr |
0..1 |
decimal |
|
fee_currency |
Währung der Gebühr |
0..1 |
string |
|
subject |
Verwendungszweck |
0..1 |
string |
|
memo |
Bemerkung |
0..1 |
string |
|
receipt_id |
Beleg-ID |
0..1 |
string |
|
invoice_id |
Rechnungs-ID |
0..1 |
string |
|
first_name |
Vorname |
0..1 |
string |
|
last_name |
Nachname |
0..1 |
string |
|
street |
Straße |
0..1 |
string |
|
house_number |
Hausnummer |
0..1 |
string |
|
street_additional |
Zusatzinformation für die Adresse (z.B. bei Müller) |
0..1 |
string |
|
postal_code |
Postleitzahl |
0..1 |
string |
|
city |
Stadt |
0..1 |
string |
|
region |
Region |
0..1 |
string |
|
country_code_iso |
ISO-Code des Landes |
0..1 |
string |
|
PayPal E-Mail-Adresse |
0..1 |
string |
||
phone_number |
Telefonnummer |
0..1 |
string |
In Version 1.0.0 ist nur der Knoten paypal_address in der Response enthalten. Ab Version 1.1.0 ist nur der Knoten paypal in der Response enthalten, da hier viel mehr Details zum Zahlungseingang aufgelistet sind.
Aufgeführte Werte gelten für das Feld transaction_type. |
transaction_type_id |
transaction_type |
---|---|
1 |
Currency Conversion (credit) |
2 |
Currency Conversion (debit) |
3 |
Payment |
4 |
Recurring Payment |
5 |
Temporary Hold |
6 |
Transfer |
7 |
Donation |
8 |
Fee Reversal |
9 |
Refund |
10 |
send-money |
11 |
Bill |
Version |
Änderungsbeschreibung |
3.3.2.90 |
Einführung des Calls |
3.5.27 |
Anpassung des Calls mit zusätzlichen Feldern (Version 1.1.0) |