# Create Split Settlement Account

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/split-account:
    post:
      summary: Create Split Settlement Account
      deprecated: false
      description: >+

        :::highlight purple 📌

        Use this API to create and register a split settlement account for a
        vendor, partner, or internal entity. This account will receive funds
        based on your defined split rules, enabling automated, accurate
        distribution of payments.

        :::

      tags:
        - Payment Gateway/APIs - Payment Gateway /Split Settlement
      parameters:
        - name: authorization
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: merchantAccessKey
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SplitAccountCreateRequest'
            examples:
              '1':
                value:
                  accountNumber: '1000000007'
                  email: john.doe@enkash.com
                  ifsc: KKBK0000007
                  name: John Doe
                  phone: '9460219636'
                  settlementCycle: T1
                  label: Label 1
                  settlementSchedule: null
                  dashboardAccess: false
                  pan: AAACA5989A
                summary: Request with PAN
              '2':
                value:
                  accountNumber: '1000000007'
                  email: john.doe@enkash.com
                  ifsc: KKBK0000007
                  name: John Doe
                  phone: '9460219636'
                  settlementCycle: T1
                  label: Label 1
                  settlementSchedule: null
                  dashboardAccess: false
                  gstin: 11AAACA5989A1ZA
                summary: Request with GSTIN
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  response_code:
                    type: integer
                    format: int32
                  response_message:
                    type: string
                  payload:
                    $ref: '#/components/schemas/SplitAccountResponse'
                x-apidog-refs: {}
                x-apidog-orders:
                  - response_code
                  - response_message
                  - payload
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Payment Gateway/APIs - Payment Gateway /Split Settlement
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-11766746-run
components:
  schemas:
    SplitAccountCreateRequest:
      type: object
      properties:
        name:
          type: string
        email:
          type: string
        phone:
          type: string
        settlementCycle:
          type: string
          enum:
            - T0
            - T1
            - T2
          x-apidog-enum:
            - value: T0
              name: ''
              description: ''
            - value: T1
              name: ''
              description: ''
            - value: T2
              name: ''
              description: ''
        settlementSchedule:
          type: string
        dashboardAccess:
          type: boolean
        pan:
          type: string
          description: Required if gstin not provided
        gstin:
          type: string
          description: Required if pan not provided
        accountNumber:
          type: string
        ifsc:
          type: string
          description: 11 letter IFSC code
        label:
          type: string
          description: Label for account
      x-apidog-orders:
        - name
        - email
        - phone
        - settlementCycle
        - settlementSchedule
        - dashboardAccess
        - pan
        - gstin
        - accountNumber
        - ifsc
        - label
      required:
        - name
        - email
        - phone
        - accountNumber
        - ifsc
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    SplitAccountResponse:
      type: object
      properties:
        splitAccountDetailId:
          type: string
        accessKey:
          type: string
        name:
          type: string
        email:
          type: string
        phone:
          type: string
        dashboardAccess:
          type: boolean
        pan:
          type: string
        gstin:
          type: string
        accountNumber:
          type: string
        ifsc:
          type: string
        beneficiaryCode:
          type: string
        approved:
          type: string
        approvedOn:
          type: string
        createdOn:
          type: string
        label:
          type: string
      x-apidog-orders:
        - splitAccountDetailId
        - accessKey
        - name
        - email
        - phone
        - dashboardAccess
        - pan
        - gstin
        - accountNumber
        - ifsc
        - beneficiaryCode
        - approved
        - approvedOn
        - createdOn
        - label
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```