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
Table of Contents


About Be2bill

General information about Be2bill

With the connection of the French acquirer be2bill, merchants who are active in France have a powerful alternative for the selection of acquirer. As well as VISA and Mastercard credit cards, 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
also handles payments made with the extremely widespread Cartes Bancaires via this partner. Be2bill offers online merchants a “3-in-1” solution for the management of its online payments including bank and payment services, internet-based marketing and solutions for increasing customer loyalty.

Credit card payments via be2bill can be made with or without 3D-Secure. For 3DS transactions, be2bill offers its own fraud prevention service which determines whether 3D authentication is needed. Along with one-off payments, be2bill also offers payment by instalment, recurring payments and one-click payments.


Page properties
Logo

Info
Excerpt

Be2bill is specially optimized for the “Cartes Bancaires” credit cards which is widely used in France.

TypePayments by Credit Card
Multiexcerpt
MultiExcerptNameCard Scheme
Card Scheme
VISA
MasterCard
Cartes Bancaires


Process flow charts

Multiexcerpt
MultiExcerptNameSequenceDiagram form

draw.io Diagram
bordertrue
diagramNameProcess flow form CT
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1109

Be2bill process flow via the form interface


Multiexcerpt
MultiExcerptNameSequenceDiagram S2S


draw.io Diagram
bordertrue
diagramNameProcess flow S2S CT
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1109

Be2bill process flow via server-to-server-communication



Configuration for Be2bill

To set up Be2bill the merchant needs to save the required 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
interface URLs in the backend. Each of these is a “Transaction feedback URL”:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
Be2billComplete.aspx

and for “Redirection URL after payment form or 3DSECURE processing” and “Redireciton URL after payment form cancelling” respectively:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
cbBe2bill.aspx



Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
interface

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameDefinition
PageWithExcerptDefinition EN


Credit card payment with Be2bill via 
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
form interface

Payments with Be2bill are made via the standard 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
form interface for credit card payments. In order to execute an SSL credit card payment with Be2bill via a 
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
form, visit the following URL:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
payssl.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Key

Format

CND

Description

Beschreibung

RefNr

ans..30

M

Unique reference number. The RefNr is submitted together with the PayID and separated by | to Be2bill within the parameter ExtraData: PayID|RefNr.Eindeutige Referenznummer. Die RefNr wird durch ein | getrennt mit der PayID an Be2bill im Parameter ExtraData übergeben: PayID|RefNr.

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
statictrue
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
statictrue
nameResponse
pageResponse
typepage

Table Excerpt Include
statictrue
nameURLNotify
pageURLNotify
typepage

Key

Format

CND

Description

Beschreibung

CreditCardHolder

an..255

M

Name of the card holder
Name des Karteninhabers

Table Excerpt Include
statictrue
nameCapture
pageCapture
typepage

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..768

M

Description of purchased goods, unit prices etc.
Beschreibung der gekauften Waren, Einzelpreise usw.

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Key

Format

CND

Description

Beschreibung

Language

a2

O

Language: FR / EN / DE / ES / IT / NL / CN / RU / PT / CZ
Sprache: FR / EN / DE / ES / IT / NL / CN / RU / PT / CZ
CustomerIDans..255MUnique ID of card holder on the merchant's webpage (e.g. the ID inside the customer database or the email address of the customer)Eindeutige ID des Karteninhabers auf der Händlerwebseite (z.B. die ID in der Kundendatenbank oder die E-Mail-Adresse des Kunden)
Emailans..255MEmail address of the card holderE-Mail-Adresse des Karteninhabers
ChDescans..255OSource URL of the merchant or the shop systemUrsprungs-URL des Händlers bzw. des Shopsystems
DateOfBirthdttm10ODate of birth of the card holder: YYYY-MM-DDGeburtsdatum des Karteninhaber: JJJJ-MM-TT
InstallmentAmountans..1024O

Amount of single instalments.

The rate values are to be separated by comma and the first rate must have the highest value. e.g.: 200,100,100

Betrag einzelner Raten.

