Table of Contents

About Gothia PayByBill

General information about PayByBill

With PayByBill from the Gothia Financial Group you can offer your customers popular methods of payment such as direct debit, purchase on invoice or flexible hire purchase. PayByBill enables merchants to send their own invoice. At the same time merchants will receive payments. PayByBill takes care of the debt collection.

Page properties

Logo

Info

Excerpt
PayByBill enables merchants to offer payment methods such as invoice purchasing, financing and direct debit. The solution offers merchants a payment guarantee and is available for Denmark, Germany, Finland, the Netherlands, Norway and Sweden.

Type

Payments by Cash-In / Bill

Further information can be found on the webpage of PayByBill (www.paybybill.com/de).

Process flow charts

Multiexcerpt

MultiExcerptName	ProcessFlow

draw.io Diagram

border	true
diagramName	PayByBill_CT
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1109

Process flow PayByBill

Multiexcerpt

MultiExcerptName	ProcessFlow_Installment

draw.io Diagram

border	true
diagramName	PayByBill_Installment_CT
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1109

Process flow PayByBill installment payment

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

PayByBill purchase on invoice and hire purchase

This chapter describes how to reserve a PayByBill payment. Following successful reservation you can capture PayByBill payments or if necessary credit them. Merchants can also cancel PayByBill reservations.

In order to execute a PayByBill payment via server-to-server communication, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

paybybill.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661490737286_-840347001
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	paybybill_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661490737287_827803962
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Key

Format

CND

Description

Beschreibung

PayType

ans..16

M

Payment type: “Invoice” or “DirectDebet”. “DirectDebet” is permitted in Germany only. In case of hire purchase via Germany only ‘DirectDebet’ is allowed.

Zahlungsart: “Invoice” für Rechnung oder “DirectDebet” für Lastschrift. „DirectDebet“ nur für Deutschland erlaubt. Bei Ratenkauf über Deutschland nur „DirectDebet“ erlaubt.

FirstName

ans..30

M

First name of the custumer

Vorname des Kunden

LastName

ans..30

M

Last name of the customer or company name

Nachname des Kunden oder Firmenname

AddrStreet

ans..128

M

Customer’s street

Straße des Kunden

AddrHouseNr

ans..5

O

Customer’s street number

Hausnummer des Kunden

AddrZipCode

ans..15

M

Postcode of the customer

Postleitzahl des Kunden

AddrCity

ans..30

M

Customer’s place of residence

Wohnort des Kunden

AddrCountryCode

a2

M

Country code of the customer's residence, 2 characters according to ISO 3166

Ländercode des Wohnortes, zweistellig gemäß ISO 3166

BirthDate

ans..10

OC

Obligatory if AddrCountryCode=DE: Date of birth in the format YYYY-MM-DD

Pflicht, falls AddrCountryCode=DE: Geburtsdatum im Format JJJJ-MM-TT

SocialSecurityNumber

ans..20

OC

Obligatory if AddrCountryCode=DE: Social security number if CompanyOrPerson=P. Register of Companies number if CompanyOrPerson=C.

Country-specific formats

SE: DDMMYYNNNN

NO: DDMMYYNNNNN

DK: DDMMYY-NNNN

FI: DDMMYY-NNNN

NL: DDMMYYYY

Pflicht, falls AddrCountryCode ungleich DE. Sozialversicherungsnummer, falls CompanyOrPerson=P. Handelsregisternummer, falls CompanyOrPerson=C.

Länderspezifische Formate

SE: DDMMYYNNNN

NO: DDMMYYNNNNN

DK: DDMMYY-NNNN

FI: DDMMYY-NNNN

NL: DDMMYYYY

Email

ans..100

M

Email address of the customer

E-Mail-Adresse des Kunden

Phone

ans..20

O

Customer’s phone number

Telefonnummer des Kunden

MobileNo

ans..16

O

Customer’s mobile telephone number

Mobiltelefonnummer des Kunden

AccIBAN

n8

OC

Obligatory if PayType=DirectDebet: Identification of the financial institution of the account holder

Pflicht, falls PayType=DirectDebet: Identifikation des Finanzinstituts des Kontoinhabers

AccNr

n..11

OC

Obligatory if PayType=DirectDebet: account holder’s account number

Pflicht, falls PayType=DirectDebet; Kontonummer des Kontoinhabers

CustomerID

ans..50

M

Customer number at the merchant

Kundennummer beim Händler

CompanyOrPerson

a1

O

P=Person (standard), C=Company

P=Person (Standard), C=Company

Salutation

ans..10

O

Salutation – ‘Mr’, ‘Mrs’, ‘Miss’

Anrede – “Mr”, “Mrs”, “Miss”

Title

ans..20

O

Title, e.g. Dr. or Prof.

