Documentación
Agente de Pago

Código de Verificación de Retiro

PostRequiere autenticación

Solicita que se envíe un código de verificación de un solo uso al contacto registrado del cliente (correo electrónico o teléfono). Llame a este endpoint antes de enviar un retiro mediante POST /payment-agents/v1/withdraw — el código debe incluirse como verification_code en esa solicitud. El código es válido hasta expires_at (segundos epoch). No se puede solicitar un nuevo código antes de next_request_at (segundos epoch). Las mismas verificaciones de elegibilidad del agente y de reglas de negocio que protegen POST /payment-agents/v1/withdraw también se ejecutan aquí — si esta solicitud tiene éxito, el retiro posterior no fallará en dichas verificaciones. Consulte la respuesta 400 para obtener la lista completa de códigos de error.

Endpoint

Post/payment-agents/v1/withdraw/verification_code

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

Códigos de Estado

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.

Respuestas de Error

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

Acerca de Código de Verificación de Retiro

El endpoint POST /payment-agents/v1/withdraw/verification_code: Solicita que se envíe un código de verificación de un solo uso al contacto registrado del cliente (correo electrónico o teléfono). Llame a este endpoint antes de enviar un retiro mediante POST /payment-agents/v1/withdraw — el código debe incluirse como verification_code en esa solicitud. El código es válido hasta expires_at (segundos epoch). No se puede solicitar un nuevo código antes de next_request_at (segundos epoch). Las mismas verificaciones de elegibilidad del agente y de reglas de negocio que protegen POST /payment-agents/v1/withdraw también se ejecutan aquí — si esta solicitud tiene éxito, el retiro posterior no fallará en dichas verificaciones. Consulte la respuesta 400 para obtener la lista completa de códigos de error.

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