Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ENWORK and version Documentation

Data Elements

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1638289138672_-702028680
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamecredential_on_file
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1638289138673_-1343536721
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

KeyFormatCNDDescriptionBeschreibung
1

type

object

M

Type of credential on file payment

Art der Zahlung mit hinterlegten Zugangsdaten
2

initialPayment

boolean

M

Indicates whether a card on file transaction is the first one in a series of transactions (establishment) or a subsequent transaction

Gibt an, ob eine Kartentransaktion mit hinterlegten Daten die erste Transaktion einer Reihe (Einrichtung) oder eine nachfolgende Transaktion ist
3useCasestringOType of use case that is intended.Spezifiziert einen genaueren Anwendungsfall.

Anchor
type
type
type

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1638289138675_890989706
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNametype
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1638289138678_1207508636
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

KeyFormatCNDDescriptionBeschreibung
1

recurring

object

C

Recurring payments are a series of transactions processed persuant to an agreement between a cardholder and a merchant where the cardholder purchases goods or services over a period of time through a number of separate transactions. Please note that in the context of PSD2 and SCA requirements the European Banking Authority (EBA) describes recurring payments as a series of transactions with the same amount and with the same payee.

In conjunction with useCase (optional):

useCase (optional)Description
absentStandard subscription use case
fixedSubscription is fixed amount, fixed duration/frequency
flexibleAmountSubscription has flexible amount, fixed duration/frequency
flexibleFrequencySubscription has fixed amount, flexible duration/frequency

Wiederkehrende Zahlungen sind eine Reihe von Transaktionen, die gemäß einer Vereinbarung zwischen einem Karteninhaber und einem Händler erfolgen, wobei der Karteninhaber Waren oder Dienstleistungen über einen Zeitraum durch eine Anzahl separater Transaktionen kauft. Beachten Sie bitte, das im Kontext von PSD2 und SCA die Anforderungen der Europäischen Bankenaufsichtsbehörde (EBA) wiederkehrende Zahlungen als eine Reihe von Transaktionen mit dem gleichen Betrag und dem gleichen Zahlungsempfänger beschreiben.

In Verbindung mit useCase (optional):

useCase (optional)Beschreibung
absentStandard Anwendungsfall für wiederkehrende Zahlungen (Abonnement)
fixedWiederkehrende Zahlungen (Abonnement) mit festen Betrag und fester Laufzeit/Frequenz
flexibleAmountWiederkehrende Zahlungen (Abonnement) mit variablem Betrag und fester Laufzeit/Frequenz
flexibleFrequencyWiederkehrende Zahlungen (Abonnement) mit festen Betrag und variabler Laufzeit/Frequenz
2

unscheduled

string

C

Value indicating the party that initiates a credential on file transaction that does not occur on a fixed schedule.

unscheduledDescription
CITCustomer Initiated Transaction
MITMerchant Initiated Transaction

In conjunction with useCase (optional):

useCase (optional)Description
absent

Standard unscheduled use case

cofCredential On File / One-Click
ucof

Wert, der die Partei angbit, welche eine Transaktion mit hinterlegten Zahlungsdaten auslöst, die nicht nach einem festen Zeitplan erfolgt.

unscheduledBeschreibung
CITVom Kunden ausgelöste Transaktion
MITVom Händler ausgelöste Transaktion

In Verbindung mit useCase (optional):

useCase (optional)Description
absent

Standard Anwendungsfall

cofCredential On File / One-Click
ucof

Anchor
recurring
recurring
recurring

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1638289138680_-1291217770
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamerecurring
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1638289138682_1795512083
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

KeyFormatCNDDescriptionBeschreibung
1

recurringFrequency

integer

M

Indicates the number of days between authorisations

Gibt die Anzahl der Tage zwischen den Autorisierungen an
2

recurringStartDate

string

O

Determines the date of the first authorization according to the recurring mandate

Bestimmt das Datum der ersten Autorisierung gemäß dem wiederkehrenden Mandat
3

recurringExpiryDate

string

M

Date after which no further authorisations shall be performed

Datum, nach dem keine weiteren Autorisierungen mehr ausgeführt werden sollen

Schema

(info) BASEURL=

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
schemas

