Pular para o conteúdo

Início rápido

No painel da marca, abra Ofertas → Criar oferta, escolha RevShare em “Como você paga os criadores?”, preencha o formulário e envie para moderação. O orçamento sai do seu saldo e entra na oferta. Veja todos os campos em Oferta de RevShare.

Depois que a oferta for aprovada, abra a página da oferta e crie a chave no bloco Chave de API. A chave é exibida uma única vez: copie-a para o seu cofre de segredos. Cada oferta tem sua própria chave.

Janela do terminal
export SULY_KEY='suly_…'
Janela do terminal
curl -s https://suly.gg/api/partner/v1/program \
-H "Authorization: Bearer $SULY_KEY"

Você recebe a oferta com o status, o orçamento e a taxa atual.

Leia os criadores que estão aguardando um código:

Janela do terminal
curl -s "https://suly.gg/api/partner/v1/participants?status=pending" \
-H "Authorization: Bearer $SULY_KEY"

Para cada um, crie um código de indicação e um link no seu sistema e envie-os:

Janela do terminal
curl -s https://suly.gg/api/partner/v1/participants/$ID/code \
-H "Authorization: Bearer $SULY_KEY" \
-H 'Content-Type: application/json' \
-d '{"code":"ANDRY","link":"https://partner.example/r/ANDRY"}'

O criador vê o código e o link na hora.

Quando o seu sistema tiver calculado quanto um criador ganhou, envie um crédito com o seu próprio número da operação:

Janela do terminal
curl -s https://suly.gg/api/partner/v1/accruals \
-H "Authorization: Bearer $SULY_KEY" \
-H 'Content-Type: application/json' \
-d '{"participantId":"'$ID'","amount":"125.40","externalId":"2026-10-ANDRY","comment":"October 2026"}'

Enviar a mesma requisição de novo com o mesmo externalId não paga nada em dobro, por isso é seguro repetir depois de um timeout.

  1. A cada 5–15 minutos: leia os participantes pending e dê a cada um um código e um link (ou recuse).
  2. No seu calendário de pagamentos: confira o orçamento com GET /program e depois envie um crédito por criador.
  3. Todos os dias e depois de cada pagamento: envie a cada criador uma nota com o que ele não consegue ver na suly.gg.
  4. Conciliação: compare GET /accruals com os seus próprios pagamentos pelo externalId.