Documentation
Agent de paiement

Code de vérification de retrait

PostAuthentification requise

Demande l'envoi d'un code de vérification à usage unique au contact enregistré du client (e-mail ou téléphone). Appelez ceci avant de soumettre un retrait via POST /payment-agents/v1/withdraw - le code doit être inclus en tant que verification_code dans cette requête. Le code est valide jusqu'à expires_at (secondes epoch). Un nouveau code ne peut pas être demandé avant next_request_at (secondes epoch). Les mêmes vérifications d'éligibilité des agents et de règles métier qui protègent POST /payment-agents/v1/withdraw s'appliquent également ici - si cette requête réussit, le retrait ultérieur ne sera pas bloqué par ces vérifications. Consultez la réponse 400 pour la liste complète des codes d'erreur.

Point de terminaison

Post/payment-agents/v1/withdraw/verification_code

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

Codes de statut

200OK - Verification code dispatched. Returns next_request_at and expires_at.
400Bad request - One of: InvalidAgentID, AgentIDNotFound, AgentInactive, AgentSelfWithdraw, AgentCurrencyUnsupported, ClientCountryUnsupported, WithdrawalAmountMinimum, WithdrawalAmountMaximum, DailyWithdrawalCountLimit, DailyWithdrawalAmountLimit, InvalidCurrency, InvalidAmount, OtpRateLimitExceeded, InputError, ClientWithdrawDisabled, AgentDepositDisabled.
401Unauthorized - Invalid or missing authentication.
403Forbidden - Valid token but insufficient scope (payment scope required).
500Internal server error - One of: VerificationCodeRequestFailed, InternalError.
504Gateway timeout - Upstream service unavailable.

Réponses d'erreur

400Bad request - rate limit exceeded
{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "OtpRateLimitExceeded",
      "detail": {
        "message": "Too many OTP requests. Please try again later.",
        "next_request_at": 1781547816
      }
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/withdraw/verification_code",
    "method": "POST",
    "timing": 11
  }
}

À propos de Code de vérification de retrait

Le point de terminaison POST /payment-agents/v1/withdraw/verification_code : Demande l'envoi d'un code de vérification à usage unique au contact enregistré du client (e-mail ou téléphone). Appelez ceci avant de soumettre un retrait via POST /payment-agents/v1/withdraw - le code doit être inclus en tant que verification_code dans cette requête. Le code est valide jusqu'à expires_at (secondes epoch). Un nouveau code ne peut pas être demandé avant next_request_at (secondes epoch). Les mêmes vérifications d'éligibilité des agents et de règles métier qui protègent POST /payment-agents/v1/withdraw s'appliquent également ici - si cette requête réussit, le retrait ultérieur ne sera pas bloqué par ces vérifications. Consultez la réponse 400 pour la liste complète des codes d'erreur.

Click to open live chat support. Get instant help from our support team.