Send Money To Bank Account

POST

/v1/Transaction/SendMoneyToBankAccount

Used to transfer funds from a business wallet directly to a bank account.
IBAN, recipient name-surname, and national ID or tax number are required.
Transfers are only supported for valid Turkish IBANs.
The recipient information must match bank records for the transfer to succeed.
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.

How to payout status check?

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successful response

Body

🔴503NotVerified

⚪1Duplicate

🔵300NotFound

🔵311Insufficient Balance

🔵326Duplicate IBAN transfer within 1 minute not allowed

🔵306InvalidIban

⚪0WithdrawPending

🟢2WithdrawRejected

🔵3WithdrawFailed

🟠4WithdrawCancelled

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/Transaction/SendMoneyToBankAccount' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sender_wallet_number": "1489015629",
    "ext_transaction_id": "541313332552",
    "receiver_account_holder_name": "Fahri Kal",
    "receiver_iban": "TR550098000000000123486199",
    "receiver_national_id_or_tax_no": "22374193526",
    "description": "",
    "amount": 10,
    "currency_code": "TRY",
}'

Response Example

200 - Success

{
    "status": 0,
    "code": "100",
    "message": "İşlem Başarılı.",
    "payload": {
        "transaction_id": "0",
        "ext_transaction_id": "5417133231223333317134413113333332552",
        "transaction_amount": 2.0000,
        "transaction_fee_amount": 0.0,
        "previous_amount": 0.0,
        "request_id": "0",
        "wallet_info": {
            "id": "7503775172255149069",
            "tenant_id": "0",
            "name": "",
            "account_number": "SIPAYTEST0102",
            "account_type": "Business",
            "created_date_utc": "2022-01-07T12:06:20.4872807+00:00",
            "updated_date_utc": null,
            "number": "355831156",
            "fast_iban": "TR500083801825000355831156",
            "phone_country_code": null,
            "phone_number": null,
            "email": null,
            "total_balance": 177.49,
            "monthly_incoming_total": 0.0,
            "monthly_outgoing_total": 0.0,
            "access_level_status_id": 1,
            "access_level_status": "Aktif",
            "payment_balance": {
                "available": 1.00,
                "unavailable": 0.00
            },
            "cash_balance": {
                "available": 76.290000,
                "unavailable": 100.200000
            },
            "transaction_limits": {
                "max_balance": 3000000000.0000,
                "topup_credit_limit": 2999999999.0000,
                "topup_cash_limit": 2999999999.0000,
                "withdrawal_limit": 2999999997.0000,
                "payment_limit": 3000000000.0000,
                "wallet_to_wallet_limit": 2999999999.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
        },
        "fast_request_status_code": 0
    }
}

Business To Business Transfer

Transfer To Virement