Transfert (Dépôt)

PostAuthentification requise

Permet à un agent de paiement authentifié de déposer des fonds directement dans le Wallet Deriv d'un client, identifié par le surnom de son compte (to_nickname). En cas de succès, renvoie un TransferResult - statut "complete" avec un transaction_id pour un transfert réel, statut "pending" avec transaction_id null si le transfert est toujours en cours de traitement (interrogez GET /payment-agents/v1/transfer/{request_id} avec le request_id fourni pour le statut final), ou statut "dry_run_ok" avec transaction_id null lorsque dry_run est true. client_real_name et client_is_agent décrivent le destinataire.

Point de terminaison

Post/payment-agents/v1/transfer

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

Codes de statut

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.

Réponses d'erreur

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

Authentification requise

Cet endpoint nécessite un token Bearer. Lors de l'authentification avec un Personal Access Token (PAT), l'en-tête Deriv-App-ID est requis pour identifier votre application (Authentication). Portée OAuth2 : payment

À propos de Transfert (Dépôt)

Le point de terminaison POST /payment-agents/v1/transfer : Permet à un agent de paiement authentifié de déposer des fonds directement dans le Wallet Deriv d'un client, identifié par le surnom de son compte (to_nickname). En cas de succès, renvoie un TransferResult - statut "complete" avec un transaction_id pour un transfert réel, statut "pending" avec transaction_id null si le transfert est toujours en cours de traitement (interrogez GET /payment-agents/v1/transfer/{request_id} avec le request_id fourni pour le statut final), ou statut "dry_run_ok" avec transaction_id null lorsque dry_run est true. client_real_name et client_is_agent décrivent le destinataire.

Mettre à jour les paramètres du client Statut du transfert

D'autres questions ? Nous contacter