Retrait

PostAuthentification requise

Retire des fonds du compte du client authentifié via un agent de paiement. Le retrait transfère le montant demandé hors du Wallet du client vers le Wallet de l'agent - l'agent règle ensuite la valeur équivalente avec le client en dehors de Deriv. Nécessite un verification_code à 6 chiffres obtenu via POST /payment-agents/v1/withdraw/verification_code. Les retraits débutent en statut pending et évoluent vers complete, rejected ou failed. Fournissez un request_id facultatif pour suivre le statut ultérieurement via GET /payment-agents/v1/withdraw/{request_id}.

Point de terminaison

Post/payment-agents/v1/withdraw

URL de base : https://api.derivws.com

Codes de statut

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.

Réponses d'erreur

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

Authentification requise

Cet endpoint nécessite un token Bearer. Lors de l'authentification avec un Personal Access Token (PAT), l'en-tête Deriv-App-ID est requis pour identifier votre application (Authentication). Portée OAuth2 : payment

À propos de Retrait

Le point de terminaison POST /payment-agents/v1/withdraw : Retire des fonds du compte du client authentifié via un agent de paiement. Le retrait transfère le montant demandé hors du Wallet du client vers le Wallet de l'agent - l'agent règle ensuite la valeur équivalente avec le client en dehors de Deriv. Nécessite un verification_code à 6 chiffres obtenu via POST /payment-agents/v1/withdraw/verification_code. Les retraits débutent en statut pending et évoluent vers complete, rejected ou failed. Fournissez un request_id facultatif pour suivre le statut ultérieurement via GET /payment-agents/v1/withdraw/{request_id}.

Code de vérification de retrait Statut du retrait

D'autres questions ? Nous contacter