Die Raten sind durch ein Komma zu trennen, und die erste Rate muss den höchsten Betrag aufweisen. Z.B.: 200,100,100

InstallmentDateans..1024C

In combination with InstallmentAmount:

Date when the rates are to be collected.

The date details must be comma-separated and specified in the UTC time zone (coordinated universal time). The time period from the first instalment to the last instalment also needs to be within a maximum 90 days.

e.g.: YYYY-MM-DD,YYYY-MM-DD,YYYY-MM-DD

In Verbindung mit InstallmentAmount:

Datum wann die Raten eingezogen werden sollen.

Die Datumsangaben sind durch ein Komma zu trennen und in der Zeitzone UTC (koordinierte Weltzeit) anzugeben. Außerdem muss der Zeitraum von der ersten Rate bis zur letzten angegebenen Rate innerhalb von maximal 90 Tagen liegen.

Z.B.: YYYY-MM-DD,YYYY-MM-DD,YYYY-MM-DD

UserAgentans..128OBrowser type of the purchaser who requests the page. For example: IE Mozilla/4. 0 (compatible; MSIE 6.0; Windows NT 5.0; NET CLR 1.0.3705)Browsertyp des Käufers, der die Seite aufruft. Zum Beispiel: IE Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; .NET CLR 1.0.3705)

Table Excerpt Include
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

Key

Format

CND

Description

Beschreibung



Delivery addressLieferadresse

sdFirstName

as..15

O

First name in the delivery address

Vorname in der Lieferadresse

sdLastName

as..30

O

Last name in the delivery address

Nachname in der Lieferadresse

sdStreet

ans..50

O

Number and street in the delivery address

Straße und Hausnummer in der Lieferadresse

sdZIP

ans..9

O

Postcode in the delivery address

Postleitzahl in der Lieferadresse

sdCity

ans..255

O

Town/city in the delivery address

Wohnort in der Lieferadresse

sdCountryCode

a..3

O

Country code in the delivery address, 2 or 3 characters according to ISO 3166

Ländercode der Lieferadresse zwei- oder dreistellig gemäß ISO 3166

sdPhone

ans..32

O

Telephone number in the delivery address

Telefonnummer in der Lieferadresse



Invoicing addressRechnungsadresse

bdFirstName

as..15

O

First name in the invoicing address

Vorname in der Rechnungsadresse

bdLastName

as..30

O

Last name in the invoicing address

Nachname in der Rechnungsadresse

bdStreet

ans..50

O

Number and street in the invoicing address

Straße und Hausnummer in der Rechnungsadresse

bdZIP

ans..9

O

Postcode in the invoicing address

Postleitzahl in der Rechnungsadresse

bdCity

ans..255

O

Town/city in the invoicing address

Wohnort in der Rechnungsadresse

bdCountryCode

a..3

O

Country code in the invoicing address, 2 or 3 characters according to ISO 3166

Ländercode der Rechnungsadresse zwei- oder dreistellig gemäß ISO 3166

bdPhone

ans..32

O

Phone number in the billing address

Telefonnummer in der Rechnungsadresse



SubscriptionsAbonnements

RTF

a1

O

For recurring payments:

I = Initial payment of a new subscription
R = Routine payment (Recurring)

Bei wiederkehrenden Zahlungen:

I = Initialzahlung eines neuen Abos
R = Wiederkehrende Zahlung (Recurring)

TokenExt

an..32

OC

In connection with RTF=R TokenExt must be transmitted for referencing the credit card data

In Verbindung mit RTF=R muss TokenExt übergeben werden, um die Kreditkartendaten zu referenzieren



Fraud prevention (please notice also the further optional parameters and response values for Fraud prevention)Betrugsprävention (beachten Sie bitte auch die weiteren optionalen Parameter und Rückgabewerte zur Betrugsprävention)
IPAddrans..15M

IP address. With this parameter 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
can determine in which country and in which town your customer has connected with the Internet (see also IPZone). Format: 123.456.789.012

IP-Adresse. Damit kann das 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
ermitteln, in welchem Land und welcher Stadt Ihr Kunde mit dem Internet verbunden ist (vgl. IPZone). Format 123.456.789.012

