Select account information for company accounts
# Flow
Note: Make sure to load the user_form_url
in a redirect or popup on
mobile, loading user_form_url
in an iframe on mobile will cause
issues.
# POST /v4/company_accounts
# REQUEST
{
// required
"country_code": "SE",
"ref": "merchant-transaction-ref",
"site_display_name": "Best Website.com",
"site": "example.com",
"success_url": "https://example.com/return_path/transaction_identifier",
"close_url": "https://example.com/return_path/transaction_identifier",
"failure_url": "https://example.com/return_path/transaction_identifier",
// optional
"notification_url": "https://example.com/return_path/transaction_identifier",
"account_ref": "CustomerRefOnMerchantSide",
"email": "bobben@example.com",
"locale": "sv",
"mobile_phone": "+46700000000",
"national_identification_number": "19160204-9999",
"company_registration_number": "5514-1302"
}
# RESPONSES
{
...
"id": "a7e3227819786d26d92f",
"state": "pending",
"user_form_url": "https://account-sandbox.zimpler.com?code=a7e3227819786d26d92f",
"company_id": null,
}
{
...
"id": "a7e3227819786d26d92f",
"state": "approved",
"company_id": "9b9047da-175f-d29a-dae8-85b428488c2e",
"kyc_info": {
"address": {
"line_1": 'Storgatan 12',
"line_2": 'Storgatan 12',
"postcode": '11358',
"city": 'Stockholm',
"country": 'Sweden'
}
"company_id": "4f04f347-411a-4c80-a811-8132cd6a9cf8"
"company_name": "Zimpler"
"company_registration_number": "556887-9984"
"country_code": "SE"
"pep": false
},
//will be provided or partial provided depending on the information we recive.
"account_information": [
{
"type": "iban",
"account_number": "XXX",
},
{
"type": "national-SE",
"clearing_number": "XXX",
"account_number": "XXX",
},
{
"type": "bic",
"bic": "ELLFSESS"
}
],
}
# GET /v4/company_accounts/:id
Will return the full accounts information object with the current state.