Création d’un virement interne vers un autre compte

POST 
/api/withdrawal/internal-other

Crée un virement interne vers un autre compte Volet.com et renvoie la transaction créée.

Requête

application/json

Body

Corps de la requêteobligatoire

Données de création d’un virement interne vers un autre compte.

srcWalletIdstringnullable
ID du portefeuille source.
Exemple : USD880390848110
amountnumberobligatoire
Montant.
Valeurs possibles : >= 0
Exemple : 10.25
actionstringobligatoire
Action.
Valeurs possibles : [GIVE, GET]
Exemple : GIVE
notestringnullable
Note.
Valeurs possibles : <= 255 caractères
Exemple : Sandbox transfer note
srcCurrencystringnullable
Devise source.
Valeurs possibles : [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Exemple : USD
destWalletIdstringnullable
ID du portefeuille de destination.
Exemple : USD880390848110
destCurrencystringnullable
Devise de destination.
Valeurs possibles : [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Exemple : USD
destEmailstringnullable
E-mail du destinataire.
Exemple : [email protected]

Exemple

{
  "srcWalletId": "USD880390848110",
  "amount": 10.25,
  "action": "GIVE",
  "note": "Sandbox transfer note",
  "srcCurrency": "USD",
  "destWalletId": "USD880390848110",
  "destCurrency": "USD",
  "destEmail": "[email protected]"
}

Réponses

200

OK

application/json

Schéma

Schéma

transactionIduuid
ID de la transaction.
Exemple : 11111111-1111-4111-8111-111111111111
paymentMethodTypestring
Type de moyen de paiement.
Valeurs possibles : [INTERNAL_OTHERS]
Exemple : INTERNAL_OTHERS
transactionTypestring
Type de transaction.
Valeurs possibles : [INTERNAL_TRANSFER_OTHER]
Exemple : INTERNAL_TRANSFER_OTHER
statusstring
Statut.
Valeurs possibles : [PENDING, COMPLETED, CANCELED, REFUNDED]
Exemple : COMPLETED
directionstring
Sens.
Valeurs possibles : [DEPOSIT, WITHDRAWAL]
Exemple : DEPOSIT
transactionDirectionstring
Sens de la transaction.
Valeurs possibles : [INCOMING, OUTGOING, EXCHANGE]
Exemple : OUTGOING
currencystring
Devise.
Valeurs possibles : [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Exemple : USD
amountnumber
Montant.
Exemple : 10.25
createdAtdate-time

Date de création.

paymentScopestring
Périmètre du paiement.
Valeurs possibles : [MERCHANT_API]
Exemple : MERCHANT_API
orderIdstring
ID de la commande.
Exemple : ORDER_123456
walletSrcIdstring
ID du portefeuille source.
Exemple : USD880390848110
walletDestIdstring
ID du portefeuille de destination.
Exemple : USD880390848110
fullCommissionnumber
Frais totaux.
Exemple : 10.25
commentstring
Commentaire.
Exemple : Sandbox transfer note
cryptoCurrencyTxHashstring
Hash de la transaction crypto.
Exemple : 4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e
completedAtdate-time

Date de finalisation.

Exemple

{
  "transactionId": "11111111-1111-4111-8111-111111111111",
  "paymentMethodType": "INTERNAL_OTHERS",
  "transactionType": "INTERNAL_TRANSFER_OTHER",
  "status": "CREATED",
  "direction": "WITHDRAWAL",
  "transactionDirection": "OUTGOING",
  "currency": "USD",
  "amount": 10.25,
  "createdAt": "2026-01-15T10:30:00",
  "paymentScope": "MERCHANT_API",
  "orderId": "ORDER_123456",
  "walletSrcId": "USD880390848110",
  "walletDestId": "USD880390848110",
  "fullCommission": 10.25,
  "comment": "Sandbox transfer note",
  "cryptoCurrencyTxHash": "4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e",
  "completedAt": "2026-01-15T10:30:00"
}

400

Requête incorrecte. La requête est mal formée ou contient des paramètres non valides.

application/json

Schéma

Schéma

statusstringobligatoire
Statut de la réponse.
Valeurs possibles : [error]
Exemple : error
data objectobligatoire
Données de la réponse d’erreur.
errors object[]obligatoire
Liste des erreurs renvoyées pour la requête.
Array [
errorMessagestringobligatoire
Code d’erreur stable et lisible par machine.
Exemple : disabled
errorTypestringobligatoire
Catégorie de l’erreur.
Exemple : FORM
errorIdstringobligatoire
Identifiant court et unique de l’erreur pour le support et les journaux.
Exemple : errTest1234
errorDescriptionstringobligatoire
Description lisible de l’erreur.
Exemple : REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API
errorFieldstringnullable
Champ de la requête lié à l’erreur, le cas échéant.
Exemple : null
paramsobject[]obligatoire
Paramètres supplémentaires de l’erreur.
requestParamsobjectobligatoire
Paramètres de la requête enregistrés pour le diagnostic.
]

Exemple

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "disabled",
        "errorType": "FORM",
        "errorId": "errTest1234",
        "errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

401

Non autorisé. Les en-têtes d’authentification du marchand sont absents ou non valides.

application/json

Schéma

Schéma

statusstringobligatoire
Statut de la réponse.
Valeurs possibles : [error]
Exemple : error
data objectobligatoire
Données de la réponse d’erreur.
errors object[]obligatoire
Liste des erreurs renvoyées pour la requête.
Array [
errorMessagestringobligatoire
Code d’erreur stable et lisible par machine.
Exemple : userDoesNotExistException
errorTypestringobligatoire
Catégorie de l’erreur.
Exemple : GENERAL
errorIdstringobligatoire
Identifiant court et unique de l’erreur pour le support et les journaux.
Exemple : errTest1234
errorDescriptionstringobligatoire
Description lisible de l’erreur.
Exemple : NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]
errorFieldstringnullable
Champ de la requête lié à l’erreur, le cas échéant.
Exemple : null
paramsobject[]obligatoire
Paramètres supplémentaires de l’erreur.
requestParamsobjectobligatoire
Paramètres de la requête enregistrés pour le diagnostic.
]

Exemple

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "userDoesNotExistException",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

404

Introuvable. La ressource demandée n’existe pas.

application/json

Schéma

Schéma

statusstringobligatoire
Statut de la réponse.
Valeurs possibles : [error]
Exemple : error
data objectobligatoire
Données de la réponse d’erreur.
errors object[]obligatoire
Liste des erreurs renvoyées pour la requête.
Array [
errorMessagestringobligatoire
Code d’erreur stable et lisible par machine.
Exemple : resourceNotFound
errorTypestringobligatoire
Catégorie de l’erreur.
Exemple : GENERAL
errorIdstringobligatoire
Identifiant court et unique de l’erreur pour le support et les journaux.
Exemple : errTest1234
errorDescriptionstringobligatoire
Description lisible de l’erreur.
Exemple : Resource not found
errorFieldstringnullable
Champ de la requête lié à l’erreur, le cas échéant.
Exemple : null
paramsobject[]obligatoire
Paramètres supplémentaires de l’erreur.
requestParamsobjectobligatoire
Paramètres de la requête enregistrés pour le diagnostic.
]

Exemple

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "resourceNotFound",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Resource not found",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

500

Erreur interne du serveur. Erreur inattendue, contactez le support

application/json

Schéma

Schéma

statusstringobligatoire
Statut de la réponse.
Valeurs possibles : [error]
Exemple : error
data objectobligatoire
Données de la réponse d’erreur.
errors object[]obligatoire
Liste des erreurs renvoyées pour la requête.
Array [
errorMessagestringobligatoire
Code d’erreur stable et lisible par machine.
Exemple : internalServerError
errorTypestringobligatoire
Catégorie de l’erreur.
Exemple : GENERAL
errorIdstringobligatoire
Identifiant court et unique de l’erreur pour le support et les journaux.
Exemple : errTest1234
errorDescriptionstringobligatoire
Description lisible de l’erreur.
Exemple : Internal server error
errorFieldstringnullable
Champ de la requête lié à l’erreur, le cas échéant.
Exemple : null
paramsobject[]obligatoire
Paramètres supplémentaires de l’erreur.
requestParamsobjectobligatoire
Paramètres de la requête enregistrés pour le diagnostic.
]

Exemple

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "internalServerError",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Internal server error",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}