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, 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.

Logo

Info

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

Type

Payments by Credit Card

Card Scheme
VISA
MasterCard
Cartes Bancaires

Process flow charts

Be2bill process flow via the form interface

Be2bill process flow via server-to-server-communication

Configuration for Be2bill

To set up Be2bill the merchant needs to save the required interface URLs in the backend. Each of these is a “Transaction feedback URL”:

Be2billComplete.aspx

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

cbBe2bill.aspx

Documentation > Be2bill > image2019-7-19_15-20-3.png

Documentation > Be2bill > image2019-7-19_15-20-10.png

interface

Credit card payment with Be2bill via form interface

Payments with Be2bill are made via the standard form interface for credit card payments. In order to execute an SSL credit card payment with Be2bill via a form, visit the following URL:

payssl.aspx

Key	Format	CND	Description	Beschreibung
TransID_Bebill	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_Be2bill	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.

Key	Format	CND	Description	Beschreibung
CreditCardHolder_Be2bill	an..255	M	Name of the card holder	Name des Karteninhabers

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.

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
CustomerID	ans..255	M	Unique 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)
Email	ans..255	M	Email address of the card holder	E-Mail-Adresse des Karteninhabers
ChDesc	ans..255	O	Source URL of the merchant or the shop system	Ursprungs-URL des Händlers bzw. des Shopsystems
DateOfBirth	dttm10	O	Date of birth of the card holder: YYYY-MM-DD	Geburtsdatum des Karteninhaber: JJJJ-MM-TT
InstallmentAmount	ans..1024	O	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
InstallmentDate	ans..1024	C	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
UserAgent	ans..128	O	Browser 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 address	Lieferadresse
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 address	Rechnungsadresse
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
			Subscriptions	Abonnements
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)
IPAddr	ans..15	M	IP address. With this parameter 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 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.

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

Layout parameters for forms for credit card payments with Be2bill

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by 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 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.

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	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.

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 .	Detaillierte Be2bill Fehlermeldung. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem möglich.

Key	Format	CND	Description	Beschreibung
CCBrand	a..22	O	In combination with PCNr: Name of credit card brand, e.g. Visa, MasterCard, Cartes Bancaires	In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, Cartes Bancaires
CCExpiry	n6	O	In combination with PCNr: Expiry date of the credit card in the format YYYYMM.	In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM
TokenExt	an..32	O	For recurring payments (RTF=I) the TokenExt is transmitted for referencing the credit card data	Bei 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

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:

direct.aspx

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.

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..510	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.

Key	Format	CND	Description	Beschreibung
CCNr	n..19	M	Credit 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.
CCCVC	n..4	C	Card 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.
CCExpiry	n6	M	Credit card expiry date (YYYYMM), e.g. 202607	blaufdatum der Kreditkarte (JJJJMM), z.B. 202607
CCBrand	a..22	M	Card 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
CustomerID	ans..255	M	Unique 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)
Email	ans..255	M	Email address of the card holder	E-Mail-Adresse des Karteninhabers
ChDesc	ans..255	O	Source URL of the merchant or the shop system	Ursprungs-URL des Händlers bzw. des Shopsystems
DateOfBirth	dttm10	O	Date of birth of the card holder: YYYY-MM-DD	Geburtsdatum des Karteninhaber: JJJJ-MM-TT
InstallmentAmount	ans..1024	O	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
InstallmentDate	ans..1024	C	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
UserAgent	ans..128	M	Browser 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 address	Lieferadresse
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 address	Rechnungsadresse
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
			Subscriptions	Abonnements
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)
IPAddr	ans..15	M	IP address. With this parameter 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 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

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by 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 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.

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	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.

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 .	Detaillierte Be2bill Fehlermeldung. Hinweis: Wird nur bei Status=FAILED zurückgegeben. Nutzung nur in Abstimmung mit dem möglich.

Key	Format	CND	Description	Beschreibung
CCBrand	a..22	O	In combination with PCNr: Name of credit card brand, e.g. Visa, MasterCard, Cartes Bancaires	In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, Cartes Bancaires
CCExpiry	n6	O	In combination with PCNr: Expiry date of the credit card in the format YYYYMM.	In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM
TokenExt	an..32	O	For recurring payments (RTF=I) the TokenExt is transmitted for referencing the credit card data	Bei 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:

capture.aspx

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.

Parameters for captures of Be2bill via socket connections

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.

Response parameters for captures of Be2bill via socket connections

Credit with reference

credit.aspx

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.

Parameters for credit payments with Be2bill via socket connection

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.

Response parameters for credits of Be2bill via socket connections

Reversal

Reversals of an instalment payment are possible via a Server-to-Server connection. The permits only reversals that reference on a capture previously made via . 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:

reverse.aspx

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.

Parameters for reversals with Be2bill via socket connection

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.

Response parameters for reversals of Be2bill via socket connections

Batch processing via the 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:

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:

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:

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

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)

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.
RefNr	ns..30	O	Unique reference number	Eindeutige Referenznummer

Description of fields within the record for Batch files

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

HEAD,<MerchantID>,<Date>,<Version>
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>

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)

Description of result parameters within the record for Batch files

Test data

Be2bill provides specific Sandbox test data: Test Be2Bill Sandbox