Titel z.B. Dr. oder Prof.

DistributionType

ans..8

O

Method of dispatch of the invoice: ‘paper’ or by ‘email’

Auslieferungsart der Rechnung: „Papier“ oder per „E-Mail“

DistributionBy

ans..8

O

Sender of the printed invoice. ‘Company’ for Gothia; ‘Client’ if the merchant is the sender.

Auslieferer der gedruckten Rechnung. „Company“ für Gothia; „Client“, wenn der Händler selbst der Auslieferer ist.

In case of hire purchase

bei Ratenkauf

EventToken

a2

M

1. call: “IP” for Instalment Purchase (to request the terms & conditions and AcceptID)

2. call: “AT” for AcceptAccountTermsAndConditions (to confirm the terms & conditions)

1. Aufruf: „IP“ für Installment Purchase (zur Anforderung der AGB und AcceptID)

2 Aufruf: „AT“ für AcceptAccountTermsAndConditions (zur Bestätigung der AGB)

Month

n..2

M

Number of instalments

Anzahl der Raten

ProductNr

ans..4

O

Account profile number, as configured with Gothia, e.g. ‘1’

Account-Profilnummer, wie bei Gothia konfiguriert, z.B. „1“

PayID

an32

OC

Obligatory on second call:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

ID for the identification of a payment

bei zweitem Aufruf Pflicht: ID des

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Platform-Kurz
PageWithExcerpt	DE:Wording

zur Identifizierung einer Zahlung

Parameters for payments with PayByBill

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661492034076_-2044679091
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	paybybill_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661492034078_1366861904
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key	Format	CND	Description	Beschreibung
Status	a..50	M	OK (URLSuccess) or FAILED (URLFailure), AUTHORIZE_REQUEST on first call with EventToken=IP	OK (URLSuccess) oder FAILED (URLFailure), AUTHORIZE_REQUEST beim ersten Aufruf mit EventToken=IP

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Key

Format

CND

Description

Beschreibung

CodeExt

n..10

O

Error code from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlercode von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

ErrorText

ans..1024256

O

Error text from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlertext von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

InstallmentData

ans..1024

O

Installment plan

InstallmentData=<Month>;<PaymentAmount>;

<CapitalBalance>;<Fees>;<Interest>+ <Month>;<PaymentAmount>; …

Ratenplan

InstallmentData=<Monat>;<Zahlungsbetrag>;

<Kapitalbalance>;<Gebühren>;<Zinsen>+ <Monat>;<Zahlungsbetrag>;…

TermsAndConditions

ans..1024

O

Terms & conditions for payment by instalment

AGBs für die Ratenzahlung

FirstName

ans..128

O

First name

Vorname

LastName

ans..128

O

Last name

Nachname

AddrStreet

ans..255

O

Street and street number in the delivery address

Straße und Hausnummer der Lieferadresse

AddrZip

ans..20

O

Postcode in the delivery address

Postleitzahl der Lieferadresse

AddrCity

ans..50

O

Town/city in the delivery address

Ortsname der Lieferadresse

InvoiceText

ans..1024

O

Access data for the instalment payment portal and the minimum instalment amount for the product plus invoice information.

Example:

InvoiceText=<minimum rate amount>;<Text>;<account number>;<password>;<LogonText>;<OCR number>

Zugangsdaten für das Ratenzahlungsvereinbarungsportal sowie die minimale Ratenhöhe des Produkts, sowie Rechnungsinformationen.

Beispiel:

InvoiceText=<minimale Ratenhöhe>;<Text>;<Kontonummer>;<Passwort>;<LogonText>;<OCR-Nummer>

Result parameters for PayByBill payments

Capture

Captures are possible via a Server-to-Server connection. To settle an invoice / carry out dispatch by PayByBill, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

