Retirar

PostRequiere autenticación

Retira fondos de la cuenta del cliente autenticado a través de un agente de pago. El retiro traslada el monto solicitado fuera del Wallet del cliente y al Wallet del agente; el agente luego liquida el valor equivalente con el cliente fuera de Deriv. Requiere un verification_code de 6 dígitos obtenido mediante POST /payment-agents/v1/withdraw/verification_code. Los retiros comienzan como pendientes y pasan a completados, rechazados o fallidos. Proporcione un request_id opcional para rastrear el estado posteriormente a través de 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.

Respuestas de Error

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
  }
}

Requiere autenticación

Este endpoint requiere un token Bearer. Al autenticarse con un Token de Acceso Personal (PAT), el encabezado Deriv-App-ID es obligatorio para identificar su aplicación (Authentication). Alcance OAuth2: payment

Acerca de Retirar

El endpoint POST /payment-agents/v1/withdraw: Retira fondos de la cuenta del cliente autenticado a través de un agente de pago. El retiro traslada el monto solicitado fuera del Wallet del cliente y al Wallet del agente; el agente luego liquida el valor equivalente con el cliente fuera de Deriv. Requiere un verification_code de 6 dígitos obtenido mediante POST /payment-agents/v1/withdraw/verification_code. Los retiros comienzan como pendientes y pasan a completados, rechazados o fallidos. Proporcione un request_id opcional para rastrear el estado posteriormente a través de GET /payment-agents/v1/withdraw/{request_id}.

Código de Verificación de Retiro Estado del retiro

¿Alguna otra pregunta? Póngase en contacto