Step 2

​Create an HTML form in the company's website ​​

Inter​acti​​​​o​n with E-Agreement is via an HTTP POST request.

Please note: due to an incompatibility of BankID authentication, the use of an iFrame for the display of E-Agreement cannot be supported. Embedding E-Agreement in an iFrame will cause major issues in some popular browsers.

​Create an HTML for​m in​ the compa​ny's website with one of these URLs to be the recipient of the submitted form:


For test:
For prod:


For test:
For prod:

AvtaleGiro & eFaktura combination

For test:
For prod:

The application receives a payee request via a http post. The request can have the following parameters:

​​​Parameter name​​Mandatory ​Allowed values​​Description


bank account number
​The company's bank account number (only Norwegian accounts are accepted, and the company must have an agreement with their bank to use the service)
​kid​Yes​Numeric string​Unique identification of payer (minimum 3, maximum 25 digits)​
​amountLimit​No​Positive integer​​The maximum amount that the customer may be charged via AvtaleGiro within a calendar month. If not submitted, it will default to NOK 10000. The value may be changed by the payer.
​notificationDisabled​No​true/false​Sets the default notification setting, which the payer may change. If true, the payer will NOT receive notification of new AvtaleGiro payment claims.

​Both services

min 3 characters​
​​​The name of the company, as it should be displayed to the user.
​returnUrl​No​​Valid URLThe URL to which the user should be dire​cted after completing or cancelling the AvtaleGiro onboarding process.​​


​issuerId​Yes​AlphanumericThe company’s ID for eFaktura B2C
brandId​​Yes​Positive integer​For companies that have more than one brand per issuer ID, this parameter can be used to differentiate which brand or service the invoice is related to. The default is 1.
​efakturaRef​YesPositive integerCustomer’s eFaktura reference at the company.
​​​email​No​Valid email address​​Suggested email address for notification of new eFaktu​ra invoices to the customer.

Code example (for AvtaleGiro & eFaktura combination agreement):


<form action="" method="post">
  <input type="hidden" name="companyName" id="companyName" value="INSERT_COMPANY_NAME_HERE" />
  <input type="hidden" name="companyAccountNo" id="companyAccountNo" value="INSERT_COMPANY_ACCOUNT_NUMBER_HERE" />
  <input type="hidden" name="kid" id="kid" value="INSERT_CUSTOMER_KID_HERE" />
  <input type="hidden" name="amountLimit" id="amountLimit" value="INSERT_SUGGESTED_AMOUNT_LIMIT_HERE" />
  <input type="hidden" name="returnUrl" id="returnUrl" value="INSERT_RETURN_URL_HERE" />
  <input type="hidden" name="notificationDisabled" id="notificationDisabled" value="true" />
  <input type="hidden" name="issuerId" id="issuerId" value="INSERT_ISSUER_ID_HERE" />
  <input type="hidden" name="brandId" id="brandId" value="1" />
  <input type="hidden" name="efakturaRef" id="efakturaRef" value="INSERT_EFAKTURA_REFERENCE_HERE" />
  <input type="hidden" name="email" id="email" value="INSERT_CUSTOMER_EMAIL_ADDRESS_HERE" />
  <button type="submit">Create an agreement for AvtaleGiro & eFaktura</button>

Go to Step 3