Levantamento

PostAutenticação necessária

Levanta fundos da conta do cliente autenticado através de um agente de pagamento. O levantamento move o valor solicitado da Wallet do cliente para a Wallet do agente — o agente liquida então o valor equivalente com o cliente fora da Deriv. Requer um verification_code de 6 dígitos obtido a partir de POST /payment-agents/v1/withdraw/verification_code. Os levantamentos começam como pendentes e passam para concluído, rejeitado ou falhado. Forneça um request_id opcional para acompanhar o estado posteriormente via GET /payment-agents/v1/withdraw/{request_id}.

Endpoint

Post/payment-agents/v1/withdraw

URL Base: https://api.derivws.com

Códigos de Estado

200OK - Withdrawal accepted. Returns the transaction status (typically pending).

400Bad request - One of: InvalidAgentID, AgentIDNotFound, AgentInactive, AgentSelfWithdraw, AgentCurrencyUnsupported, VerificationCodeFormatInvalid, NoClientWallet, ClientCountryUnsupported, WithdrawalAmountMinimum, WithdrawalAmountMaximum, DailyWithdrawalCountLimit, DailyWithdrawalAmountLimit, WalletFundsInsufficient, InvalidCurrency, InvalidAmount, InvalidRequestIDFormat, RequestIDUsed, InvalidOTP, OtpValidationRateLimitExceeded, InputError, ClientWithdrawDisabled, AgentDepositDisabled.

401Unauthorized - Invalid or missing authentication.

403Forbidden - Valid token but insufficient scope (payment scope required).

500Internal server error - One of: ClientIdentityLookupFailed, WalletLookupFailed, WithdrawalFailed, OTPValidationFailed, InternalError.

504Gateway timeout - Upstream service unavailable.

Respostas de Erro

400Bad request - invalid verification code

{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "InvalidOTP",
      "detail": { "message": "Invalid OTP" }
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/withdraw",
    "method": "POST",
    "timing": 19
  }
}

400Bad request - amount below minimum

{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "WithdrawalAmountMinimum",
      "detail": { "message": "Amount is below the agent's minimum withdrawal limit" }
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/withdraw",
    "method": "POST",
    "timing": 16
  }
}

Autenticação Necessária

Este endpoint requer um token Bearer. Ao autenticar com um Personal Access Token (PAT), o cabeçalho Deriv-App-ID é obrigatório para identificar a sua aplicação (Authentication). Âmbito OAuth2: payment

Acerca de Levantamento

O endpoint POST /payment-agents/v1/withdraw: Levanta fundos da conta do cliente autenticado através de um agente de pagamento. O levantamento move o valor solicitado da Wallet do cliente para a Wallet do agente — o agente liquida então o valor equivalente com o cliente fora da Deriv. Requer um verification_code de 6 dígitos obtido a partir de POST /payment-agents/v1/withdraw/verification_code. Os levantamentos começam como pendentes e passam para concluído, rejeitado ou falhado. Forneça um request_id opcional para acompanhar o estado posteriormente via GET /payment-agents/v1/withdraw/{request_id}.

Código de Verificação de Levantamento Estado de Levantamento

Alguma outra questão? Entrar em contacto