---
title: "Criar Subconta"
method: POST
path: "/marketplace/create_account"
---

# Criar Subconta

`POST /marketplace/create_account`

Permite a criação de subcontas (contas de pagamento) para contas com permissão de Marketplace ou parceiro de negócios. [Para mais informações sobre como configurar um subconta](https://dev.iugu.com/docs/configurar-subconta-por-api)

## Headers

- `Request-Time` string, date-time, required
- `Signature` string, required

## Request body

- object
  - `name` string — Nome da subconta, não deverá conter números ou caracteres especiais. Se não enviado, o ID da conta é utilizado por padrão.
  - `splits` object[] — Lista de splits que será utilizado nesse conta.
    - `recipient_account_id` string — ID Da conta que irá receber o split
    - `cents` integer — Centavos a serem cobrados.
    - `percent` number, float — Porcentagem a ser cobrada.
    - `bank_slip_cents` integer — Valor em centavos a ser cobrado apenas em transações no boleto.
    - `bank_slip_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no boleto.
    - `credit_card_cents` integer — Valor em centavos a ser cobrado apenas em transações no cartão de crédito.
    - `credit_card_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no cartão de crédito.
    - `pix_cents` integer — Valor em centavos a ser cobrado apenas em transações no pix.
    - `pix_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no pix.
    - `permit_aggregated` boolean — Permite agregar comissionamento percentual + fixo.
    - `credit_card_1x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 12x no cartão de crédito.
    - `credit_card_1x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 12x no cartão de crédito.

## Response `200`

200

- object
  - `account_id` string
  - `name` string
  - `live_api_token` string
  - `test_api_token` string
  - `user_token` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/revisions/4590fc729d1e/schema)