VamPay
VamPay
POST/splits

Criar Split

Cadastra uma conta VamPay para receber uma porcentagem de cada recebimento seu. O split começa ativo e vale a partir do próximo Pix que cair.

Body

CampoTipo
emailobrigatóriostring
percentobrigatórionumber
labelstring

Exemplo de Request

curlbash
curl -X POST "https://api.vampay.com.br/splits" \
  -H "X-API-Key: vampay_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "socio@email.com",
    "percent": 30,
    "label": "Sócio"
  }'

Resposta de Sucesso

201 Createdjson
{
  "success": true,
  "data": {
    "id": "6711f0c2a1b2c3d4e5f60718",
    "recipientName": "João Silva"
  }
}

Erros

StatusMensagem
400Informe o e-mail da conta VamPay do parceiro.
404Não encontramos uma conta VamPay com esse e-mail.
400Você não pode fazer split para a sua própria conta.
400Essa conta não pode receber split.
400Limite de 10 splits atingido.
400Você já tem um split para essa conta. Edite o existente.
400A porcentagem deve ser de 0,01% a 100%.
400A soma dos splits passaria de 100% (já usado: X%).