Create a new client

Developing

POST

https://staging-integrations.confirmafinance.com/api/v1/partner/client

This endpoint is used when a new client (creditor) is to be onboarded into the Partner API service, and connected as new user of the service.
Sections: service, client and contacts. Use the Partner Provisioning Token as the API Key value in the header X-Api-Key

Request

Authorization

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Example

{
	"service": {
		"type": "LIFECYCLE",
		"partnerCode": "QUICK3"
	},
    "client": {
		"name": "Test Customer Oy",
		"businessCode": "123456-7",
		"vatRegNbr": "FI1234567",
		"postalAddress": "Testikuja 7",
		"postalCode": "12345",
		"postalDistrict": "HELSINKI",
		"countryCode": "FI",
		"telephone": "",
		"email": "email@testcustomer.fi",
		"website": "",
		"languageCode": "FI",
		"currencyCode": "EUR",
		"ibanAccount": "",
		"bic": "",
		"bankgiro": "",
		"plusgiro": ""
	},
	"contacts": {
		"primary": {
			"name": "Matti Meikäläinen",
			"telephone": "",
			"mobile": "+358441234567",
			"email": "matti@testcustomer.fi"
		},
		"technical": {
			"name": "",
			"email": ""
		},
		"accountant": {
			"name": "",
			"email": ""
		}
	}
}

Responses

🟢200Success

application/json

Response when payload has been accepted and the new client has been generated by the service.

Body

Example

{
    "message": "New client created",
    "clientIdentifier": 0,
    "confirmaFinanceCustomerCode": 0,
    "paymentReferencePrefix": 0,
    "apiAccessToken": "8848372d-8457-4ca4-9da9-673f1cdd6684"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Introduction to onboarding

Validate access token