Transferencia (Depósito)

PostRequiere autenticación

Permite que un agente de pago autenticado deposite fondos directamente en la Wallet de Deriv de un cliente, identificado por su apodo de cuenta (to_nickname). En caso de éxito, devuelve un TransferResult: estado "complete" con un transaction_id para una transferencia real, estado "pending" con transaction_id nulo si la transferencia aún está siendo procesada (consulte GET /payment-agents/v1/transfer/{request_id} con el request_id proporcionado para el estado final), o estado "dry_run_ok" con transaction_id nulo cuando dry_run es verdadero. client_real_name y client_is_agent describen al destinatario.

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.

Respuestas de Error

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

Requiere autenticación

Este endpoint requiere un token Bearer. Al autenticarse con un Token de Acceso Personal (PAT), el encabezado Deriv-App-ID es obligatorio para identificar su aplicación (Authentication). Alcance OAuth2: payment

Acerca de Transferencia (Depósito)

El endpoint POST /payment-agents/v1/transfer: Permite que un agente de pago autenticado deposite fondos directamente en la Wallet de Deriv de un cliente, identificado por su apodo de cuenta (to_nickname). En caso de éxito, devuelve un TransferResult: estado "complete" con un transaction_id para una transferencia real, estado "pending" con transaction_id nulo si la transferencia aún está siendo procesada (consulte GET /payment-agents/v1/transfer/{request_id} con el request_id proporcionado para el estado final), o estado "dry_run_ok" con transaction_id nulo cuando dry_run es verdadero. client_real_name y client_is_agent describen al destinatario.

Actualizar la Configuración del Cliente Estado de la transferencia

¿Alguna otra pregunta? Póngase en contacto