Allows partners to easily onboard their own merchants

Onboarding API Request

Parameter Value Description Parameter Type Data Type
Authorization (required) Private api key header string


		"application": { 
			"company": { 
				"organizationNumber": "string", 
				"vatNumber": "string", 
				"invoiceEmail": "string", 
				"contactPerson": { 
					"email": "string", 
					"firstName": "string", 
					"lastName": "string", 
					"phone": "string" 
			"country": " DNK/SWE/NOR", 
			"currency": "SEK/NOK/DKK", 
			"productCodes": ["CARD","INVOICE"], 
			"salesCode": "string", 
			"webshop": { 
				"name": "string", 
				"url": "string" 
			"bankAccount": { 
				"iban": "string", 
				"swift": "string" 
			"salesRepPartner": "string", 
			"salesRepDibs": "string" 
		"adminUser": { 
			"firstName": "string", 
			"lastName": "string", 
			"email": "string", 
			"language": "string", 
			"sendActivationEmail": boolean  

About the parameters

  • application
    • company
      • organizationNumber - The merchants organisation number (See ISO standards for more information)
      • vatNumber - DK/NO/SE-ORGANIZATION NR-01, i.e SE-5565005021-01 (DIBS VAT no.) (See ISO standards for more information)
      • invoiceEmail - The merchants e-mail address to where the invoice from DIBS should be sent
      • contactPerson - Contact person that DIBS can contact if needed.
        • email - E-mail to the above contact person.
        • firstname - First name of the above contact person.
        • lastname - Last name of the above contact person.
        • phone - Phone number the above contact person.
    • country - In which country will the merchant do business (i.e DK/NO/SE), can only be one country.
    • currency - Must match the currency of country.
    • productCodes - States if the merchant will offer card, invoice or both.
    • salesCode - Optional, if you have received a sales code from DIBS you can use it here.
    • webshop - Information about the webshop.
      • name - The name of the webshop, i.e. DIBS Paymentservices AB (publ).
      • url - URL to the webshop, i.e. www.dibs.se.
    • bankAccount - Information about where payouts from DIBS should be made.
      • iban - Account information according to the agreement with the bank selected by the merchant.
      • swift - Account information according to the agreement with the bank selected by the merchant.
    • salesRepPartner - Optional, enter the partner name.
    • salesRepDibs - Optional, enter the sales person at DIBS.
  • adminUser - This information is needed for the merchants user account in the Easy merchant portal
    • firstname - First name of the user.
    • lastname - Last name of the user.
    • email - E-mail address to the user, this will get the activation email if sendActivationEmail is set to True. Will be used to login to the Easy merchant portal.
    • language - Set in which language Easy merchant portal will be shown. DK, EN, NO and SE available.
    • sendActivationEmail - Set value to True to make Easy send the activation e-mail or False if you want to send the activation link in your own e-mail to the merchant.
Response class


HTTP Status Code Reason Response model
200 OK
400 Bad request
  "errors": {}
401 Unauthorized  
500 Unexpected error
  "message": "string",
  "code": "string",
  "source": "string"


Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00