Criar conta virtual

Endpoint: POST /uniconta/seller/{account_id}/virtualaccounts/

Autenticação: obrigatória — JWT via Authorization: Bearer <access_token>. O usuário precisa ter acesso à account_id ou ser superusuário.

Não existe um POST direto nesta coleção. A chamada retorna 405 Method Not Allowed. As contas virtuais são criadas automaticamente pelo fluxo de auto-provisionamento descrito abaixo.

Uma conta virtual não é um recurso criado pelo usuário. Ela é a sub-razão financeira que dá suporte a uma sub-conta, e é provisionada automaticamente na primeira vez em que é consultada.

Como provisionar uma conta virtual

Faça uma chamada ao endpoint de detalhe com pk igual ao id da sub-conta:

GET /uniconta/seller/{sub_account_id}/virtualaccounts/{sub_account_id}/

Quando o endpoint detecta que account_id == pk, ele aciona a rotina de auto-provisionamento. O processo:

Verifica se a conta é uma sub-conta. Caso contrário, retorna erro de validação.
Localiza a conta gerenciada do pai (se existir) e a vincula automaticamente.
Cria a conta virtual com o id igual ao id da sub-conta. A operação é idempotente — chamadas subsequentes retornam o registro existente e só preenchem o vínculo de conta gerenciada caso ainda esteja ausente.

Após o provisionamento, a mesma chamada de detalhe passa a retornar os dados completos da conta virtual (incluindo o balance atual).

Pré-requisitos

A conta do vendedor existe e é uma sub-conta (possui um pai).
O usuário tem acesso à sub-conta (vínculo de acesso legado) ou é superusuário.

Erros

Status	Quando
`405`	Foi enviado um `POST` para esta URL. Utilize o fluxo de detalhe descrito acima.
`400`	A conta não é uma sub-conta.
`403`	O usuário não tem acesso à `account_id`.

Exemplo: disparar o provisionamento

curl https://api.dlpay.cloud/uniconta/seller/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/virtualaccounts/9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..."

import requests

account_id = "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10"
response = requests.get(
    f"https://api.dlpay.cloud/uniconta/seller/{account_id}/virtualaccounts/{account_id}/",
    headers={"Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJh..."},
)
virtual_account = response.json()

const accountId = "9c2a1f3e-7d8b-4a1c-9f2e-0b6a5d4c1e10";
const response = await fetch(
  `https://api.dlpay.cloud/uniconta/seller/${accountId}/virtualaccounts/${accountId}/`,
  { headers: { Authorization: "Bearer eyJ0eXAiOiJKV1QiLCJh..." } }
);
const virtualAccount = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Como provisionar uma conta virtual

Pré-requisitos

Erros

Exemplo: disparar o provisionamento

​Como provisionar uma conta virtual

​Pré-requisitos

​Erros

​Exemplo: disparar o provisionamento

Como provisionar uma conta virtual

Pré-requisitos

Erros

Exemplo: disparar o provisionamento