About PayMorrow

General information about PayMorrow

Logo

Info

PayMorrow supports invoice purchasing and secured direct debit in Germany. Merchants benefit from comprehensive protection against bad debt.

Type

Mixed payment methods

Further information can be found on the webpage of PayMorrow (https://paymorrow.de/).

Process flow chart

PayMorrow process flow

interface

PayMorrow purchase on invoice and direct debit

A payment with PayMorrow consists of several transaction steps, which are partly optional and depend on the situation. The PayMorrow interface offers 12 different requests for this, which can be used in different ways.

During the creation of an authorisation or at the latest when confirming it, PayMorrow requires a DeviceID which is unique and which the merchant himself can assign. A UUID with 128 bits should be used for this. This UUID is generated during communication with the customer’s browser and is then transferred to in one of the requests.

A payment with PayMorrow always starts by creating an authorisation, which can still be updated if necessary. Subsequently, this authorisation must be confirmed. Optionally a received TransID of an order can still be changed before the capture. The capture or partial capture of payments takes place via the usual capture interface. Note that with PayMorrow you must make sure that a payment received in another way (bank transfer) must also be noted in this way in the capture. If necessary, you can optionally update an invoice number after capture. You can determine the status of a procedure by means of a query. In addition you can optionally shift the date for an order or individual invoices belonging to it by pausing them. Furthermore, cancellations as well as credits and partial credits are possible via the usual interfaces.

Creating/updating a PayMorrow authorisation

In order to initialise a payment with PayMorrow via a server-to-server-connection or to update an existing authorisation, please use the following URL:

paymorrow.aspx

Key	Format	CND	Description	Beschreibung
PayID	an32	C	Obligatory if EventToken=11: ID assigned by for the payment, e.g. for referencing in batch files	Pflicht bei EventToken=11: Vom vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien
RefNr	ns..30	M	Unique reference number	Eindeutige Referenznummer

Key

Format

CND

Description

Beschreibung

TaxAmount

n..10

M

Tax amount of the entire order in the smallest currency unit (e.g. EUR Cent).

Please note that: TaxAmount = Amount * x/(1+x), where x is the VAT rate.

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Steuerbetrag der gesamten Bestellung in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte beachten Sie, dass: TaxAmount = Amount * x/(1+x), wobei x der Mehrwertsteuersatz ist.

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..384	M	Description of purchased goods, unit prices etc. The first 50 characters appear in the merchant’s settlement file. You can view the full data in .	Beschreibung der gekauften Waren, Einzelpreise etc. Die ersten 50 Zeichen erscheinen auf dem Settlement File des Händlers. In können Sie die kompletten Daten einsehen.
EventToken	a2	M	10 for prepareOrder (create authorisation) 11 for updateOrder (update authorisation)	10 für prepareOrder (Autorisierung anlegen) 11 für updateOrder (Autorisierung aktualisieren)
TermsAndConditions	a..3	M	YES/NO	YES/NO
ArticleList	ans..1024	M	Article list with the following parameters: „;“ separates the single parameters „+“ separates several articles Quantity;ArticleID;Name;Type;Category;UnitPriceGross;GrossAmount;VatRate;VatAmount Possible values for “type”: GOODS, VOUCHER, SHIPPING, PAYMENT_FEE Please use the values specified for “Category” from the Paymorrow specification. Example “VatRate”: for 19%, enter 1900	Artikelliste mit folgenden Parametern: „;“ trennt die einzelnen Parameter „+“ trennt mehrere Artikel Quantity;ArticleID;Name;Type;Category;UnitPriceGross;GrossAmount;VatRate;VatAmount Mögliche Werte für „Type“: GOODS, VOUCHER, SHIPPING, PAYMENT_FEE Bitte entnehmen Sie die vorgegebenen Werte für „Category“ aus der Paymorrow-Spezifikation. Beispiel „VatRate“: für 19% übergeben Sie 1900
CustomerID	ans..50	O	Customer number	Kundennummer
Title	ans..20	O	Title, e.g. Dr.	Titel, z.B. Dr.
Gender	a1	M	Gender (M=male/F=female)	Geschlecht (M=male / F=female)
FirstName	ans..50	M	First name	Vorname
LastName	ans..100	M	Last name	Nachname
Phone	ans..20	OC	Telephone number. Either Phone or MobileNo or both need to be present.	Telefonnummer. Entweder Phone oder MobileNo oder beide müssen angegeben sein.
MobileNo	ans..50	OC	Mobile telephone number. Either Phone or MobileNo or both need to be present.	Mobiltelefonnummer. Entweder Phone oder MobileNo oder beide müssen angegeben sein.
e-mail	ans..80	M	E-mail address	E-Mail-Adresse
DateOfBirth	ans8	M	Date of birth in the format YYYYMMDD	Geburtsdatum im Format JJJJMMTT
bdStreet	ans..50	M	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdStreetNr	ans..5	M	Street number of the invoicing address	Hausnummer der Rechnungsadresse
bdZIP	ans..5	M	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdCity	ans..50	M	Town/city of the invoicing address	Ort der Rechnungsadresse
bdCountryCode	a3	M	Country code for the invoicing address, 3 characters according to ISO 3166	Ländercode der Rechnungsadresse, dreistellig gemäß ISO 3166
sdLastName	ans..50	O	Name of company	Firmenname
sdStreet	ans..50	O	Street name of the separate delivery address	Straßenname der separaten Lieferadresse
sdStreetNr	n..5	O	Street number of the delivery address	Hausnummer der Lieferadresse
sdStreet2	ans..50	O	Address addition in the delivery address	Adresszusatz in der Lieferadresse
sdZIP	ans..5	O	Postcode in the delivery address	Postleitzahl in der Lieferadresse
sdCity	ans..50	O	Town/city in the delivery address	Ortsname in der Lieferadresse
sdCountryCode	a3	O	Country code for the delivery address, 3 characters according to ISO 3166	Ländercode der Lieferadresse, dreistellig gemäß ISO 3166
IPAddr	ans..15	O	Customer´s IP address	IP-Adresse des Kunden
BrowserSessionID	ans..50	M	Customer´s Session ID	SessionID des Kunden
CookiesID	ans..50	M	Customer´s CookieID	CookieID des Kunden
BrowserHeader	ans..100	M	Customer’s BrowserHeader	BrowserHeader des Kunden
Language	a2	M	Language: DE	Sprache: DE
IBAN	ans..34	O	International Bank Account Number	International Bank Account Number
BIC	ans..11	O	Bank Identifier Code	Bank Identifier Code
MandateProvided	a..3	O	SEPA mandate issued YES / NO	SEPA-Mandat erteilt YES / NO
RPMethod	a..10	O	INVOICE / SDD (SEPA direct debit) If nothing is transferred both payment methods are validated, otherwise PayMorrow validates only this one.	INVOICE / SDD (SEPA-Lastschrift) Wenn nichts übergeben ist, werden beide Zahlarten validiert, sonst validiert PayMorrow nur diese.
CustomerHistory	ans..1024	O	Customer’s article list in the form: OrderDate;totalAmount;RPMethod;Paymentstatus OrderDate = YYYY-MM-DD Paymentstatus = PAID,NOT_PAID,IN_DUNNING_PROCESS “+” separates further entries	Einkaufsverlauf des Kunden in der Form: OrderDate;totalAmount;RPMethod;Paymentstatus OrderDate = YYYY-MM-DD Paymentstatus = PAID,NOT_PAID,IN_DUNNING_PROCESS „+“ trennt weitere Einträge
ShoppingDuration	n..100	O	Shopping duration in milliseconds	Einkaufsdauer in Millisekunden
CheckoutDuration	n..100	O	Checkout duration in milliseconds	Checkout-Dauer in Millisekunden
DeviceID	ans..100	O	Unique Device-ID	Eindeutige Geräte-ID

Parameters for PayMorrow payment initialisations

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers
bdStreet	ans..50	C	Only in case of correction by PayMorrow: Street name in the invoicing address	nur bei Korrektur durch PayMorrow: Straßenname der Rechnungsadresse
bdStreetNr	s..5	C	Only in case of correction by PayMorrow: Street number of the invoicing address	nur bei Korrektur durch PayMorrow: Hausnummer der Rechnungsadresse
bdZIP	ans..5	C	Only in case of correction by PayMorrow: Postcode in the invoicing address	nur bei Korrektur durch PayMorrow: Postleitzahl der Rechnungsadresse
bdCity	ans..50	C	Only in case of correction by PayMorrow: Town/city of the invoicing address	nur bei Korrektur durch PayMorrow: Ort der Rechnungsadresse
bdCountryCode	a3	C	Only in case of correction by PayMorrow: Country code for the invoicing address, 3 characters according to ISO 3166	nur bei Korrektur durch PayMorrow: Ländercode der Rechnungsadresse, dreistellig gemäß ISO 3166
sdLastName	ans..50	C	Only in case of correction by PayMorrow: Name of company	nur bei Korrektur durch PayMorrow: Firmenname
sdStreet	ans..50	C	Only in case of correction by PayMorrow: Street name of the separate delivery address	nur bei Korrektur durch PayMorrow: Straßenname der separaten Lieferadresse
sdStreetNr	n..5	C	Only in case of correction by PayMorrow: Street number of the delivery address	nur bei Korrektur durch PayMorrow: Hausnummer der Lieferadresse
sdStreet2	ans..50	C	Only in case of correction by PayMorrow: Address addition in the delivery address	nur bei Korrektur durch PayMorrow: Adresszusatz in der Lieferadresse
sdZIP	ans..5	C	Only in case of correction by PayMorrow: Postcode in the delivery address	nur bei Korrektur durch PayMorrow: Postleitzahl in der Lieferadresse
sdCity	ans..50	C	Only in case of correction by PayMorrow: Town/city in the delivery address	nur bei Korrektur durch PayMorrow: Ortsname in der Lieferadresse
sdCountryCode	a3	C	Only in case of correction by PayMorrow: Country code for the delivery address, 3 characters according to ISO 3166	nur bei Korrektur durch PayMorrow: Ländercode der Lieferadresse, dreistellig gemäß ISO 3166
InvoiceStatus	a..20	M	VALIDATED / NOT_VALIDATED	VALIDATED / NOT_VALIDATED
InvoiceDeclineType	ans..20	M
InvoiceDeclineCommunicated	ans..512	M	Possible detailed feedback for the customer with regard to purchase on invoice	Mögliche detaillierte Rückmeldung für den Kunden bezüglich Rechnungskauf
SDDStatus	a..20	M	VALIDATED / NOT_VALIDATED	VALIDATED / NOT_VALIDATED
SDDDeclineType	ans..20	M
SDDDeclineCommunicated	ans..512	M	Possible detailed feedback for the customer with regard to SEPA direct debit	Mögliche detaillierte Rückmeldung für den Kunden bezüglich SEPA-Lastschrift
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Response parameters for the PayMorrow payment initialisation

Confirming a PayMorrow authorisation

In order to confirm a PayMorrow authorization, please use the following URL:

paymorrow.aspx

Key	Format	CND	Description	Beschreibung
EventToken	a2	M	13 for ConfirmOrder (confirm authorisation)	13 für ConfirmOrder (Autorisierung bestätigen)
RPMethod	a..10	C	Obligatory if INVOICE and SDD have been validated	Pflicht, wenn INVOICE und SDD validiert worden sind
DeviceID	ans..100	C	Obligatory if not yet transferred: Unique Device-ID	Pflicht, wenn noch nicht übergeben: Eindeutige Geräte-ID

Parameters for the confirmation of a PayMorrow authorisation

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Reply parameters for the confirmation of a PayMorrow authorisation

Changing the PayMorrow TransID of an order

In order to change the TransID of a PayMorrow order, for instance to change a provisional order number into a final order number, please use the following URL:

paymorrow.aspx

Key	Format	CND	Description	Beschreibung
EventToken	a2	M	12 for updateOrderID (change order number)	12 für updateOrderID (Bestellnummer ändern)

Parameters for changing the PayMorrow TransID

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Reply parameters for changing the PayMorrow TransID

Capture a PayMorrow payment (full / partial capture)

In order to execute a capture or partial capture for a PayMorrow order or to note another receipt of payment, please use the following URL:

capture.aspx

Key

Format

CND

Description

Beschreibung

TransID

ans..64

MC

ID assigned by Merchant for the payment process to be captured.

Optional if EventToken=27: serves to settle an order or all associated invoices after transfer of the original TransID

Vom Händler initial vergebene ID für den zu buchenden Zahlungsvorgang.

Bei EventToken=27 optional: dient zum Begleichen einer Bestellung bzw. aller zugehörigen Rechnungen nach Übergabe der ursprünglichen TransID

Amount

n..10

M

Amount of the entire order to be captured in the smallest currency unit (e.g. EUR Cent).

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Betrag der zu buchenden Bestellung in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key

Format

CND

Description

Beschreibung

TaxAmount

n..10

M

Tax amount of the entire order to be captured in the smallest currency unit (e.g. EUR Cent).

Please note that: TaxAmount = Amount * x/(1+x), where x is the VAT rate.

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Steuerbetrag der zu buchenden Bestellung in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte beachten Sie, dass: TaxAmount = Amount * x/(1+x), wobei x der Mehrwertsteuersatz ist.

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

MC

Unique reference number / invoice number

Optional if EventToken=27: to settle a certain invoice after transfer of the original RefNr

Eindeutige Referenz / Rechnungsnummer

Bei EventToken=27 optional: zum Begleichen einer bestimmten Rechnung nach Übergabe der ursprünglichen RefNr

Key

Format

CND

Description

Beschreibung

EventToken

a2

M

21 for partial capture

22 for partial capture with approval of the remaining authorised amount

27 for registerDirectPayment (capture of a payment receipt via a different way)

21 für Teilbuchung

22 für Teilbuchung mit Freigabe des restlichen autorisierten Betrages

27 für registerDirectPayment (Buchung eines Zahlungseingangs über einen anderen Weg)

ArticleList

ans..1024

C

Not if EventToken=27; obligatory if EventToken=21 or 22

Article list with the following parameters:

“;” separates the individual parameters
“+” separates several articles

Quantity;ArticleID;Name;Type;Category;UnitPriceGross;GrossAmount;VatRate;VatAmount

Possible values for “type”: GOODS, VOUCHER, SHIPPING, PAYMENT_FEE

Please use the values specified for “Category” from the Paymorrow specification.

Example “VatRate”: for 19%, enter 1900

Optional and only by arrangement with PayMorrow, also the following short article list:

VatRate;VatAmount

Nicht bei EventToken=27; Pflicht bei EventTo-ken=21 oder 22

Artikelliste mit folgenden Parametern:

„;“ trennt die einzelnen Parameter
„+“ trennt mehrere Artikel

Quantity;ArticleID;Name;Type;Category;UnitPriceGross;GrossAmount;VatRate;VatAmount

Mögliche Werte für „Type“: GOODS, VOUCHER, SHIPPING, PAYMENT_FEE

Bitte entnehmen Sie die vorgegebenen Werte für „Category“ aus der Paymorrow-Spezifikation.

Beispiel „VatRate“: für 19% übergeben Sie 1900

Optional und nur nach Vereinbarung mit PayMorrow auch folgende kurze Artikelliste:

VatRate;VatAmount

Parameters for capture of a PayMorrow payment

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number / invoice number	Eindeutige Referenz / Rechnungsnummer
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Response parameters for capturing a PayMorrow payment

Updating PayMorrow invoice numbers

In order to update an invoice number for a PayMorrow payment that was not yet known at the time of the capture, please use the following URL:

paymorrow.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number / invoice number	Eindeutige Referenz / Rechnungsnummer
EventToken	a2	M	24 for updateInvoiceID (update invoice number)	24 für updateInvoiceID (Rechnungsnummer aktualisieren)

Parameters for the updating of an invoice number with PayMorrow payments

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number / invoice number	Eindeutige Referenz / Rechnungsnummer
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Reply parameters for the updating of an invoice number with PayMorrow payments

Querying a PayMorrow order status

In order to query the status of a PayMorrow order, please use the following URL:

inquire.aspx

Key	Format	CND	Description	Beschreibung
EventToken	a2	M	52 for getOrderStatus (query order status)	52 für getOrderStatus (Bestellstatus abfragen)

Parameters for querying the status of a PayMorrow order

Key	Format	CND	Description	Beschreibung
LastStatus	a..50	M	OK or FAILED	OK oder FAILED

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number	Eindeutige Referenznummer
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Reply parameters for querying the status of a PayMorrow order

Pausing PayMorrow payments

In order to pause an order or a payment with PayMorrow, please use the following URL:

paymorrow.aspx

Key

Format

CND

Description

Beschreibung

XID

an32

O

XID of the transaction to be paused.

If no XID is transferred, the entire order is paused.

XID der zu pausierenden Transaktion.

Wenn keine XID übergeben wird, pausiert die gesamte Bestellung.

Key

Format

CND

Description

Beschreibung

RefNr

ns..30

C

Obligatory if EventToken=26: Unique reference number

Pflicht bei EventToken=26: Eindeutige Referenznummer

EventToken

a2

M

for postponeOrderCollection (capture):

26 (pauses the capture specified with XID)

53 (paused all captures belonging to the payment)

für postponeOrderCollection (Buchung):

26 (pausiert die mit XID angegebene Buchung)

53 (pausiert alle zur Zahlung gehörigen Buchungen)

NumberOfDays

n..3

M

Number of days by which the order/payment is to be put back

Anzahl der Tage, um die die Bestellung/Rechnung zurückgestellt werden soll

Parameters for the pausing of PayMorrow payments

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number	Eindeutige Referenznummer
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Reply parameters for the pausing of PayMorrow payments

Reversal of PayMorrow payments

In order to cancel an order or a payment with PayMorrow, please use the following URL:

reverse.aspx

Key	Format	CND	Description	Beschreibung
XID	an32	C	Obligatory if EventToken=42: XID of a certain capture	Pflicht bei EventToken=42: XID einer bestimmten Buchung

Key

Format

CND

Description

Beschreibung

EventToken

a2

M

40 to cancel the order

41 to cancel the capture

42 to cancel a certain partial capture

40 für Storno der Bestellung

41 für Storno der Buchung

42 für Storno einer bestimmten Teilbuchung

Parameters for reversal of a PayMorrow payment

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number	Eindeutige Referenznummer
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Reply parameters for reversal of PayMorrow payments

Issuing a PayMorrow credit

In order to issue a full or partial credit for a previous capture with PayMorrow, please use the following URL:

credit.aspx

Key	Format	CND	Description	Beschreibung
XID	an32	M	ID assigned by for all single transactions (authorization, capture, credit), which are made for one payment. The XID of the Capture to which the credit is to take place must be transferred here.	Vom vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

Key

Format

CND

Description

Beschreibung

Amount

n..10

M

Amount of the entire order to be credited in the smallest currency unit (e.g. EUR Cent).

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Betrag der gutzuschreibenden Bestellung/Buchung in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

TaxAmount

n..10

M

Tax amount of the entire order to be credited in the smallest currency unit (e.g. EUR Cent).

Please note that: TaxAmount = Amount * x/(1+x), where x is the VAT rate.

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Steuerbetrag der gutzuschreibenden Bestellung/Buchung in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte beachten Sie, dass: TaxAmount = Amount * x/(1+x), wobei x der Mehrwertsteuersatz ist.

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number for the credit	Eindeutige Referenznummer für die Gutschrift

Key

Format

CND

Description

Beschreibung

EventToken

a2

M

30 credit for full amount

31 credit for partial amount

35 credit for full amount with receipt of authorisation for the amount

36 credit for partial capture with receipt of authorisation for the amount

30 Gutschrift über vollen Betrag

31 Gutschrift über Teilbetrag

35 Gutschrift über vollen Betrag mit Erhalt der Autorisierung für den Betrag

36 Gutschrift über Teilbuchung mit Erhalt der Autorisierung für den Betrag

ArticleList

ans..1024

C

(only with partial credits, EventToken=31 or 36)

Article list with the following parameters:

“;” separates the individual parameters
“+” separates several articles

Quantity;ArticleID;Name;Type;Category;UnitPriceGross;GrossAmount;VatRate;VatAmount

Possible values for “type”: GOODS, VOUCHER, SHIPPING, PAYMENT_FEE

Please use the values specified for “Category” from the Paymorrow specification.

GrossAmount + VatAmount must always be positive.

Example “VatRate”: for 19%, enter 1900

Optional and only by arrangement with PayMorrow, also the following short article list:

VatRate;VatAmount

(nur bei Teilgutschriften, EventToken=31 oder 36)

Artikelliste mit folgenden Parametern:

„;“ trennt die einzelnen Parameter
„+“ trennt mehrere Artikel

Quantity;ArticleID;Name;Type;Category;UnitPriceGross;GrossAmount;VatRate;VatAmount

Mögliche Werte für „Type“: GOODS, VOUCHER, SHIPPING, PAYMENT_FEE

Bitte entnehmen Sie die vorgegebenen Werte für „Category“ aus der Paymorrow-Spezifikation.

GrossAmount + VatAmount muss stets positiv sein.

Beispiel „VatRate“: für 19% übergeben Sie 1900

Optional und nur nach Vereinbarung mit PayMorrow auch folgende kurze Artikelliste:

VatRate;VatAmount

Parameters for crediting of a PayMorrow payment

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number	Eindeutige Referenznummer
CodeExt	n3	O	Forwarded from Paymorrow: error_1_code	Weitergeleitet von Paymorrow: error_1_code
ErrorText	ans..255	O	Forwarded from Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc	Weitergeleitet von Paymorrow: error_1_technicalDesc + ";" + error_1_consumerShortDesc
CodeExt2	n3	O	Forwarded from Paymorrow: error_2_code	Weitergeleitet von Paymorrow: error_2_code
ErrorText2	ans..255	O	Forwarded from Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc	Weitergeleitet von Paymorrow: error_2_technicalDesc + ";" + error_2_consumerShortDesc
CodeExt[n]	n3	O	Forwarded from Paymorrow: error_[n]_code	Weitergeleitet von Paymorrow: error_[n]_code
ErrorText[n]	ans..255	O	Forwarded from Paymorrow: up to 15 value pairs: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc	Weitergeleitet von Paymorrow, bis 15 Wertepaare: error_[n]_technicalDesc + ";" + error_[n]_consumerShortDesc

Response parameters for crediting a PayMorrow payment

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing a PayMorrow transaction and which information can be found within the response file about the payment status.

Following table gives an overview of all batch versions that are possible for a specific action an their specialities:

Action	Version	Description	Beschreibung
Capture	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Credit	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Reverse	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)

Description of the possible batch versions

The structure for a capture or credit within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
PAYMORROW,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<TaxAmount>
PAYMORROW,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<TaxAmount>
PAYMORROW,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, PayMorrow for the transactions

HEAD für Header, FOOT für Footer, PayMorrow für Transaktionen

Action

a..20

M

The parameter Action defines the type of transaction:

Capture

Credit

Reverse (cancellation)

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Reverse (Storno)

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Unique reference number	Eindeutige Referenznummer

Key

Format

CND

Description

Beschreibung

TaxAmount

n..10

M

Tax amount in the smallest currency unit (e.g. EUR Cent).

Please note that: TaxAmount = Amount * x/(1+x), where x is the VAT rate.

Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).

Steuerbetrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte beachten Sie, dass: TaxAmount = Amount * x/(1+x), wobei x der Mehrwertsteuersatz ist.

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks as follows:

HEAD,<MerchantID>,<Date>,<Version>
PAYMORROW,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<TaxAmount>,<Status>,<Code>
PAYMORROW,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<TaxAmount>,<Status>,<Code>
PAYMORROW,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction: Capture Credit Reverse (cancellation)	Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Credit (Gutschrift) Reverse (Storno)

Description of result parameters within the record for Batch files