Szenario – Ratenzahlungen

  • Sie bieten Ihren Kunden die Zahlung per Kreditkarte auf Basis einer Ratenzahlung an

  • Kunden vereinbaren eine Ratenzahlung auf Basis eines Gesamtbetrages und einer Anzahl an Ratenzahlungen

  • Sie nutzen die Pseudokartennummer, um Kartendaten zu speichern und wiederzuverwenden

  • WICHTIG: Die folgende anfängliche Zahlung unterliegt der Haftungsumkehr für Sie als Händler. Bei einer nachfolgenden Zahlung erlischt diese jedoch, so dass es keine Haftungsumkehr gibt.

(info)  credentialOnFile wurde um type=installments und einige Attribute zur Beschreibung der Ratenzahlung erweitert.

Credentials on File (CoF) – Anfängliche Ratenzahlung

  • Gilt für PaySSL.aspx + PayNow.aspx

  • 3-D Secure ist Pflicht

  • Notwendige Anpassungen:

    • Beispiel:

      • JSON-Objekt credentialOnFile mit JSON-Parameter installment (3 Keys enthalten)

      • JSON-Objekt credentialOnFile mit JSON-Parameter initialPayment und dem Wert "true"

      • der für die anfängliche Zahlungsanforderung verwendete Betrag ist der für die erste Ratenzahlung autorisierte Betrag
      • Beispiel für eine anfängliche Abonnementzahlung für 3 Ratenzahlungen mit einem Gesamtbetrag von 100,00 (EUR):

Anfängliche Ratenzahlung
{
  "type": {
    "installments": {
      "total": 3,
      "curIdx": 1,
      "purchaseAmount": 10000
    }
  },
  "initialPayment": true
}

Credentials on File (CoF) – Nachfolgende Ratenzahlung

  • Gilt für installment.aspx

  • 3-D Secure ist NICHT verpflichtend

  • Notwendige Anpassungen:

    • Beispiel:

      • Für jede nachfolgende Ratenzahlung wird die PayId von der anfänglichen Zahlung benötigt.
      • Senden Sie bitte immer die schemereferenceID von der anfänglichen Zahlung mit, damit die nachgelagerten Systeme die beiden Transaktionen entsprechend verknüpfen können.
      • JSON-Objekt credentialOnFile mit JSON-Parameter recurring (3 Keys enthalten)

      • JSON-Objekt credentialOnFile mit JSON-Parameter initialPayment und dem Wert "false"

      • Der Gesamtkaufbetrag (purchaseAmount) und die Gesamtzahl der Ratenzahlungen (total) bleibt gleich, der aktuelle Index erhöht sich mit jeder Autorisierung.
      • Der für die nachfolgende Zahlungsanfrage verwendete Betrag ist der für nachfolgende Ratenzahlung autorisierte Betrag
      • Beispiel für eine nachfolgende Abonnementzahlung:

Nachfolgende Ratenzahlung
{
  "type": {
    "installments": {
      "total": 3,
      "curIdx": 2,
      "purchaseAmount": 10000
    }
  },
  "initialPayment": false
}




Anfrage / Antwort installment.aspx

Anfrageelemente

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

(info) Die PayID in der Anfrage bezieht sich immer auf die anfängliche Zahlung, die mit PaySSL oder PayNow erzeugt wurde

(info) Die PayID in der Antwort ist der neue Zahlungsvorgang, der für die nachfolgende Ratenzahlung erzeugt wurde

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung
Typea4MPaymethod for installment payment.
"CB2A" must be specified.

Zahlart für die Ratenzahlung.
Hier muss "CB2A" angegeben werden.

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
ReqId

ans..32

O

To avoid double payments or actions (e.g. by ETM), enter an alphanumeric value which identifies your transaction and may be assigned only once. If the transaction or action is submitted again with the same ReqID, Computop Paygate will not carry out the payment or new action, but will just return the status of the original transaction or action.

Please note that the Computop Paygate must have a finalized transaction status for the first initial action (authentication/authorisation). This does not apply to 3-D Secure authentications that are terminated by a timeout. The 3-D Secure Timeout status does not count as a completed status in which the ReqID functionality on Paygate does not take effect. Submissions with identical ReqID for an open status will be processed regularly.

Notice: Please note that a ReqID is only valid for 12 month, then it gets deleted at the Paygate.

