Início rápido
1. Crie a oferta
Seção intitulada “1. Crie a oferta”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.
2. Crie a chave de API
Seção intitulada “2. Crie a chave de API”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.
export SULY_KEY='suly_…'3. Teste a conexão
Seção intitulada “3. Teste a conexão”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.
4. Dê códigos aos criadores
Seção intitulada “4. Dê códigos aos criadores”Leia os criadores que estão aguardando um código:
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:
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.
5. Pague
Seção intitulada “5. Pague”Quando o seu sistema tiver calculado quanto um criador ganhou, envie um crédito com o seu próprio número da operação:
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.
Uma integração típica
Seção intitulada “Uma integração típica”- A cada 5–15 minutos: leia os participantes
pendinge dê a cada um um código e um link (ou recuse). - No seu calendário de pagamentos: confira o orçamento com
GET /programe depois envie um crédito por criador. - 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.
- Conciliação: compare
GET /accrualscom os seus próprios pagamentos peloexternalId.