Sign in

v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB
Accounts

Create Account

This endpoint is no longer maintained. It remains available only to support existing customers. New integrations should use Create Sub Account instead.

Create an account so they can start receiving payments. Once created, we will run due diligence checks. Please note that currently this API is only for Banking accounts.

post/v1/accounts

Request body

OR

Example request

{
  "name": "John Doe",
  "contact_details": {
    "email": "example@company.com",
    "phone": "+6588880000"
  },
  "person_details": {
    "first_name_english": "John",
    "last_name_english": "Doe",
    "first_name": "John",
    "last_name": "Doe",
    "local_name": "张三",
    "nationality": "SG",
    "date_of_birth": "1990-01-01",
    "tax_number": "123-45-6789",
    "banking_currencies": [
      "USD"
    ],
    "banking_countries": [
      "US"
    ],
    "monthly_estimated_revenue": {
      "amount": "TM001",
      "currency": "SGD"
    },
    "identification": {
      "type": "PASSPORT",
      "id_number": "A12345678",
      "remark": "Valid until 2030",
      "citizenship_status": "non_resident",
      "documents": {
        "front": "data:image/png;base64,TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4=",
        "front_file_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
        "back": "data:image/png;base64,TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4=",
        "back_file_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395"
      }
    }
  },
  "residential_address": {
    "country_code": "SG",
    "city": "Singapore",
    "street": "444 Orchard Rd, Midpoint Orchard, Singapore ",
    "postcode": "924011"
  },
  "documents": [
    {
      "type": "PROOF_OF_ADDRESS",
      "front": "data:image/png;base64,TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4=",
      "front_file_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
      "back": "data:image/png;base64,TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4=",
      "back_file_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395"
    }
  ],
  "tos_acceptance": {
    "ip": "0.0.0.0",
    "date": "2024-03-22T16:08:02+08:00",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0"
  }
}

Response

Account creation successfully.

account_idstring required

A unique identifier of the account.

short_reference_idstring required

The short reference ID of the account.

statusstring required

Status of the account. One of the following:

  • ACTIVE - The account has been activated.
  • PROCESSING - The account is currently undergoing review and processing.
  • INACTIVE - The account temporarily inactive
  • CLOSED - The account has been closed.
verification_status'VERIFIED' | 'UNDER_REVIEW' | 'ACTION_REQUIRED' required

The KYC verification outcome for the cardholder associated with this card creation request.

  • VERIFIED - The cardholder's identity has been verified.
  • UNDER_REVIEW - AML or KYC review is in progress.
  • ACTION_REQUIRED - The cardholder must complete an action (such as Sumsub IDV) before the card can be activated.

Example response

{
  "account_id": "f5bb6498-552e-40a5-b14b-616aa04ac1c1",
  "short_reference_id": "P220406-LLCVLRM",
  "status": "PROCESSING",
  "verification_status": "UNDER_REVIEW"
}