Parameters for credit card payments with Be2bill


To adapt the layout of the SSL-page to your shop you can use the following unencrypted parameters to configure colours, fonts and images.

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

Table Excerpt Include
statictrue
nameTemplate
pageTemplate
typepage

Table Excerpt Include
statictrue
nameBackground
pageBackground
typepage

Table Excerpt Include
statictrue
nameBGColor
pageBGColor
typepage

Table Excerpt Include
statictrue
nameBGImage
pageBGImage
typepage

Table Excerpt Include
statictrue
nameFColor
pageFColor
typepage

Table Excerpt Include
statictrue
nameFFace
pageFFace
typepage

Table Excerpt Include
statictrue
nameFSize
pageFSize
typepage

Key

Format

CND

Description

Beschreibung

Language

a2

(enum)

M

Language code: <de> German, <al> Albanian, <at> Austrian, <cz/cs> Czech, <dk> Danish, <en> English, <fi> Finish, <fr> French, <gr> Greek, <hu> Hungarian, <it> Italian, <jp> Japanese,  <nl> Dutch, <no> Norwegian, <pl> Polish, <pt> Portuguese, <ro> Romanian, <ru> Russian, <sp> Spanish, <se> Swedish, <sk> Slovakian, <sl> Slovenian, <tr> Turkey, <zh> Simplified Chinese.

No details means the language is German.

Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <tr> türkisch, <sp> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese

Ohne Angabe ist die Sprache Deutsch.

CCSelect

a..10

M

Determines preselected card type in the form: VISA, MasterCard, AMEX, DINERS, JCB, CBN, Hipercard, Elo, Aura, Dankort, Airplus, ComfortCard, CUP

Bestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard, AMEX, DINERS, JCB, CBN, Hipercard, Elo, Aura, Dankort, Airplus, ComfortCard, CUP

Table Excerpt Include
statictrue
nameURLBack
pageURLBack
typepage

Table Excerpt Include
statictrue
nameCenter
pageCenter
typepage

Table Excerpt Include
statictrue
nametWidth
pagetWidth
typepage

Table Excerpt Include
statictrue
nametHeight
pagetHeight
typepage

Layout parameters for 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
forms for credit card payments with Be2bill


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Key

Format

CND

Description

Beschreibung

PayID

an32

M

ID assigned by 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
for the payment, e.g. for referencing in batch files

The PayID is submitted together with the RefNr and separated by | to Be2bill within the parameter ExtraData: PayID|RefNr.

Vom 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien.

Die PayID wird durch ein | getrennt mit der RefNr an Be2bill im Parameter ExtraData übergeben: PayID|RefNr.

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameStatus_OK_AUTHORIZE_REQUEST
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Key

Format

CND

Description

Beschreibung

RefNr

ans..30

O

Unique reference number. The RefNr is submitted together with the PayID and separated by | to Be2bill within the parameter ExtraData: PayID|RefNr.Eindeutige Referenznummer. Die RefNr wird durch ein | getrennt mit der PayID an Be2bill im Parameter ExtraData übergeben: PayID|RefNr.

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Key

Format

CND

Description

Beschreibung

ErrorText

ans..128

O

Detailed Be2bill error message.

Notice: Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
.

Detaillierte Be2bill Fehlermeldung.

Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptDE:Wording
möglich.

Table Excerpt Include
statictrue
namePCNr
pagePCNr
typepage

Key

Format

CND

Description

Beschreibung
CCBranda..22OIn combination with PCNr: Name of credit card brand, e.g. Visa, MasterCard, Cartes BancairesIn Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, Cartes Bancaires
CCExpiryn6OIn combination with PCNr: Expiry date of the credit card in the format YYYYMM.In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM
TokenExtan..32OFor recurring payments (RTF=I) the TokenExt is transmitted for referencing the credit card dataBei wiederkehrenden Zahlungen (RTF=I) wird der TokenExt übergeben, um die Kreditkartendaten zu referenzieren

TransactionID

an..32

O

Transaction ID from Be2bill