capture.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661371510340_56532525
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	capture_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661371510342_-1946407383
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID_Capture
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Key	Format	CND	Description	Beschreibung
InvoiceNr	ans..16	M	unique reference number	eindeutige Rechnungsnummer
ProductNr	ans..4	O	Account profile number, as configured with Gothia, e.g. ‘1’	Rechnungsprofilnummer, wie bei Gothia konfiguriert; z.B. „1“.
ArticleList	ans..1024	M	Article list with description of items and prices: <Article number> ;<quantity> ;<article description> ;<net price> ;<gross price> ;<VAT> ;<tax rate>; <unit> <;> separates the fields of an article data set <+> separates the article data sets Data type (size): Article number (ans..100) Quantity (n..3) Article description (ans..100) Net amount (n..10) in the smallest currency unit (e.g. EUR Cent) Gross amount (n..10) in the smallest currency unit (e.g. EUR Cent) VAT amount (n..10) in the smallest currency unit (e.g. EUR Cent) VAT rate (n..2), e.g. 19 for 19% unit (ans..50), e.g. kg for kilogram, or l for litre	Artikelliste mit Beschreibung der Waren und Preise: < Artikelnummer >;<Anzahl>;<Artikelbeschreibung>; <Nettopreis>;<Bruttopreis>;<MwSt>;<Steuersatz>;<Maßeinheit> <;> trennt Felder innerhalb eines Artikeldatensatzes <+> trennt mehrere Artikeldatensätze Datentyp (Größe): Artikelnummer (ans..100) Anzahl (n..3) Artikelbeschreibung (ans..100) Nettopreis (n..12) in der kleinsten Währungseinheit (z.B. EUR Cent) Bruttopreis (n..12) in der kleinsten Währungseinheit (z.B. EUR Cent) MwSt. (n..12) in der kleinsten Währungseinheit (z.B. EUR Cent) Steuersatz (n..2), z.B. „19“ für 19%) Maßeinheit (ans..50), z.B. st für Stück, kg für Kilogramm oder l für Liter
BDStreet	ans..100	M	Street name in the invoicing address	Straßenname in der Rechnungsadresse
BDHouseNr	ans..5	O	Street number in the invoicing address	Hausnummer in der Rechnungsadresse
BDCity	ans..100	M	Town/city in the invoicing address	Ort in der Rechnungsadresse
BDCountryCode	a2	M	Country code for the invoicing address, 2 characters according to ISO 3166	Ländercode in der Rechnungsadresse, zweistellig gemäß ISO 3166
BDZipCode	ans..8	M	Postcode in the invoicing address	Postleitzahl in der Rechnungsadresse
DueDate	n8	O	Due date in the format DDMMYYYY	Fälligkeitsdatum im Format TTMMJJJJ
InvoiceDate	n8	O	Invoice date in the format DDMMYYYY:	Rechnungsdatum im Format TTMMJJJJ
TxAmount	n..10	O	Tax amount of the entire order in the smallest currency unit (e.g. EUR Cent). 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 wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
NetAmount	n..10	O	Net amount in the smallest currency unit (e.g. EUR Cent) Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).	Nettobetrag 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.

Parameters for PayByBill captures

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661372592112_-739284770
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	capture_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661372592115_630237050
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Reference

ans..16

O

Reference number for PayByBill (OCR number)

Referenznummer für PayByBill (OCR-Nummer)

DocumentLink

ans..1024

O

Link to PDF document of the invoice

Link zum PDF-Dokument der Rechnung

InvoiceText

ans..1024

O

Access data for the instalment payment portal and the minimum instalment amount for the product plus invoice information.

Example:

InvoiceText=<minimum rate amount>;<Text>;<account number>;<password>;<LogonText>;<OCR number>

Zugangsdaten für das Ratenzahlungsvereinbarungsportal sowie die minimale Ratenhöhe des Produkts, sowie Rechnungsinformationen.

Beispiel:

InvoiceText=<minimale Ratenhöhe>;<Text>;<Kontonummer>;<Passwort>;<LogonText>;<OCR-Nummer>

File

ans..1024

O

Instalment payment contract as PDF document: Base64 encrypted data string

Ratenzahlungsvertrag als PDF-Dokument: Base64-codierter Datenstring

CodeExt

n..10

O

Error code from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlercode von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

ErrorText

ans..256

O

Error text from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlertext von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

Result parameters for PayByBill captures

Credit with reference and partial credit

Credits (refunds) are possible via a Server-to-Server connection. For a Credit with reference to a capture the amount of the Credit is limited to the amount of the previous capture. To carry out a

credit

