Documentação
Agente de Pagamento

Código de Verificação de Levantamento

PostAutenticação necessária

Solicita o envio de um código de verificação de utilização única para o contacto registado do cliente (e-mail ou telefone). Chame este endpoint antes de submeter um levantamento via POST /payment-agents/v1/withdraw — o código deve ser incluído como verification_code nesse pedido. O código é válido até expires_at (segundos de época). Não é possível solicitar um novo código antes de next_request_at (segundos de época). As mesmas verificações de elegibilidade do agente e de regras de negócio que protegem o POST /payment-agents/v1/withdraw também são executadas aqui — se este pedido for bem-sucedido, o levantamento subsequente não falhará essas verificações. Consulte a resposta 400 para a lista completa de códigos de erro.

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.

Respostas de Erro

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 Verificação de Levantamento

O endpoint POST /payment-agents/v1/withdraw/verification_code: Solicita o envio de um código de verificação de utilização única para o contacto registado do cliente (e-mail ou telefone). Chame este endpoint antes de submeter um levantamento via POST /payment-agents/v1/withdraw — o código deve ser incluído como verification_code nesse pedido. O código é válido até expires_at (segundos de época). Não é possível solicitar um novo código antes de next_request_at (segundos de época). As mesmas verificações de elegibilidade do agente e de regras de negócio que protegem o POST /payment-agents/v1/withdraw também são executadas aqui — se este pedido for bem-sucedido, o levantamento subsequente não falhará essas verificações. Consulte a resposta 400 para a lista completa de códigos de erro.

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