Transaktions-ID von Be2bill

Table Excerpt Include
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

Return parameters for URLSuccess, URLFailure and URLNotify with Be2bill



Credit card payment via Server-to-Server connection

In order to execute an SSL credit card payment with Be2bill via a server-to-server connection, call the following URL:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
direct.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Key

Format

CND

Description

Beschreibung

RefNr

ans..30

M

Unique reference number. The RefNr is submitted together with the PayID and separated by | to Be2bill within the parameter ExtraData: PayID|RefNr.Eindeutige Referenznummer. Die RefNr wird durch ein | getrennt mit der PayID an Be2bill im Parameter ExtraData übergeben: PayID|RefNr.

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameCapture
pageCapture
typepage

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..510

M

Description of purchased goods, unit prices etc.
Beschreibung der gekauften Waren, Einzelpreise usw.

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Key

Format

CND

Description

Beschreibung

CCNrn..19MCredit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN)Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer übergeben.
CCCVCn..4CCard verification number: The last 3 digits on the signature strip of the credit card. 4 characters in the case of AMEX. Optional if pseudo card number is used.Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei AMEX 4 Ziffern. Optional, wenn Pseudokartennummer genutzt wird.
CCExpiryn6MCredit card expiry date (YYYYMM), e.g. 202607blaufdatum der Kreditkarte (JJJJMM), z.B. 202607
CCBranda..22MCard type: VISA, MasterCard, Cartes Bancaires. Please note the spelling!Kartenmarke: VISA, MasterCard, Cartes Bancaires. Bitte beachten Sie die Schreibweise!

CreditCardHolder

an..255

M

Name of the card holder
Name des Karteninhabers

Key

Format

CND

Description

Beschreibung

Language

a2

O

Language: FR / EN / DE / ES / IT / NL / CN / RU / PT / CZ
Sprache: FR / EN / DE / ES / IT / NL / CN / RU / PT / CZ
CustomerIDans..255MUnique ID of card holder on the merchant's webpage (e.g. the ID inside the customer database or the email address of the customer)Eindeutige ID des Karteninhabers auf der Händlerwebseite (z.B. die ID in der Kundendatenbank oder die E-Mail-Adresse des Kunden)
Emailans..255MEmail address of the card holderE-Mail-Adresse des Karteninhabers
ChDescans..255OSource URL of the merchant or the shop systemUrsprungs-URL des Händlers bzw. des Shopsystems
DateOfBirthdttm10ODate of birth of the card holder: YYYY-MM-DDGeburtsdatum des Karteninhaber: JJJJ-MM-TT
InstallmentAmountans..1024O

Amount of single instalments.

The rate values are to be separated by comma and the first rate must have the highest value. e.g.: 200,100,100

Betrag einzelner Raten.

Die Raten sind durch ein Komma zu trennen, und die erste Rate muss den höchsten Betrag aufweisen. Z.B.: 200,100,100

InstallmentDateans..1024C

In combination with InstallmentAmount:

Date when the rates are to be collected.

The date details must be comma-separated and specified in the UTC time zone (coordinated universal time). The time period from the first instalment to the last instalment also needs to be within a maximum 90 days.

e.g.: YYYY-MM-DD,YYYY-MM-DD,YYYY-MM-DD

In Verbindung mit InstallmentAmount:

Datum wann die Raten eingezogen werden sollen.

Die Datumsangaben sind durch ein Komma zu trennen und in der Zeitzone UTC (koordinierte Weltzeit) anzugeben. Außerdem muss der Zeitraum von der ersten Rate bis zur letzten angegebenen Rate innerhalb von maximal 90 Tagen liegen.

Z.B.: YYYY-MM-DD,YYYY-MM-DD,YYYY-MM-DD

UserAgentans..128MBrowser type of the purchaser who requests the page. For example: IE Mozilla/4. 0 (compatible; MSIE 6.0; Windows NT 5.0; NET CLR 1.0.3705)Browsertyp des Käufers, der die Seite aufruft. Zum Beispiel: IE Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; .NET CLR 1.0.3705)

Key

Format