Multiexcerpt
MultiExcerptNameschema
Code Block
languagejson
linenumberstrue
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://www.computop-paygate.com/schemas/credentialOnFile.json",
  "title": "credentialOnFile",
  "description": "Credential-on-File Transactions",
  "type": "object",
  "examples": [
    {
      "type": {
        "recurring": {
          "recurringFrequency": 30,
          "recurringStartDate": "2019-09-14",
          "recurringExpiryDate": "2020-09-14"
        }
      },
      "initialPayment": true
    },
    {
      "type": {
        "recurring": {
          "recurringFrequency": 30,
          "recurringStartDate": "2021-09-14",
          "recurringExpiryDate": "9999-12-31",
          "total": 24,
          "curIdx": 5,
          "cumulativeAmount": 12000
        }
      },
      "initialPayment": false
    },
    {
      "type": {
        "unscheduled": "CIT"
      },
      "initialPayment": false
    },
    {
      "type": {
        "unscheduled": "CIT"
      },
      "initialPayment": true,
      "useCase":"cof"
    },
    {
      "type": {
        "installments": {
          "total": 8,
          "curIdx": 2,
          "purchaseAmount": 800000,
          "frequency": 30,
          "expiryDate": "2020-09-30"
        }
      },
      "initialPayment": false
    },
    {
      "type": {
        "installments": {
          "total": 8,
          "curIdx": 2,
          "purchaseAmount": 800000,
          "frequency": 30,
          "expiryDate": "2020-09-30"
        }
      },
      "initialPayment": false,
      "useCase":"fixed"
    }
  ],
  "properties": {
    "type": {
      "type": "object",
      "properties": {
        "recurring": {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 1,
              "maximum": 99,
              "description": "Total number of recurring payments."
            },
            "curIdx": {
              "type": "integer",
              "minimum": 1,
              "maximum": 99,
              "description": "Current sequence number of recurring payments of the same subscription agreement."
            },
            "purchaseAmount": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999999999,
              "description": "Total amount for the subscription agreement if known, single recurring/subscription payment in API-amount."
            },
            "cumulativeAmount": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999999999,
              "description": "Cumulative amount paid so far for this subscription agreement. Credits/refunds do not reduce this amount."
            },
            "recurringFrequency": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "description": "Indicates the minimum number of days between recurring authorizations."
            },
            "recurringStartDate": {
              "type": "string",
              "format": "full-date",
              "description": "YYYY-MM-DD"
            },
            "recurringExpiryDate": {
              "type": "string",
              "format": "full-date",
              "description": "Date of subscription expiry in format YYYY-MM-DD. Use 9999-12-31 if not specified."
            }
          },
          "required": [
            "recurringExpiryDate",
            "recurringFrequency"
          ],
          "additionalProperties": false
        },
        "installments": {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 1,
              "maximum": 99,
              "description": "Total number of installment payments."
            },
            "curIdx": {
              "type": "integer",
              "minimum": 1,
              "maximum": 99,
              "description": "Current sequence number of installment payments."
            },
            "purchaseAmount": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999999999,
              "description": "Total amount for installment payment; single installment payment in API-amount."
            },
            "cumulativeAmount": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999999999,
              "description": "Cumulative amount paid by installments so far. Credits/refunds do not reduce this amount."
            },
            "frequency": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9999,
              "description": "Indicates the minimum number of days between installments authorizations."
            },
            "expiryDate": {
              "type": "string",
              "format": "full-date",
              "description": "YYYY-MM-DD"
            }
          },
          "required": [
            "total",
            "purchaseAmount"
          ],
          "additionalProperties": false
        },
        "unscheduled": {
          "type": "string",
          "enum": [
            "CIT",
            "MIT"
          ],
          "description": "CIT: Customer initiated transactions; MIT: Merchant initiated transactions."
        }
      },
      "oneOf": [
        {
          "required": [
            "recurring"
          ]
        },
        {
          "required": [
            "installments"
          ]
        },
        {
          "required": [
            "unscheduled"
          ]
        }
      ],
      "additionalProperties": false
    },
    "initialPayment": {
      "type": "boolean"
    },
    "useCase": {
        "type": "string",
        "enum" : ["cof", "ucof", "fixed", "flexibleAmount", "flexibleFrequency"],
        "description": "Type of useCase (unscheduled: cof, ucof // recurring: fixed, flexibleAmount, flexibleFrequency)"
   }
  },
  "required": [
    "type",
    "initialPayment"
  ],
  "additionalProperties": false
}

Sample Recurring

Multiexcerpt
MultiExcerptNamesample_recurring
Code Block
languagejson
linenumberstrue
{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": true
}
Code Block
languagejson
linenumberstrue
{
    "type": {
        "recurring": {
            "recurringFrequency": 30,
            "recurringStartDate": "2019-09-14",
            "recurringExpiryDate": "2020-09-14"
        }
    },
    "initialPayment": true,
     "useCase": "fixed" 
}

Sample Unscheduled CIT

Multiexcerpt
MultiExcerptNamesample_unscheduled_cit
Code Block
languagejson
linenumberstrue
{
    "type": {
        "unscheduled": "CIT"
    },
    "initialPayment": false
}
Code Block
languagejson
linenumberstrue
{
    "type": {
        "unscheduled": "CIT"
    },
    "initialPayment": false, 
    "useCase": "cof"
}

Table of Contents