Accounts

Create account application

Create a new account application.

If submit is set to false:

The application is not sent for processing and can be further modified with incremental changes via Update account application.
This endpoint generates an Account application prospect created event.

If submit flag is set to true:

No further updates can be made and the account application is sent out for processing, which creates an account and its associated structures.
This endpoint generates an Account application created event.

Warning—Some of the account's elements are created asynchronously and you should refrain from accessing the account via other endpoints until the events this endpoint generates are received.

Notes:

Either the personal object or company object is REQUIRED. Pass one or the other but not both.
This endpoint creates a default entity object for the account owner based on document ID.

Refer to the Core objects and the Accounts guides for more information.

post/acquisitions/v3/s2s/applications

Request

Base URL
https://sandbox.pismolabs.io
URL
https://sandbox.pismolabs.io/acquisitions/v3/s2s/applications
Auth
HTTP bearer

Request body

Example request

{
  "application": {
    "submit": true,
    "applicant": {
      "document_number": "12345678910",
      "birth_date": "1991-11-27",
      "personal": {
        "external_id": "8c8a4dd7-e48f-4c15-85b7-9d12f401057f",
        "name": "Hyman Roth",
        "email": "jenna.flect@email.com",
        "gender": "M",
        "printed_name": "John Doe",
        "nickname": "Pinto",
        "social_name": "Terminator",
        "country_of_birth": "India",
        "state_of_birth": "California",
        "city_of_birth": "San Diego",
        "registration": {
          "number": "1234567890"
        },
        "marital_status": "MARRIED",
        "fathers_name": "Steven Douglas",
        "mothers_name": "Kay Sadilla",
        "nationality": "Australian",
        "other_id_number": "29000000",
        "document_issued_at": "Brazil",
        "document_issued_date": "01/31/1970",
        "occupation": "Creative Accountant",
        "assets": 40000,
        "income": 4000,
        "net_worth": 20000
      },
      "company": {
        "external_id": "8c8a4dd7-e48f-4c15-85b7-9d12f401057f",
        "name": "Acme Inc.",
        "email": "acme@acmemail.com",
        "company_name": "Acme General Products",
        "registration_number": "ACM10004",
        "activity": "Manufacturing",
        "company_type": "Retailer",
        "company_format": "ME",
        "company_constitution_date": "2004-01-20",
        "occupation": "Online retail",
        "income": 10000,
        "net_worth": 20000,
        "annual_revenues": 33000,
        "type": "B2C",
        "number_of_partners": 3,
        "perc_ownership": 50,
        "fiscal_situation": "Good",
        "debt": 18000,
        "partners": [
          {
            "name": "Hyman Roth",
            "nickname": "Pinto",
            "printed_name": "Jack Williams",
            "social_name": "Jack",
            "email": "jenna.flect@email.com",
            "document_number": "31457828046",
            "mothers_name": "Kay Sadilla",
            "gender": "M",
            "birth_date": "31/12/1980",
            "city_of_birth": "San Diego",
            "state_of_birth": "California",
            "country_of_birth": "India",
            "fathers_name": "Steven Douglas",
            "marital_status": "MARRIED"
          }
        ]
      },
      "account": {
        "currency_numeric_code": "986",
        "granted_limit": 1500,
        "limit": 750,
        "exchange_mode": "SAME_DAY",
        "external_id": "8c8a4dd7-e48f-4c15-85b7-9d12f401057f",
        "parent_account_id": 8675309,
        "overdraft_limit": 750,
        "account_type": "PHYSICAL",
        "division_id": 2856813
      },
      "addresses": [
        {
          "address": "Mulholland Drive",
          "city": "San Diego",
          "state": "California",
          "country": "Brazil",
          "address_type": "RESIDENTIAL",
          "zip_code": "12345-678",
          "neighborhood": "Shady Pines",
          "complementary_address": "Apt 1408",
          "mailing_address": true,
          "custom_fields": {
            "field_01": "value01",
            "field_02": "value02"
          }
        }
      ],
      "phones": [
        {
          "phone": "11912345678",
          "phone_type": "MOBILE",
          "country_code": "555",
          "area_code": 11,
          "extension": "ext. 9"
        }
      ],
      "custom_fields": {
        "field_01": "value01",
        "field_02": "value02"
      }
    },
    "acquisition_channel": 111,
    "program_id": 111,
    "due_date": 222,
    "program_calendar_strategy_id": 8675309
  }
}

Response

Created

application_idinteger required

Application form ID (non-checking accounts only)

statusinteger required

Application status ID

status_namestring required

Application status. Most likely to be

REGISTERED - Application was saved, but not started processing yet.
APPROVED - Application has finished processing.
PROSPECT - Application was created with submit = false.

account_idinteger required

Created account ID. null if the application has not been proccessed yet (non-checking accounts only).

customer_idinteger required

Created customer ID. null if the application has not yet been proccessed (non-checking accounts only).

entity_idinteger required

Created entity ID. null if the application has not yet been proccessed (non-checking accounts only).

program_idinteger required

Program ID

creation_datetimestring date-time

Date and time of account creation in the UTC ISO 8601 format (yyyy-MM-ddThh:mm:ssZ).

Example response

{
  "application_id": 1234,
  "status": 4,
  "status_name": "APPROVED",
  "account_id": 123,
  "customer_id": 123,
  "entity_id": 123,
  "program_id": 12345,
  "creation_datetime": "2021-07-21T17:32:28Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.