CND

Description

Beschreibung



Delivery addressLieferadresse

sdFirstName

as..15

O

First name in the delivery address

Vorname in der Lieferadresse

sdLastName

as..30

O

Last name in the delivery address

Nachname in der Lieferadresse

sdStreet

ans..50

O

Number and street in the delivery address

Straße und Hausnummer in der Lieferadresse

sdZIP

ans..9

O

Postcode in the delivery address

Postleitzahl in der Lieferadresse

sdCity

ans..255

O

Town/city in the delivery address

Wohnort in der Lieferadresse

sdCountryCode

a..3

O

Country code in the delivery address, 2 or 3 characters according to ISO 3166

Ländercode der Lieferadresse zwei- oder dreistellig gemäß ISO 3166

sdPhone

ans..32

O

Telephone number in the delivery address

Telefonnummer in der Lieferadresse



Invoicing addressRechnungsadresse

bdFirstName

as..15

O

First name in the invoicing address

Vorname in der Rechnungsadresse

bdLastName

as..30

O

Last name in the invoicing address

Nachname in der Rechnungsadresse

bdStreet

ans..50

O

Number and street in the invoicing address

Straße und Hausnummer in der Rechnungsadresse

bdZIP

ans..9

O

Postcode in the invoicing address

Postleitzahl in der Rechnungsadresse

bdCity

ans..255

O

Town/city in the invoicing address

Wohnort in der Rechnungsadresse

bdCountryCode

a..3

O

Country code in the invoicing address, 2 or 3 characters according to ISO 3166

Ländercode der Rechnungsadresse zwei- oder dreistellig gemäß ISO 3166

bdPhone

ans..32

O

Phone number in the billing address

Telefonnummer in der Rechnungsadresse



SubscriptionsAbonnements

RTF

a1

O

For recurring payments:

I = Initial payment of a new subscription
R = Routine payment (Recurring)

Bei wiederkehrenden Zahlungen:

I = Initialzahlung eines neuen Abos
R = Wiederkehrende Zahlung (Recurring)

TokenExt

an..32

OC

In connection with RTF=R TokenExt must be transmitted for referencing the credit card data

In Verbindung mit RTF=R muss TokenExt übergeben werden, um die Kreditkartendaten zu referenzieren



Fraud prevention (please notice also the further optional parameters and response values for Fraud prevention)Betrugsprävention (beachten Sie bitte auch die weiteren optionalen Parameter und Rückgabewerte zur Betrugsprävention)
IPAddrans..15M

IP address. With this parameter 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
can determine in which country and in which town your customer has connected with the Internet (see also IPZone). Format: 123.456.789.012

IP-Adresse. Damit kann das 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
ermitteln, in welchem Land und welcher Stadt Ihr Kunde mit dem Internet verbunden ist (vgl. IPZone). Format 123.456.789.012

Parameters for credit card payments with Be2bill via socket connection


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Key

Format

CND

Description

Beschreibung

PayID

an32

M

ID assigned by 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
for the payment, e.g. for referencing in batch files

The PayID is submitted together with the RefNr and separated by | to Be2bill within the parameter ExtraData: PayID|RefNr.

Vom 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien.

Die PayID wird durch ein | getrennt mit der RefNr an Be2bill im Parameter ExtraData übergeben: PayID|RefNr.

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameStatus_OK_AUTHORIZE_REQUEST
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Key

Format

CND

Description

Beschreibung

RefNr

ans..30

O

Unique reference number. The RefNr is submitted together with the PayID and separated by | to Be2bill within the parameter ExtraData: PayID|RefNr.Eindeutige Referenznummer. Die RefNr wird durch ein | getrennt mit der PayID an Be2bill im Parameter ExtraData übergeben: PayID|RefNr.

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Key

Format

CND

Description

Beschreibung

ErrorText

ans..128

O

Detailed Be2bill error message.

Notice: Is returned only if Status=FAILED. Use is possible only in agreement with

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording
.

Detaillierte Be2bill Fehlermeldung.

Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameHelpdesk-Name
PageWithExcerptDE:Wording
möglich.

