About Enterpay

General information about Enterpay

Logo

Info

Enterpay is a Finnish fintech startup which has a mission to boost B2B (business-to-business) ecommerce and optimise the payment process for B2B ecommerce by automating the counterparty risk assessment process.

Invoice payments are the preferred option in B2B commerce, but these are often handled manually, which makes them time-consuming and potentially risky. As online purchases in the B2B market continue to grow rapidly, B2B buyers expect the same smooth experience that they know from B2C ecommerce. Enterpay has developed a technical solution that is equipped to meet the changing expectations of the B2B customers and allows them to make invoice payments in B2B transactions easily, quickly and securely. Enterpay’s payment scheme consists of a platform where all necessary parties can enable automated B2B trade and cooperate seamlessly. Enterpay partners with banks and PSPs so that they can offer purely digital and fully automated invoicing and factoring solution to their B2B merchant customers. The technology automatically carries out the fraud and credit risk assessment and integrates to various ecommerce platforms and payment gateways.

Type

Payments by Invoice and Installments

Further information can be found on the webpage of Enterpay (https://www.enterpay.eu/).

Process flow chart

Authorization

Documentation > Enterpay > Enterpay_sale.jpg

UpdateInvoice

Documentation > Enterpay > Enterpay_update.jpg

interface

Authorization

To create an invoice, please use the following URL:

enterpay.aspx

The URL is used for both invoice creation (EventToken=CRT) and invoice update (EventToken=UPD).

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217. Only EUR permissible. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle
EventToken	enum	M	CRT (for invoice creation)	CRT (für Rechnung anlegen)

Key

Format

CND

Description

Beschreibung

Language

ans..5

O

Language (e.g. "de_DE" as default option)

ArticleList

ans..1024

M

List of articles in the following format.

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

...

Parameter	CND	Description
name	M	The name of the product as displayed on the invoice
unit_price_excluding_tax	M	The cost of this item with tax
quantity	M	The quantity of items on this row
identifier	M	Identifier of the product in the merchant's database
tax_rate	M	The VAT tax rate that applies to this product. e.g. 0.24 means 24%

Artikelliste im folgenden Format.

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

...

Parameter	CND	Beschreibung
name	M	Name des Produkts, wie er auf der Rechnung angezeigt wird
unit_price_excluding_tax	M	Kosten dieses Artikels mit Steuern
quantity	M	Menge der Artikel in dieser Zeile
identifier	M	Produktkennung in der Datenbank des Händlers
tax_rate	M	Für dieses Produkt geltender Mehrwertsteuersatz, z.B. 0.24 bedeutet 24%

InvoiceDate

dttm

O

The parameter sets the invoicing date. Parameter can't be in the past.

Format: YYYY-MM-DD

Der Parameter bestimmt das Rechnungsdatum. Er kann nicht in der Vergangenheit liegen.

Format: JJJJ-MM-TT

InvoiceText

ans..100

O

An optional metadata field for the user's convenience

Ein optionales Metadatenfeld für die Bequemlichkeit des Benutzers

Billing address block is optional. If the block is present, mandatory fields from the block have to be filled.

Der Block der Rechnungsadresse ist optional. Wenn der Block vorhanden ist, müssen die Pflichtfelder im Block ausgefüllt werden.

bdStreet

ans..100

M

Street address of user's billing address

Straßenadresse der Rechnungsadresse des Benutzers

bdStreet2

ans..100

O

Additional information about street address of user's billing address

Zusätzliche Informationen zur Straßenadresse der Rechnungsadresse des Benutzers

bdZIP

ans..10

M

Postal code of user's billing address

Postleitzahl der Rechnungsadresse des Benutzers

bdCity

ans..100

M

City of user's billing address

Ort der Rechnungsadresse des Benutzers

bdCountryCode

ans..10

O

Country code of user's billing address

Ländercode der Rechnungsadresse des Benutzers

Shipping address block is optional. If the block is present, mandatory fields from the block have to be filled.

Der Block der Lieferdresse ist optional. Wenn der Block vorhanden ist, müssen die Pflichtfelder im Block ausgefüllt werden.

sdStreet

ans..100

M

Street address of user's delivery address

Straßenadresse der Lieferadresse des Benutzers

sdStreet2

ans..100

O

Additional information about street address of user's delivery address

Zusätzliche Informationen zur Straßenadresse der Lieferadresse des Benutzers

sdZIP

ans..10

M

Postal code of user's delivery address

Postleitzahl der Lieferadresse des Benutzers

sdCity

ans..100

M

City of user's delivery address

Ort der Lieferadresse des Benutzers

sdCountryCode

ans..10

O

Country code of user's delivery address

Ländercode der Lieferadresse des Benutzers

Buyer block is optional and all the fields are optional. It is better to pass the info as it will lead to better user experience. In this case the buyer won't need to fill this information again on Enterpay side.

Der Käufer-Block ist optional und alle Felder sind optional. Es ist besser, die Informationen weiterzugeben, da dies die Benutzererfahrung verbessert. In diesem Fall muss der Käufer diese Informationen auf der Seite von Enterpay nicht erneut eingeben.

FirstName

ans..125

O

First name of the buyer

Vorname des Käufers

LastName

ans..125

O

Last name of the buyer

Nachname des Käufers

Phone

ans..50

O

Phone number of the buyer with country code, e.g. +35812345678

Telefonnummer des Käufers mit Ländervorwahl, z.B. +35812345678

DateOfBirth

dttm

O

Date of birth of the buyer.

Format: YYYY-MM-DD

Geburtsdatum des Käufers.

Format: JJJJ-MM-TT

Email

ans..50

O

Email address of the buyer

E-Mail-Adresse des Käufers

CompanyName

ans..125

O

Name of the buyer's company

Unternehmensname des Käufers

CompanyID

ans..40

O

Business ID of the buyer's company, e.g. 1234567-8

Firmen-ID des Unternehmens des Käufers, z.B. 1234567-8

TaxNumber

ans..20

O

European VAT identification number of the buyer's company, e.g. FI12345678

Europäische Umsatzsteuer-Identifikationsnummer des Unternehmens des Käufers, z.B. FI12345678

SubMerchant block is optional and all the fields are optional

Der SubMerchant-Block ist optional und alle Felder sind optional

StoreName

ans..255

O

Sub Merchant's Organisation name

Name der Organisation des Sub-Händlers

subMIDAddrStreet

ans..100

O

Street address of sub merchant’s billing/delivery address

Straßenadresse in der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrStreet2

ans..100

O

Additional information about street address of user’s billing/delivery address

Zusätzliche Informationen zur Straßenadresse in der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrZip

ans..10

O

Postal code of sub merchant’s billing/delivery address

Postleitzahl der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrCity

ans..100

O

City of sub merchant’s billing/delivery address

Ort der Rechnungs-/Lieferadresse des Sub-Händlers

subMIDAddrCountryCode

ans..10

O

Country code of sub merchant’s billing/delivery address

Ländercode der Rechnungs-/Lieferadresse des Sub-Händlers

Parameters for creating an invoice with Enterpay

Key	Format	CND	Description	Beschreibung
Status	a..30	M	AUTHORIZE_REQUEST or FAILED	AUTHORIZE_REQUEST oder FAILED

Key	Format		CND	Description	Beschreibung
CodeExt	ans..1024		O	Error code from Enterpay, if agreed with .	Fehlercode von Enterpay, falls mit abgesprochen.
ErrorText	ans..1024		O	Error text from Enterpay, if agreed with .	Fehlermeldung von Enterpay, falls mit abgesprochen.

Result parameters for URLNotify, URLSuccess and URLFailure with Enterpay

Update invoice

Invoice update is possible via Server-to-Server connection.

In order to update an invoice, please use the following URL:

enterpay.aspx

The URL is used for both invoice creation (EventToken=CRT) and invoice update (EventToken=UPD).

Updates of an invoice is possible only for non-active invoices (not captured). In case parameter InvoiceDate is included into UpdateInvoice API call, the call will automatically activate (capture) the updated invoice fully. So no subsequent Activate (capture) API call for the invoice is required. From side the authorized transaction is updated and a capture transaction is created. In case parameter InvoiceDate is not included into UpdateInvoice API call, the invoice remains inactive and Activate (capture) API call should be sent explicitly. Only authorized transactions is updated.

Article list should contain all articles (also the ones which should not be changed), as the entire list of articles will be replaced with the one which is sent. However, in case only parameter InvoiceDate is sent, only InvoiceDate will be updated.

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217. Only EUR permissible. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle
EventToken	enum	M	UPD (for invoice update)	UPD (für Rechnung aktualisieren)

Key

Format

CND

Description

Beschreibung

ArticleList

ans..1024

M

List of articles in the following format.

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

...

Parameter	CND	Description
name	M	The name of the product as displayed on the invoice
unit_price_excluding_tax	M	The cost of this item with tax
quantity	M	The quantity of items on this row
identifier	M	Identifier of the product in the merchant's database
tax_rate	M	The VAT tax rate that applies to this product. e.g. 0.24 means 24%

Artikelliste im folgenden Format.

name,unit_price_excluding_tax,quantity,identifier,tax_rate+

...

Parameter	CND	Description
name	M	Name des Produkts, wie er auf der Rechnung angezeigt wird
unit_price_excluding_tax	M	Kosten dieses Artikels mit Steuern
quantity	M	Menge der Artikel in dieser Zeile
identifier	M	Produktkennung in der Datenbank des Händlers
tax_rate	M	Für dieses Produkt geltender Mehrwertsteuersatz, z.B. 0.24 bedeutet 24%

InvoiceDate

dttm

O

The parameter sets the invoicing date. Parameter can't be in the past.

Format: YYYY-MM-DD

Der Parameter bestimmt das Rechnungsdatum. Er kann nicht in der Vergangenheit liegen.

Format: JJJJ-MM-TT

Parameters for updating an invoice with Enterpay

Key	Format		CND	Description	Beschreibung
CodeExt	ans..1024		O	Error code from Enterpay, if agreed with .	Fehlercode von Enterpay, falls mit abgesprochen.
ErrorText	ans..1024		O	Error text from Enterpay, if agreed with .	Fehlermeldung von Enterpay, falls mit abgesprochen.

Response parameters for updating an invoice with Enterpay

Full capture

Full capture is possible via a Server-to-Server connection.

To capture an invoice fully, please use the following URL:

capture.aspx

The URL is used for both full invoice capture (EventToken=ACF) and partial invoice capture (EventToken=ACP).

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217. Only EUR permissible. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle
EventToken	enum	M	ACF (for full invoice capture)	ACF (für Komplettbuchung der Rechnung)

Parameters for full captures of Enterpay payments

Key	Format		CND	Description	Beschreibung
CodeExt	ans..1024		O	Error code from Enterpay, if agreed with .	Fehlercode von Enterpay, falls mit abgesprochen.
ErrorText	ans..1024		O	Error text from Enterpay, if agreed with .	Fehlermeldung von Enterpay, falls mit abgesprochen.

Response parameters for full captures of Enterpay payments

Partial capture

Partial captures are possible via a Server-to-Server connection. In case of partial capture a new TransID has to be provided in the request. The new TransID will be used for capture of the next invoice.

To capture an invoice partially, please use the following URL:

capture.aspx

The URL is used for both full invoice capture (EventToken=ACF) and partial invoice capture (EventToken=ACP).

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217. Only EUR permissible. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle
EventToken	enum	M	ACP (for partial invoice capture)	ACP (für Teilbuchung der Rechnung)

Key

Format

CND

Description

Beschreibung

ArticleList

ans..1024

M

List of articles in the following format.

quantity,name+

...

Parameter	CND	Description
quantity	M	The quantity of items on this row
name	M	The name of the product as displayed on the invoice

Artikelliste im folgenden Format.

quantity,name+

...

Parameter	CND	Beschreibung
quantity	M	Menge der Artikel in diese Zeile
name	M	Name des Produkts, wie er auf der Rechnung angezeigt wird

Parameters for partial captures of Enterpay payments

Key	Format		CND	Description	Beschreibung
CodeExt	ans..1024		O	Error code from Enterpay, if agreed with .	Fehlercode von Enterpay, falls mit abgesprochen.
ErrorText	ans..1024		O	Error text from Enterpay, if agreed with .	Fehlermeldung von Enterpay, falls mit abgesprochen.

Result parameters for partial captures of Enterpay payments

Reverse

Reversals are possible via a Server-to-Server connection. Reversal ist possible only for non-active (non-captured) invoice. Only full reversal is allowed. In case an invoice has been activated (captured), a Refund should be used.

In order to reverse (cancel) an invoice, please use the following URL:

reverse.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217. Only EUR permissible. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle

Parameters for reversals of Enterpay payments

Key	Format		CND	Description	Beschreibung
CodeExt	ans..1024		O	Error code from Enterpay, if agreed with .	Fehlercode von Enterpay, falls mit abgesprochen.
ErrorText	ans..1024		O	Error text from Enterpay, if agreed with .	Fehlermeldung von Enterpay, falls mit abgesprochen.

Result parameters for reversals of Enterpay payments

Credit (refund)

Credits (refunds) are possible via a Server-to-Server connection. Credits is possible only for invoices which have already been activated (captured). Both full and partial credits (multiple credits) are allowed. In case an invoice has not been activated (captured), a Reversal should be used.

To carry out a credit on an invoice, please use the following URL:

credit.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217. Only EUR permissible. Please find an overview here: A1 Currency table EN	Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung

ArticleList

ans..1024

M

List of articles in the following format.

name,refunding_type,currency,refunded_amount+

...

Parameter	CND	Description
name	M	The name of the product as displayed on the invoice
refunding_type	M	amount Constant value
currency	M	Currency
refunded_amount	M	The amount to refund of this purchase item

Artikelliste im folgenden Format.

name,refunding_type,currency,refunded_amount+

...

Parameter	CND	Beschreibung
name	M	Name des Produkts, wie er auf der Rechnung angezeigt wird
refunding_type	M	amount Konstanter Wert
currency	M	Währung
refunded_amount	M	Der zu erstattende Betrag dieses Kaufartikels

Parameters for credits of Enterpay payments

Key	Format		CND	Description	Beschreibung
CodeExt	ans..1024		O	Error code from Enterpay, if agreed with .	Fehlercode von Enterpay, falls mit abgesprochen.
ErrorText	ans..1024		O	Error text from Enterpay, if agreed with .	Fehlermeldung von Enterpay, falls mit abgesprochen.

Result parameters for credits of Enterpay payments