Skip to main content
POST
/
sub-accounts
Criar sub-conta
curl --request POST \
  --url https://dev.plugtopay.com/api/v1/sub-accounts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Client-ID: <api-key>' \
  --data '
{
  "name": "Vendedor Exemplo",
  "document": "12345678000195",
  "document_type": "cnpj",
  "email": "vendedor@example.com"
}
'
{
  "id": 42,
  "name": "Vendedor Exemplo",
  "document": "12345678000195"
}

Authorizations

​
X-Client-ID
string
header
required

Identificador público do cliente (integração servidor-a-servidor). Usado em conjunto com X-API-Key.

​
X-API-Key
string
header
required

Chave secreta de API (integração servidor-a-servidor). Usada em conjunto com X-Client-ID.

Body

application/json
​
name
string
required
Example:

"Vendedor Exemplo"

​
document
string
required

CPF (11) ou CNPJ (14) dígitos.

Example:

"12345678000195"

​
document_type
enum<string>
required

Tipo de documento do recebedor.

Available options:
cpf,
cnpj
Example:

"cnpj"

​
email
string<email>
required
Example:

"vendedor@example.com"

Response

Sub-conta criada.

​
id
integer
required
Example:

42

​
name
string
required
Example:

"Vendedor Exemplo"

​
document
string
required
Example:

"12345678000195"