Cria um saque

POST/v1/withdrawals

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Corpo da requisição

amountintegerobrigatório
Valor a sacar, em centavos (debitado do saldo disponível no pedido).
walletIdstring
A conta bancária que o recebe. Omitida = a principal; a parte das vendas no Pix vai sempre para a chave Pix do seu próprio CPF/CNPJ.

Respostas

201Criado

idstringobrigatório
Identificador público (cash_…)
feeintegerobrigatório
Taxa do saque, em centavos.
_linksobject
Links para operações relacionadas, por ação (self, create, update, delete, list…).
amountintegerobrigatório
Valor sacado, em centavos.
methodstringobrigatóriopode ser nulo
Como é pago (ex.: pix, ted).
paidAtstringobrigatóriopode ser nulo
Quando foi pago; null até lá.
statusstringobrigatório
Status: pending, processing, paid, canceled, failed…
currencystringobrigatório
Moeda (ISO 4217).
merchantobject
A conta dona do recurso (o vendedor de registro).
+3 campos de merchant
- namestringobrigatóriopode ser nulo
  Nome fantasia da conta dona do recurso.
- merchantIdstringobrigatóriopode ser nulo
  Id público da conta dona do recurso (bus_…).
- isSubAccountbooleanobrigatório
  true quando o recurso pertence a uma sub-conta operada por uma plataforma de marketplace.
walletIdstringobrigatóriopode ser nulo
A conta bancária em que é pago; null quando pago na sua chave Pix.
createdAtstringobrigatório
Quando o recurso foi criado (ISO 8601, UTC).
updatedAtstringobrigatório
Quando o recurso foi atualizado pela última vez (ISO 8601, UTC).
approvedAtstringobrigatóriopode ser nulo
Quando foi aprovado para pagamento; null até lá.
transferCodestringobrigatóriopode ser nulo
Identificador da transferência no banco; null até ser pago.
receivingBankAccountobjectpode ser nulo
Retrato da conta bancária de destino, tirado quando o saque foi pedido.
+8 campos de receivingBankAccount
- typestringobrigatóriopode ser nulo
  Tipo da conta.
- pixKeystringobrigatóriopode ser nulo
  Chave Pix, quando pago a uma.
- bankCodestringobrigatóriopode ser nulo
  Código do banco.
- bankNamestringobrigatóriopode ser nulo
  Nome do banco.
- documentstringobrigatóriopode ser nulo
  CPF/CNPJ do titular.
- holderNamestringobrigatóriopode ser nulo
  Nome do titular da conta.
- accountNumberstringobrigatóriopode ser nulo
  Número da conta.
- routingNumberstringobrigatóriopode ser nulo
  Agência.

400Requisição inválida (validação)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

401Não autenticado (credencial ausente ou inválida)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

403Sem permissão

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

404Não encontrado

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

409Conflito (idempotência ou estado)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

422Regra de negócio impede o processamento

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

500Erro interno do servidor

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

AnteriorLista os saques PróximaPara onde os saques são pagos (o destino por chave Pix das vendas no Pix)

curl -X POST "https://api.selectwin.io/v1/withdrawals" \ -H "SelectKey: $SELECTWIN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000, "walletId": "wall_0a1b2c3d4e5f60718293" }'

{ "id": "cash_0a1b2c3d4e5f60718293", "fee": 5000, "_links": {}, "amount": 5000, "method": "string", "paidAt": "string", "status": "string", "currency": "BRL", "merchant": { "name": "Acme Ltda", "merchantId": "string", "isSubAccount": true }, "walletId": "wall_0a1b2c3d4e5f60718293", "createdAt": "string", "updatedAt": "string", "approvedAt": "string", "transferCode": "string", "receivingBankAccount": { "type": "string", "pixKey": "string", "bankCode": "string", "bankName": "string", "document": "string", "holderName": "JOAO SILVA", "accountNumber": "string", "routingNumber": "string" } }