From f28d60394ec6230f990cba7cf85f211535b0bd57 Mon Sep 17 00:00:00 2001 From: Eduardo Maciel Date: Wed, 17 Jan 2024 18:26:18 -0300 Subject: [PATCH] feat(splits): unify splits docs and create new docs --- ...-to-create-charge-with-split-using-api.mdx | 6 +- .../how-to-create-charge-woovi-parcelado.mdx | 2 +- docs/concepts/charge.md | 2 + docs/splits/__assets__/split-fee-partner.png | Bin 0 -> 21118 bytes docs/splits/__assets__/split-intro.png | Bin 0 -> 33174 bytes docs/splits/__assets__/split-subaccount.png | Bin 0 -> 34348 bytes docs/splits/_category_.json | 13 +++ docs/splits/split-introduction.md | 70 ++++++++++++ docs/{ => splits}/subaccount/_category_.json | 0 ...ge-with-splits-to-subaccount-using-api.mdx | 0 ...-create-charge-with-splits-with-plugin.mdx | 104 ++++++++++++++++++ ...nce-and-detais-of-subaccount-using-api.mdx | 9 +- ...-list-subaccounts-of-company-using-api.mdx | 0 ...w-to-withdraw-fom-subaccount-using-api.mdx | 25 ++--- .../subaccount/split-sub-account-usecases.mdx | 48 ++++++++ docs/subaccount/sub-account-use-cases.md | 24 ---- docs/subaccount/sub-account.md | 12 -- .../when-to-use-subaccount-or-partner.md | 30 ----- ...ow-to-transfer-values-between-accounts.mdx | 2 +- 19 files changed, 257 insertions(+), 90 deletions(-) create mode 100644 docs/splits/__assets__/split-fee-partner.png create mode 100644 docs/splits/__assets__/split-intro.png create mode 100644 docs/splits/__assets__/split-subaccount.png create mode 100644 docs/splits/_category_.json create mode 100644 docs/splits/split-introduction.md rename docs/{ => splits}/subaccount/_category_.json (100%) rename docs/{ => splits}/subaccount/how-to-create-charge-with-splits-to-subaccount-using-api.mdx (100%) create mode 100644 docs/splits/subaccount/how-to-create-charge-with-splits-with-plugin.mdx rename docs/{ => splits}/subaccount/how-to-get-balance-and-detais-of-subaccount-using-api.mdx (88%) rename docs/{ => splits}/subaccount/how-to-list-subaccounts-of-company-using-api.mdx (100%) rename docs/{ => splits}/subaccount/how-to-withdraw-fom-subaccount-using-api.mdx (77%) create mode 100644 docs/splits/subaccount/split-sub-account-usecases.mdx delete mode 100644 docs/subaccount/sub-account-use-cases.md delete mode 100644 docs/subaccount/sub-account.md delete mode 100644 docs/subaccount/when-to-use-subaccount-or-partner.md diff --git a/docs/charge/how-to-create-charge-with-split-using-api.mdx b/docs/charge/how-to-create-charge-with-split-using-api.mdx index b9feee10..841e9b87 100644 --- a/docs/charge/how-to-create-charge-with-split-using-api.mdx +++ b/docs/charge/how-to-create-charge-with-split-using-api.mdx @@ -10,9 +10,11 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; :::info -Para a ultilização dessa funcionalidade é necessário possuir a funcionalidade Split +Para a utilização dessa funcionalidade é necessário possuir a funcionalidade Split ::: +## Criar Split via API + Para criar uma cobrança Pix com split, você utiliza o _endpoint_ `/api/v1/charge` da API. Você pode acessar [aqui](https://developers.openpix.com.br/api#tag/charge/paths/~1api~1v1~1charge/post) @@ -24,7 +26,7 @@ Os campos obrigatórios para criar uma cobrança Pix com Split são os seguintes - **`correlationID`**: Um identificador único para a cobrança Pix. [CorrelationID](../concepts/correlation-id) - **`splits`**: Um array contendo as configurações de split realizado na hora do recebimento -## Exemplo +### Exemplo O body da sua requisição será semelhante a este exemplo: diff --git a/docs/charge/how-to-create-charge-woovi-parcelado.mdx b/docs/charge/how-to-create-charge-woovi-parcelado.mdx index af13aab4..2249c92d 100644 --- a/docs/charge/how-to-create-charge-woovi-parcelado.mdx +++ b/docs/charge/how-to-create-charge-woovi-parcelado.mdx @@ -10,7 +10,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; :::info -Para a ultilização dessa funcionalidade é necessário possuir a funcionalidade OpenPix Parcelado. Solicite o acesso via chat pela plataforma pelo link +Para a utilização dessa funcionalidade é necessário possuir a funcionalidade OpenPix Parcelado. Solicite o acesso via chat pela plataforma pelo link ::: Para criar uma cobrança Pix com OpenPix Parcelado, você utiliza o _endpoint_ `/api/v1/charge` da API. diff --git a/docs/concepts/charge.md b/docs/concepts/charge.md index d1420c4e..0f7aae1c 100755 --- a/docs/concepts/charge.md +++ b/docs/concepts/charge.md @@ -20,4 +20,6 @@ Uma Cobrança aceita somente 1 pagamento. Uma Cobrança possui um prazo de vencimento. +Cada cobrança paga gera uma nova transação. + Casos de uso: criar uma cobrança para um pedido, criar uma cobrança para um serviço, criar uma cobrança para um produto. \ No newline at end of file diff --git a/docs/splits/__assets__/split-fee-partner.png b/docs/splits/__assets__/split-fee-partner.png new file mode 100644 index 0000000000000000000000000000000000000000..072834b1da62525eefba535ea1d91abc0c10dc49 GIT binary patch literal 21118 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 N`v6gvsgW`b`hO)yltcgk literal 0 HcmV?d00001 diff --git a/docs/splits/_category_.json b/docs/splits/_category_.json new file mode 100644 index 00000000..2963ff47 --- /dev/null +++ b/docs/splits/_category_.json @@ -0,0 +1,13 @@ +{ + "label": "Split de cobranças", + "collapsible": true, + "collapsed": true, + "className": "red", + "link": { + "type": "generated-index", + "title": "Splits visão geral" + }, + "customProps": { + "description": "Splits documentação" + } +} \ No newline at end of file diff --git a/docs/splits/split-introduction.md b/docs/splits/split-introduction.md new file mode 100644 index 00000000..26a669ab --- /dev/null +++ b/docs/splits/split-introduction.md @@ -0,0 +1,70 @@ +--- +id: split-introduction +title: Introdução +tags: + - split +--- + +:::info +Para a utilização dessa funcionalidade é necessário possuir uma conta na OpenPix e a funcionalidade Split, entre em contato com nosso time de suporte para habilitar essa funcionalidade. +::: + +## Definição de split + +O split é uma funcionalidade que permite que o recebimento de uma cobrança seja dividido entre diversas contas. + +![Introdução ao Split](__assets__/split-intro.png) + +## Como funciona? + +A OpenPix possui diversas funcionalidades de split que permite que o recebimento de uma cobrança seja dividido entre algumas chaves pix via `API`, via plataforma e via `plugin.js` + +## Tipos de split + +Temos 2 tipos de split, e esses dois tipos de split tem casos de uso diferentes, por isso é necessário antes de utilizar o split entender qual tipo de split utilizar. + +### Split de parceiro e afiliado (SPLIT_PARTNER) + +O split de parceiro e afiliado é uma funcionalidade que permite que o recebimento de uma cobrança seja dividido entre a conta do parceiro e a conta do afiliado. + +Ou seja, parte do valor da cobrança vai para a conta do parceiro e parte do valor da cobrança vai para a conta do afiliado, sendo possível configurar uma porcentagem ou valor fixo do parceiro diretamente pela plataforma para todas as cobranças. + +#### Quando utilizar (SPLIT_PARTNER) + +O sistema de parceiros permite a empresas registrar outras empresas como afiliados e gerenciar alguns aspectos do seu funcionamento através das API's e plataforma OpenPix. + +Cada afiliado passa pelo processo de abertura de contas na plataforma. + +Cada afiliado possui conta virtual na plataforma registrada no CNPJ de sua empresa independente do parceiro. + +Cada afiliado recebe valores de cobranças diretamente via pix em sua conta virtual registrada na plataforma. + +O parceiro não recebe diretamente valores em sua conta, somente taxa do parceiro perante o uso da feature de `SPLIT_PARTNER`. + +Esta feature é indicada para quem quer ter uma relação mais definida entre parceiro e afiliados e pretende envolver parceiros no cadastro completo de uma conta virtual + +requisitando assim dados de registro de empresa e sócios como qualquer outra abertura de contas, não recebendo diretamente em suas contas valores relativos a pagamento feitos por afiliados, somente valores relativos a taxa de parceiros. + +![Taxa de Parceiro](__assets__/split-fee-partner.png) + +### Split de sub-contas (SPLIT_SUB_ACCOUNT) + +Sub contas são contas virtuais representadas por uma chave pix que podem transacionar virtualmente valores através do sistema de split de pagamentos. Esses valores podem ser convertidos em transações reais através do saque para a chave pix registrada para a subconta. + +Ou seja, parte do valor da cobrança vai para uma chave pix e parte do valor da cobrança vai para outra chave pix, sendo possível definir na hora da criação da cobrança o valor que vai para cada chave pix. + +![Split SubAccount](__assets__/split-subaccount.png) + +#### Quando utilizar (SPLIT_SUB_ACCOUNT) + +O sistema de subcontas permite registrar transações de split em uma subconta a partir de cobranças feitas para uma conta principal. + +Subcontas não são contas bancárias reais e somente transacionam valores virtuais permitindo assim a eliminação de etapas burocráticas na abertura da mesma. + +Cada subconta só precisa de uma chave pix única para ser aberta, de qualquer tipo, CPF, CNPJ, email, telefone, etc. + +Uma empresa pode ter qualquer número de subcontas. + +Uma empresa pode a qualquer momento realizar um saque para a chave pix registrada na subconta, tanto via integração de API ou diretamente pela plataforma. + +O uso da subconta permite a criação de fluxos menos burocráticos e mais livres dentro da plataforma, os valores sacados só serão debitados da conta principal no momento do saque garantindo total controle ao administrador da empresa dona destas subcontas. diff --git a/docs/subaccount/_category_.json b/docs/splits/subaccount/_category_.json similarity index 100% rename from docs/subaccount/_category_.json rename to docs/splits/subaccount/_category_.json diff --git a/docs/subaccount/how-to-create-charge-with-splits-to-subaccount-using-api.mdx b/docs/splits/subaccount/how-to-create-charge-with-splits-to-subaccount-using-api.mdx similarity index 100% rename from docs/subaccount/how-to-create-charge-with-splits-to-subaccount-using-api.mdx rename to docs/splits/subaccount/how-to-create-charge-with-splits-to-subaccount-using-api.mdx diff --git a/docs/splits/subaccount/how-to-create-charge-with-splits-with-plugin.mdx b/docs/splits/subaccount/how-to-create-charge-with-splits-with-plugin.mdx new file mode 100644 index 00000000..592b3223 --- /dev/null +++ b/docs/splits/subaccount/how-to-create-charge-with-splits-with-plugin.mdx @@ -0,0 +1,104 @@ +--- +id: how-to-create-charge-with-splits-with-plugin +title: Como usar o Plugin JS para criar uma cobrança com split para Subconta? +tags: + - concept + - api + - subaccount +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +:::info +Para a utilização desta funcionalidade é necessário possuir a funcionalidade Subconta +::: + +Para criar uma cobrança Pix com split para sub conta, você precisa informar no plugin.js o array de splits a serem realizados na cobrança. + +Os campos obrigatórios para criar uma cobrança Pix com Split são os seguintes: + +- **`value`**: O valor em `centavos` da cobrança Pix a ser criado. +- **`correlationID`**: Um identificador único para a cobrança Pix. [CorrelationID](../concepts/correlation-id) +- **`splits`**: Um array contendo as configurações de split realizado na hora do recebimento. + +## Exemplo + +O body da sua requisição será semelhante a este exemplo: + +```javascript +function displayOpenPixModal() { + window.$openpix = window.$openpix || []; + + window.$openpix.push([ + 'config', + { + appID: 'yourOpenPixAppId', + }, + ]); + + window.$openpix.push([ + 'pix', + { + value: 100, // R$ 1,00 + correlationID: 'c782e0ac-833d-4a89-9e73-9b60b2b41d3a', + splits: [ + { + pixKey: 'destinatario@openpix.com.br', // chave pix da subconta + value: 15, // valor a ser splitado em centavos (R$ 0,15) + splitType: 'SPLIT_SUB_ACCOUNT', // tipo de split (não alterar) + }, + ], + }, + ]); +} +``` + +O valor do campo `value` dentro do objeto no array de `splits`, é o valor desejado para a realização do split em **centavos**. O valor do split não será debitado da conta de origem pois transações de split para sub contas são transações virtuais, somente será debitado da conta de origem o valor integral do saldo da sub conta no momento do saque da mesma. + +Após efetuar a requisição, se tudo ocorreu bem, o plugin exibirá normalmente o qrcode. Caso haja algum erro sintático(formato) no array de splits irá exibir um erro no modal do plugin. + +### Exemplos em código + +```html + + + + + Open Pix + + + + + + + +``` diff --git a/docs/subaccount/how-to-get-balance-and-detais-of-subaccount-using-api.mdx b/docs/splits/subaccount/how-to-get-balance-and-detais-of-subaccount-using-api.mdx similarity index 88% rename from docs/subaccount/how-to-get-balance-and-detais-of-subaccount-using-api.mdx rename to docs/splits/subaccount/how-to-get-balance-and-detais-of-subaccount-using-api.mdx index e9a6a890..4b82a75f 100644 --- a/docs/subaccount/how-to-get-balance-and-detais-of-subaccount-using-api.mdx +++ b/docs/splits/subaccount/how-to-get-balance-and-detais-of-subaccount-using-api.mdx @@ -1,6 +1,6 @@ --- id: how-to-get-balance-and-details-of-subaccount-using-api -title: Como acessar saldo e detalhes de uma Subconta via API? +title: Como acessar saldo e detalhes de uma Subconta via API? tags: - api - subaccount @@ -16,15 +16,13 @@ Para a utilização desta funcionalidade é necessário possuir a funcionalidade Para acessar o saldo e detalhes de uma subconta, você utiliza o _endpoint_ `/api/v1/subaccount/{ID}` da API. - -Você pode acessar [aqui](https://developers.openpix.com.br/api#tag/sub-account-(request-access)/paths/~1api~1v1~1subaccount~1%7Bid%7D/get) +Você pode acessar [aqui]() a documentação referente a esse _endpoint_. A chave pix registrada na subconta deve ser passada na url da requisição como parâmetro. Após efetuar a requisição, se tudo ocorreu bem, o _status code_ da requisição será `2xx` e no `body` da resposta, uma objeto contendo os campos de balance, name, pixKey da subconta requisitada. - ### Exemplos em código ```mdx-code-block @@ -62,7 +60,6 @@ fetch('https://api.openpix.com.br/api/v1/subaccount/chave-pix-subconta', { ### Exemplos de resposta - ```jsx { "SubAccount": { @@ -72,5 +69,3 @@ fetch('https://api.openpix.com.br/api/v1/subaccount/chave-pix-subconta', { } } ``` - - diff --git a/docs/subaccount/how-to-list-subaccounts-of-company-using-api.mdx b/docs/splits/subaccount/how-to-list-subaccounts-of-company-using-api.mdx similarity index 100% rename from docs/subaccount/how-to-list-subaccounts-of-company-using-api.mdx rename to docs/splits/subaccount/how-to-list-subaccounts-of-company-using-api.mdx diff --git a/docs/subaccount/how-to-withdraw-fom-subaccount-using-api.mdx b/docs/splits/subaccount/how-to-withdraw-fom-subaccount-using-api.mdx similarity index 77% rename from docs/subaccount/how-to-withdraw-fom-subaccount-using-api.mdx rename to docs/splits/subaccount/how-to-withdraw-fom-subaccount-using-api.mdx index 0861124d..9fc6510f 100644 --- a/docs/subaccount/how-to-withdraw-fom-subaccount-using-api.mdx +++ b/docs/splits/subaccount/how-to-withdraw-fom-subaccount-using-api.mdx @@ -16,14 +16,12 @@ Para a utilização desta funcionalidade é necessário possuir a funcionalidade Para realizar o saque integral de uma subconta, você utiliza o _endpoint_ `/api/v1/subaccount/{ID}/withdraw` da API. - -Você pode acessar [aqui](https://developers.openpix.com.br/api#tag/sub-account-(request-access)/paths/~1api~1v1~1subaccount~1%7Bid%7D/get) +Você pode acessar [aqui]() a documentação referente a esse _endpoint_. A chave pix registrada na subconta deve ser passada na url da requisição como parâmetro. -Após efetuar a requisição, se tudo ocorreu bem, o _status code_ da requisição será `2xx` e no `body` da resposta, um objeto com os detalhes da transação efetuada para a chave pix registrada na subconta. - +Após efetuar a requisição, se tudo ocorreu bem, o _status code_ da requisição será `2xx` e no `body` da resposta, um objeto com os detalhes da transação efetuada para a chave pix registrada na subconta. ### Exemplos em código @@ -46,13 +44,16 @@ Após efetuar a requisição, se tudo ocorreu bem, o _status code_ da requisiç ``` ```js -fetch('https://api.openpix.com.br/api/v1/subaccount/chave-pix-subconta/withdraw', { - method: 'POST', - headers: { - Authorization: 'AUTHORIZATION', - 'Content-Type': 'application/json', +fetch( + 'https://api.openpix.com.br/api/v1/subaccount/chave-pix-subconta/withdraw', + { + method: 'POST', + headers: { + Authorization: 'AUTHORIZATION', + 'Content-Type': 'application/json', + }, }, -}).then((res) => res.json()); +).then((res) => res.json()); ``` ```mdx-code-block @@ -60,9 +61,7 @@ fetch('https://api.openpix.com.br/api/v1/subaccount/chave-pix-subconta/withdraw' ``` - - -### Exemplos de resposta +### Exemplos de resposta ```jsx { diff --git a/docs/splits/subaccount/split-sub-account-usecases.mdx b/docs/splits/subaccount/split-sub-account-usecases.mdx new file mode 100644 index 00000000..ebbb240e --- /dev/null +++ b/docs/splits/subaccount/split-sub-account-usecases.mdx @@ -0,0 +1,48 @@ +--- +id: split-sub-account-usecases +title: Casos de uso de split de sub-contas +tags: + - concept + - api +--- + +```mdx-code-block +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +``` + +:::info +Para a utilização dessa funcionalidade é necessário possuir a funcionalidade Split +::: + +## Casos de uso de split de sub-contas + +O split de sub-contas é uma funcionalidade que permite que o recebimento de uma cobrança seja dividido entre chaves pix. Entenda mais aqui: [O que é um split](../what-is-split#split-de-sub-contas-split_sub_account) + +:::info +Entenda melhor sobre qual tipo de split utilizar [aqui](../when-to-use-split-sub-account-or-partner#Quando usar o sistema de subcontas) +::: + +### Caso de uso 1 - Dividir o valor entre os sócios da empresa + +Imagine que você tem uma empresa com 3 sócios e deseja dividir o valor de uma cobrança entre eles. Para isso, você pode criar uma cobrança pix com split de sub-contas, onde o valor da cobrança será dividido entre as chaves pix dos sócios, isso facilita a divisão do valor entre os sócios, economizando tempo e evitando erros. + +#### Como dividir o valor entre os sócios da empresa via API + +Para dividir o valor entre os sócios da empresa via API, você deve utilizar o _endpoint_ `/api/v1/charge` da API. + +Para a API é necessário enviar o campo `splits` no body da requisição, que é um array contendo as configurações de split realizado na hora do recebimento com os valores fixos já definidos, ou seja, seu sistema deve definir o valor que vai para cada chave pix e informar na api da OpenPix. + +### Caso de uso 2 - Gorjeta + +Administradores de empresas do ramo de alimentação como restaurantes e bares podem cadastrar chave pix de garçons e atendentes como uma subconta e configurar valores +por cobrança a serem registrados como crédito, podendo então ser sacado a qualquer momento por integração via API ou diretamente pela plataforma. + +### Caso de uso 3 - Comissão para vendedores + +Gestores de comércio podem cadastrar vendedores através da chave pix do vendendor como subconta e assim gerenciar cada cobrança, para creditar valroes de comissão automaticamente podendo fazer os saque a qualquer momento por integração via API ou diretamente pela plataforma. + +## MarketPlace + +Gestores de MarketPlace digitais podem criar cobranças com chave pix cadastrada como subconta, registrando assim em cada cobrança paga o valor da comissão por venda +relacionada a vendas dentro de seu marketplace. Esta integração permite a gestores um gerenciamento de valores automático e facilidade na gestão e no pagamento de valores ao longo do tempo. O saque pode ser feito por integração via api ou diretamente pela plataforma. diff --git a/docs/subaccount/sub-account-use-cases.md b/docs/subaccount/sub-account-use-cases.md deleted file mode 100644 index 045f740b..00000000 --- a/docs/subaccount/sub-account-use-cases.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -id: sub-account-use-cases -title: Casos de uso para Subcontas -tags: - - api - - conceito - - sub-conta - - casos ---- - -## Gorjeta - -Administradores de empresas do ramo de alimentação como restaurantes e bares podem cadastrar chave pix de garçons e atendentes como uma subconta e configurar valores -por cobrança a serem registrados como crédito, podendo então ser sacado a qualquer momento por integração via API ou diretamente pela plataforma. - -## Comissão - -Gestores de comércio podem cadastrar vendedores através da chave pix com subcontas e assim gerenciar cada cobrança, para creditar valroes de comissão automaticamente -podendo fazer os saque a qualquer momento por integração via API ou diretamente pela plataforma. - -## MarketPlace - -Gestores de MarketPlace digitais podem criar cobranças com chave pix cadastrada como subconta, registrando assim em cada cobrança paga o valor da comissão por venda -relacionada a vendas dentro de seu marketplace. Esta integração permite a gestores um gerenciamento de valores automático e facilidade na gestão e no pagamento de valores ao longo do tempo. O saque pode ser feito por integração via api ou diretamente pela plataforma. diff --git a/docs/subaccount/sub-account.md b/docs/subaccount/sub-account.md deleted file mode 100644 index 06af69ce..00000000 --- a/docs/subaccount/sub-account.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -id: sub-account -title: Sub Conta -tags: - - api - - conceito - - sub-conta ---- - -## Sub Conta - -Sub contas são contas virtuais representadas por uma chave pix que podem transacionar virtualmente valores através do sistema de split de pagamentos. Esses valores podem ser convertidos em transações reais através do saque para a chave pix registrada para a subconta. diff --git a/docs/subaccount/when-to-use-subaccount-or-partner.md b/docs/subaccount/when-to-use-subaccount-or-partner.md deleted file mode 100644 index 482a7988..00000000 --- a/docs/subaccount/when-to-use-subaccount-or-partner.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -id: sub-account-or-partner -title: Quando usar o sistema de Parceiro e Subcontas -tags: - - api - - conceito - - sub-conta - - casos - - partner ---- - -## Quando usar o sistema de Parceiro - -O sistema de parceiros permite a empresas registrar outras empresas como afiliados e gerenciar alguns aspectos do seu funcionamento através das apis e plataforma openpix. -Cada afiliado passa pelo processo de abertura de contas na plataforma. -Cada afiliado possúi conta virtual na plataforma registrada no cnpj de sua empresa independente do parceiro. -Cada afiliado recebe valores de cobranças diretamente via pix em sua conta virtual registrada na plataforma. -O parceiro não recebe diretamente valores em sua conta, sómente taxa do parceiro perante o uso da feature de split partner. - -Esta feature é indicada para quem quer ter uma relação mais definida entre parceiro e afiliados e pretende envolver parceiros no cadastro completo de uma conta virtual -requisitando assim dados de registro de empresa e sócios como qualquer outra abertura de contas, não recebendo diretamente em suas contas valores relativos a pagamento feitos por afiliados, somente valores relativos a taxa de parceiros. - -## Quando usar o sistema de subcontas - -O sistema de subcontas permite registrar transações de split em uma subconta a partir de cobranças feitas para uma conta principal. Subcontas não são contas bancárias reais e somente transacionam valores virtuais permitindo assim a eliminação de etapas burocráticas na abertura da mesma. -Cada subconta só precisa de uma chave pix única para ser aberta. -Uma empresa pode ter qualquer número de subcontas. -Uma empresa pode a qualquer momento realizar um saque para a chave pix registrada na subconta, tanto via integração de API ou diretamente pela plataforma. - -O uso da subconta permite a criação de fluxos menos burocráticos e mais livres dentro da plataforma, os valores sacados só serão debitados da conta principal no momento do saque garantindo total controle ao administrador da empresa dona destas subcontas. diff --git a/docs/transfer/how-to-transfer-values-between-accounts.mdx b/docs/transfer/how-to-transfer-values-between-accounts.mdx index 96f9a2e0..fbf07aea 100644 --- a/docs/transfer/how-to-transfer-values-between-accounts.mdx +++ b/docs/transfer/how-to-transfer-values-between-accounts.mdx @@ -10,7 +10,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; :::info -Para a ultilização dessa funcionalidade é necessário possuir a funcionalidade BETA +Para a utilização dessa funcionalidade é necessário possuir a funcionalidade BETA ::: Para transferir valores entre suas contas você por utilizar o _endpoint_ `/api/v1/transfer` da API.