Um Doppelzahlungen (z.B. durch ETM) zu vermeiden, übergeben Sie einen alphanumerischen Wert, der Ihre Transaktion oder Aktion identifiziert und nur einmal vergeben werden darf. Falls die Transaktion oder Aktion mit derselben ReqID erneut eingereicht wird, führt das Computop Paygate keine Zahlung oder weitere Aktion aus, sondern gibt nur den Status der ursprünglichen Transaktion oder Aktion zurück.

Bitte beachten Sie, dass das Computop Paygate für die erste initiale Aktion (Authentifizierung/Autorisierung) einen abgeschlossenen Transaktionsstatus haben muss. Dies gilt nicht für 3-D Secure Authentifizierungen, die durch einem Timeout beendet werden. Der Status 3-D Secure Timeout gilt nicht als abgeschlossener Status, bei dem ReqID-Funktionalität am Paygate nicht greift. Einreichungen mit identischer ReqID auf einen offenen Status werden regulär verarbeitet.

Hinweis: Bitte beachten Sie, dass eine ReqID nur 12 Monate gültig ist, danach wird sie vom Paygate gelöscht.

KeyFormatCNDDescriptionBeschreibung
credentialOnFileJSONMObject specifying type and series of transactions using payment account credentials (e.g. account number or payment token) that is stored by a merchant to process future purchases for a customer. Required if applicable.Objekt, dass Art und Reihe der Transaktionen angibt, die unter Verwendung von beim Händler hinterlegten Zahlungsdaten (z.B. Kontonummer oder Zahlungs-Token) zur Verarbeitung künftiger Käufe eines Kunden erfolgen. Erforderlich, falls zutreffend.
RefNran12O

Merchant’s unique reference number, which serves as payout reference in the acquirer EPA file. Please note, without the own shop reference delivery you cannot read out the EPA transaction and regarding the additional Computop settlement file (CTSF) we cannot add the additional payment data.

Notes:

  • CB2A requires
    • fixed length of 12 characters, Paygate automatically align value to the right and add "0" (zero) to the left
    • only characters (A..Z, a..z) and digits (0..9) are allowed, no characters like underscore, minus, ...
    • RefNr is mandatory in case of "pre-authorization" by CB2A
      ((info) a MerchantID can be setup on Paygate either to handle "authorization" or "pre-authorization")

Eindeutige Referenznummer des Händlers, welche als Auszahlungsreferenz in der entsprechenden Acquirer EPA-Datei angegeben wird. Bitte beachten Sie, ohne die Übergabe einer eigenen Auszahlungsreferenz können Sie die EPA-Transaktionen nicht zuordnen, zusätzlich kann das Computop Settlement File (CTSF) auch nicht zusätzlich angereichert werden.

Anmerkungen:

  • CB2A erfordert
    • feste Länge von 12 Zeichen, Paygate füllt automatisch rechtsbündig mit "0" (Ziffer Null) auf
    • erlaubt sind nur Buchstaben (A..Z, a..z) und Ziffern (0..9), keine Sonderzeichen
    • RefNr is verpflichtend für "pre-authorization" für CB2A
      ((info) die MerchantId kann auf Seiten Paygate entweder für "authorization" oder "pre-authorization" konfiguriert werden

KeyFormatCNDDescriptionBeschreibung
Amount

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyFormatCNDDescriptionBeschreibung
Currency

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyFormatCNDDescriptionBeschreibung
Capture

an..6

OM

Determines the type and time of capture.

Capture ModeDescription
AUTOCapturing immediately after authorisation (default value).
MANUALCapturing made by the merchant. Capture is normally initiated at time of delivery.
<Number>Delay in hours until the capture (whole number; 1 to 696).

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

BuchungsartBeschreibung
AUTOBuchung sofort nach Autorisierung (Standardwert).
MANUALBuchung erfolgt durch den Händler - in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

KeyFormatCNDDescriptionBeschreibung

MAC

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:


Antwortelemente (Ratenzahlungen)

Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

KeyFormatCNDDescriptionBeschreibung
PayID

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.

Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

KeyFormatCNDDescriptionBeschreibung
XID

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
refnr
OReference number as given in requestReferenznummer wie im Request angegeben

Status

a..20

M

Status of the transaction.

Values accepted:

  • AUTHORIZED
  • FAILED

Status der Transaktion.

Zulässige Werte:

  • AUTHORIZED

  • FAILED

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

n8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

KeyFormatCNDDescriptionBeschreibung
UserData

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.