Table Excerpt Include
statictrue
namePCNr
pagePCNr
typepage

Key

Format

CND

Description

Beschreibung
CCBranda..22OIn combination with PCNr: Name of credit card brand, e.g. Visa, MasterCard, Cartes BancairesIn Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, Cartes Bancaires
CCExpiryn6OIn combination with PCNr: Expiry date of the credit card in the format YYYYMM.In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM
TokenExtan..32OFor recurring payments (RTF=I) the TokenExt is transmitted for referencing the credit card dataBei wiederkehrenden Zahlungen (RTF=I) wird der TokenExt übergeben, um die Kreditkartendaten zu referenzieren

TransactionID

an..32

O

Transaction ID from Be2bill

Transaktions-ID von Be2bill

Results parameters for socket connection for Be2bill

 


Capture of a credit card payment with Be2bill

Captures are possible via a Server-to-Server connection. To carry out a Capture for a Be2bill credit card payment via a Server-to-Server connection please use the following URL:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
capture.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
namePayID_Capture
pagePayID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Parameters for captures of Be2bill via socket connections

 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Table Excerpt Include
statictrue
namePayID
pagePayID
typepage

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Response parameters for captures of Be2bill via socket connections



Credit with reference

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, please use the following URL:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
credit.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
namePayID_Credit
pagePayID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Parameters for credit payments with Be2bill via socket connection


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Table Excerpt Include
statictrue
namePayID
pagePayID
typepage

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Response parameters for credits of Be2bill via socket connections



Reversal

Reversals of an instalment payment are possible via a Server-to-Server connection. The 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
permits only reversals that reference on a capture previously made via
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
. Only instalment payments can be cancelled. The reversal of a simple authorization is not possible.

To carry out a reversal with a reference transaction, please use the following URL:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
reverse.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
namePayID_Reverse
pagePayID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Parameters for reversals with Be2bill via socket connection


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

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

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Table Excerpt Include
statictrue
namePayID
pagePayID
typepage

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Key

Format

CND

Description

Beschreibung

TransID

ans..40

M

ID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.

TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Response parameters for reversals of Be2bill via socket connections



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 payments / credits with Be2bill and which information can be found within the response file about the payment status.

For Batch calls there must be considered batch versions, from which optional parameters depend. All version designations starting with „2.“ pertain calls for a group of enterprises. That means within a batch file for a particular MerchantID can be transferred transactions for other merchants with a separate Sub-MID.

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

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

Action

Version

Description

Beschreibung

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)

Description of the possible batch versions


The structure for a Be2bill payment within a Batch file to be submitted is the following:

Multiexcerpt
MultiExcerptNamebatch_structure
shouldDisplayInlineCommentsInIncludesfalse
Code Block
languagexml
HEAD,<MerchantID>,<Date>,<Version>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>


Example for Master MID function:

Multiexcerpt
MultiExcerptNamebatch_MasterMid
shouldDisplayInlineCommentsInIncludesfalse
Code Block
languagexml
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:

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

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, CC for Be2bill

HEAD für Header, FOOT für Footer, CC für Be2bill

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)

Table Excerpt Include
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Key

Format

CND

Description

Beschreibung
TransIDans..40MID assigned by Merchant for the payment process to be credited. Matches the Be2bill OrderID.TransaktionsID, die für jede Zahlung eindeutig sein muss. Entspricht der Be2bill OrderID.

RefNr

ns..30

O

Unique reference number

Eindeutige Referenznummer

Table Excerpt Include
statictrue
namePayID_Batch
pagePayID
typepage

Description of fields within the record for Batch files

 

 

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

Multiexcerpt
MultiExcerptNamebatch_Response
shouldDisplayInlineCommentsInIncludesfalse
Code Block
languagexml
HEAD,<MerchantID>,<Date>,<Version>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
CC,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):

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

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)

Table Excerpt Include
statictrue
namePayID_Batch
pagePayID
typepage

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Description of result parameters within the record for Batch files



Test data

Be2bill provides specific Sandbox test data: Test Be2Bill Sandbox