Documentação
Agente de Pagamento

Transferência (Depósito)

PostAutenticação necessária

Permite que um agente de pagamento autenticado deposite fundos diretamente na Wallet Deriv de um cliente, identificado pelo seu nome de utilizador (to_nickname). Em caso de sucesso, devolve um TransferResult - estado "complete" com um transaction_id para uma transferência real, estado "pending" com transaction_id nulo se a transferência ainda estiver a ser processada (consulte GET /payment-agents/v1/transfer/{request_id} com o request_id fornecido para o estado final), ou estado "dry_run_ok" com transaction_id nulo quando dry_run é verdadeiro. client_real_name e client_is_agent descrevem o destinatário.

Endpoint

Post/payment-agents/v1/transfer

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

Códigos de Estado

200OK - Transfer completed, or validated in dry-run mode. Returns a TransferResult.
400Bad request - One of: AgentIDNotFound, AgentInactive, AgentSelfTransfer, TransferToAgentNotAllowed, TransferAgentCurrencyUnsupported, AgentCurrencyUnsupported, NicknameNotFound, NoClientWallet, WalletDisabled, DepositDisabled, ClientCountryUnsupported, WithdrawalAmountMinimum, WithdrawalAmountMaximum, WalletFundsInsufficient, DailyTransferCountLimit, DailyTransferAmountLimit, InvalidCurrency, InvalidAmount, InvalidRequestIDFormat, RequestIDUsed, InputError, ClientDepositDisabled, AgentWithdrawDisabled.
401Unauthorized - Invalid or missing authentication.
403Forbidden - Valid token but insufficient scope (payment scope required).
500Internal server error - One of: NicknameLookupFailed, WalletLookupFailed, TransferFailed, InternalError.
504Gateway timeout - Upstream service unavailable.

Respostas de Erro

400Bad request - insufficient funds
{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "WalletFundsInsufficient",
      "detail": { "message": "The agent's wallet does not hold enough funds for this transfer" }
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/transfer",
    "method": "POST",
    "timing": 38
  }
}
400Bad request - duplicate request_id
{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "RequestIDUsed",
      "detail": { "message": "The request_id has already been used" }
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/transfer",
    "method": "POST",
    "timing": 14
  }
}

Acerca de Transferência (Depósito)

O endpoint POST /payment-agents/v1/transfer: Permite que um agente de pagamento autenticado deposite fundos diretamente na Wallet Deriv de um cliente, identificado pelo seu nome de utilizador (to_nickname). Em caso de sucesso, devolve um TransferResult - estado "complete" com um transaction_id para uma transferência real, estado "pending" com transaction_id nulo se a transferência ainda estiver a ser processada (consulte GET /payment-agents/v1/transfer/{request_id} com o request_id fornecido para o estado final), ou estado "dry_run_ok" com transaction_id nulo quando dry_run é verdadeiro. client_real_name e client_is_agent descrevem o destinatário.

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