Antecipação de Recebíveis - Pedir

POST /v1/anticipations

Cria o pedido. Dentro do teto de aprovação automática, o dinheiro cai no saldo disponível na mesma chamada (status: "executed"). Acima dele, o pedido fica requested até a Selectwin aprovar — você recebe anticipation.executed ou anticipation.rejected pelo webhook.

#Precauções

• Dinheiro: a antecipação move dinheiro para o seu saldo disponível. Numa sessão do painel exige o segundo fator (como o saque); por chave de API, a chave precisa poder criar saques (withdrawals:create).
• Cote antes: use Cotar com o mesmo corpo — a resposta diz a taxa e se o pedido será automático.
• Idempotência: envie sempre o header X-Idempotency-Key (um UUID por pedido); um reenvio devolve o mesmo pedido.
• Tudo ou nada: se um recebível mudar entre o pedido e a execução (estorno, disputa, liberação), o pedido inteiro é recusado (409 anticipationReceivableChanged) — peça de novo com o que sobrou.

#Requisição

curl -X POST "https://api.selectwin.io/v1/anticipations" \
  -H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ" \
  -H "X-Idempotency-Key: 6f1c2a1e-7d1d-4b1e-9a6b-2b1c7a2d3e4f" \
  -H "Content-Type: application/json" \
  -d '{ "receivableIds": ["rec_01hqzvabc", "rec_01hqzvabd"] }'

O corpo é o mesmo da cotação: receivableIds[], untilExpectedOn ou all: true.

#Resposta 201 Created

O objeto do pedido (veja Visão Geral), com status executed (automático) ou requested (aguardando).

#Respostas de Erro