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
Paygate interface
Format Description a alphabetical as alphabetical with special characters n numeric an alphanumeric ans alphanumeric with special characters ns numeric with special characters bool boolean expression (true or false) 3 fixed length with 3 digits/characters ..3 variable length with maximum 3 digits/characters enum enumeration of allowed values dttm ISODateTime (YYYY-MM-DDThh:mm:ss) Abbreviation Description CND condition M mandatory O optional C conditional Notice: Please note that the names of parameters can be returned in upper or lower case.Definitions
Data formats
Abbreviations
Comment If a parameter is mandatory, then it must be present If a parameter is optional, then it can be present, but it is not required If a parameter is conditional, then there is a conditional rule which specifies whether it is mandatory or optional
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 Paygate 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:
https://www.computop-paygate.com/paymorrow.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for PayMorrow payment initialisations
The following table describes the result parameters with which the Computop Paygate responds to your system
pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
Response parameters for the PayMorrow payment initialisation
Confirming a PayMorrow authorisation
In order to confirm a PayMorrow authorization, please use the following URL:
https://www.computop-paygate.com/paymorrow.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for the confirmation of a PayMorrow authorisation
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
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:
https://www.computop-paygate.com/paymorrow.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for changing the PayMorrow TransID
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
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:
https://www.computop-paygate.com/capture.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for capture of a PayMorrow payment
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
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:
https://www.computop-paygate.com/paymorrow.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for the updating of an invoice number with PayMorrow payments
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
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:
https://www.computop-paygate.com/inquire.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for querying the status of a PayMorrow order
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
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:
https://www.computop-paygate.com/paymorrow.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for the pausing of PayMorrow payments
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
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:
https://www.computop-paygate.com/reverse.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for reversal of a PayMorrow payment
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
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:
https://www.computop-paygate.com/credit.aspx |
Notice: For security reasons, Computop Paygate rejects all payment requests with formatting errors. Therefore, please use the correct data type for each parameter. The following table describes the encrypted payment request parameters:
Parameters for crediting of a PayMorrow payment
The following table describes the result parameters with which the Computop Paygate responds to your system pls. be prepared to receive additional parameters at any time and do not check the order of parameters the key (e.g. mid, RefNr) should not be checked case-sentive
Response parameters for crediting a PayMorrow payment
Batch processing via the interface
Basic information about using Batch files and about their structure can be found in the Batch Manager manual. Within batch processing not alle functions are available which are usually available for the online 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:
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
The following table describes the individual fields and values used within the data set (record) in the batch file:
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>
The following table describes the response parameters which the Batch Manager saves in the Record area for each transaction (standard parameters not explained here, such as <TransID> or <RefNR> and request parameters are returned unchanged and correspond to the call as specified before):
Description of result parameters within the record for Batch files