zimpler-developers

Select account information for company accounts

# Flow

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.