with a reference transaction (returns via PayByBill), please use the following URL:

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName
BaseURL
Credit_Intro
PageWithExcerpt Reuse API
credit.aspx
Wording
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName BaseURL
PageWithExcerpt Wording
credit.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661373515763_1625551061
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661373515767_1789096905
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID_Credit
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Key	Format	CND	Description	Beschreibung
InvoiceNr	ans..16	M	Number of invoice as reference for the refund	Nummer der Rechnung, auf die sich die Gutschrift bezieht
ArticleList	ans..1024	M	Article list with description of items and prices: <Article number> ;<quantity> ;<article description> ;<net price> ;<gross price> ;<VAT> ;<tax rate>; <unit> <;> separates the fields of an article data set <+> separates the article data sets Data type (size): Article number (ans..100) Quantity (n..3) Article description (ans..100) Net amount (n..10) in the smallest currency unit (e.g. EUR Cent) Gross amount (n..10) in the smallest currency unit (e.g. EUR Cent) VAT amount (n..10) in the smallest currency unit (e.g. EUR Cent) VAT rate (n..2), e.g. 19 for 19% unit (ans..50), e.g. kg for kilogram, or l for litre	Artikelliste mit Beschreibung der Waren und Preise: < Artikelnummer >;<Anzahl>;<Artikelbeschreibung>; <Nettopreis>;<Bruttopreis>;<MwSt>;<Steuersatz>;<Maßeinheit> <;> trennt Felder innerhalb eines Artikeldatensatzes <+> trennt mehrere Artikeldatensätze Datentyp (Größe): Artikelnummer (ans..100) Anzahl (n..3) Artikelbeschreibung (ans..100) Nettopreis (n..12) in der kleinsten Währungseinheit (z.B. EUR Cent) Bruttopreis (n..12) in der kleinsten Währungseinheit (z.B. EUR Cent) MwSt. (n..12) in der kleinsten Währungseinheit (z.B. EUR Cent) Steuersatz (n..2), z.B. „19“ für 19%) Maßeinheit (ans..50), z.B. st für Stück, kg für Kilogramm oder l für Liter
TxAmount	n..10	O	Tax amount of the entire order in the smallest currency unit (e.g. EUR Cent). 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 wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
NetAmount	n..10	O	Net amount in the smallest currency unit (e.g. EUR Cent) Please contact the helpdesk, if you want to capture amounts < 100 (smallest currency unit).	Nettobetrag 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.

Parameters for PayByBill credits

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661374186507_2040015657
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661374186510_-1033805824
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

Reference

ans..16

O

Reference number for PayByBill

Referenznummer für PayByBill

CodeExt

n..10

O

Error code from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlercode von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

ErrorText

ans..256

O

Error text from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlertext von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

Result parameters for PayByBill credits

Reversal and Updating

To reverse a payment with PayByBill, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

reverse.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661374396644_1717209595
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	reverse_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661374396647_1913982407
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID_Reverse
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Parameters for reversals of PayByBill payments

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661376366214_830290949
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	reverse_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661376366216_-1973134797
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Key

Format

CND

Description

Beschreibung

CodeExt

n..10

O

Error code from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlercode von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

ErrorText

ans..256

O

Error text from PayByBill, if agreed with

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	Wording

Fehlertext von PayByBill, wenn mit

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Helpdesk-Name
PageWithExcerpt	DE:Wording

abgesprochen

Result parameters for PayByBill reversals

Batch processing via the interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Intro
PageWithExcerpt	Reuse API

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 PayByBill payment and which information can be found within the response file about the payment status. You can only cancel in full.

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

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661353208752_474723497
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_versions

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661353208754_-1278065342
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Action	Version	Description	Beschreibung
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 PayByBill payment within a Batch file to be submitted is the following:

Multiexcerpt

MultiExcerptName	batch_structure
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
PayByBill,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

Multiexcerpt

MultiExcerptName	batch_MasterMid
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Request_Intro
PageWithExcerpt	Reuse API

The following table describes the individual fields and values used within the data set (record) in the batch file:

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661353412024_-1006177078
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661353412026_362935994
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key	Format	CND	Description	Beschreibung
Type	a..11	M	HEAD for Header, FOOT for Footer, PayByBill for PayByBill	HEAD für Header, FOOT für Footer, PayByBill für PayByBill
Action	a..20	M	The parameter Action defines the type of transaction: Reverse (cancellation)	Der Action-Parameter definiert die Art der Transaktion: Reverse (Storno)

Table Excerpt Include

name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr
page	refnr
type	page

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks the following way:

Multiexcerpt

MultiExcerptName	batch_structure_response
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Response_Intro
PageWithExcerpt	Reuse API

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):

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1661354104443_219603824
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1661354104446_463893176
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

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

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Description of result parameters within the record for Batch files

Space shortcuts

Page tree

Versions Compared

Old Version 3

New Version Current

Key

About Gothia PayByBill

General information about PayByBill

Process flow charts

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

PayByBill purchase on invoice and hire purchase

Capture

Credit with reference and partial credit

credit

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName
BaseURL
Credit_Intro
PageWithExcerpt Reuse API
credit.aspx
Wording
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName BaseURL
PageWithExcerpt Wording
credit.aspx

Reversal and Updating

Batch processing via the interface

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 3

New Version Current

Key

About Gothia PayByBill

General information about PayByBill

Process flow charts

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

PayByBill purchase on invoice and hire purchase

Capture

Credit with reference and partial credit

credit

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNameBaseURLCredit_IntroPageWithExcerptReuse APIcredit.aspxWording Multiexcerpt includeSpaceWithExcerptENMultiExcerptNameBaseURLPageWithExcerptWordingcredit.aspx

Reversal and Updating

Batch processing via the interface

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName
BaseURL
Credit_Intro
PageWithExcerpt Reuse API
credit.aspx
Wording
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName BaseURL
PageWithExcerpt Wording
credit.aspx