Transfer To Virement

POST

/v1/Transaction/TransferToVirement

Used to transfer funds between different wallets under the same business account.
Both the sender and recipient wallet numbers must belong to the same business account.
This operation is typically used for internal fund management between sub-wallets with different currencies or purposes.
Each transaction must include a unique ext_transaction_id.

You’ll get the token from 'https://idsuat.walletgate.io', and all API operations will go through https://stsapiuat.walletgate.io.
We’ll share the exact production domain details when the live environment setup begins.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successful response

Body

🔵301Duplicate

🔵300NotFound

🔵311Insufficient Balance

🔵303MustBeDifferentWallet

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/Transaction/TransferToVirement' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sender_wallet_number": "653321524",
    "amount": 20,
    "currency_code": "TRY",
    "description": "",
    "receiver_wallet_number": "2082574167",
    "hash_key": "",
    "ext_transaction_id": "52151334452411154215321521"
}'

Response Example

200 - Success

{
    "status": 0,
    "code": "100",
    "message": "İşlem başarılı",
    "payload": {
        "transaction_id": "2506049074193467463",
        "transaction_amount": 15.0,
        "payment_balance_movement": 0.0,
        "cash_balance_movement": 15.000000,
        "receiver_first_name": "test",
        "receiver_last_name": "",
        "receiver_account_number": "5323254930",
        "receiver_wallet_number": "1580552308",
        "sender_wallet_info": {
            "id": "4885009989840268301",
            "tenant_id": "0",
            "name": "",
            "account_number": "1083435530",
            "account_type": "Business",
            "created_date_utc": "2023-05-02T06:15:54.7662806+00:00",
            "updated_date_utc": null,
            "number": "1489061629",
            "fast_iban": null,
            "phone_country_code": null,
            "phone_number": null,
            "email": null,
            "total_balance": 1108.00,
            "monthly_incoming_total": 0.0,
            "monthly_outgoing_total": 0.0,
            "access_level_status_id": 1,
            "access_level_status": "Aktif",
            "payment_balance": {
                "available": 247.00,
                "unavailable": 0.00
            },
            "cash_balance": {
                "available": 24.00,
                "unavailable": 837.00
            },
            "transaction_limits": {
                "max_balance": 200000.0000,
                "topup_credit_limit": 199970.0000,
                "topup_cash_limit": 199970.0000,
                "withdrawal_limit": 200000.0000,
                "payment_limit": 200029.0000,
                "wallet_to_wallet_limit": 199986.0000
            },
            "kyc_level_status": null,
            "currency_code": "TRY",
            "user_kyc_info": null,
            "is_topup_default": false,
            "tax_number": null,
            "loyalty_record_required": false,
            "ext_account_number": null
        }
    }
}

Send Money To Bank Account

Transaction Type Code List