The relevant endpoint and http method information for making withdrawals are given below.
| HTTP Method | URL |
|---|---|
| POST | /v1/Transaction/WithdrawalToBankInstant |
| Params | Type | Mandatory | Description |
|---|---|---|---|
| ext_transaction_id | string | Yes | Unique Transaction ID |
| receiver_wallet_number | string | Yes | Receiver Wallet Number |
| receiver_national_id | string | Yes | Receiver National Id |
| receiver_account_holder_name | string | Yes | Receiver Account Holder Name |
| receiver_iban | string | Yes | Receiver IBAN |
| description | string | Yes | Description |
| amount | decimal | Yes | Amount |
| currency_code | string | Yes | Currency Code |
| is_save_bank_account | boolean | No | Is the Bank Account Registered ? |
| bank_account_name | string | No | Bank Account Name |
| hash_key | string | No | Hash Key |
| kolas_address | string | No | Simplified Address |
| kolas_address_type | string | No | Easy Address Type (T: Phone, K: ID, P: Passport) |
| Params | Type | Description |
|---|---|---|
| status | int | Status |
| code | string | Code |
| message | string | Message |
| payload | object | Payload |
| transaction_id | string | Transaction Id |
| ext_transaction_id | string | Unique Transaction ID |
| transaction_amount | decimal | Transaction Amount |
| transaction_fee_amount | decimal | Transaction Fee Amount |
| previous_amount | decimal | Previous Amonut |
| request_id | string | Request Id |
| wallet_info | object | Wallet Info |
| id | string | Wallet Id |
| tenant_id | string | Tenant Id |
| name | string | Wallet Name |
| account_number | string | Account Number |
| account_type | string | Account Type |
| created_date_utc | string | Created Date |
| number | string | Wallet Number |
| fast_iban | string | Fast IBAN |
| phone_country_code | string | Phone Country Code |
| phone_number | string | Phone Number |
| string | ||
| total_balance | decimal | Total Balance |
| monthly_incoming_total | decimal | Monthly Incoming Balance |
| monthly_outgoing_total | decimal | Monthly Outgoing Balance |
| access_level_status_id | int | Access Level Status Id |
| access_level_status | string | Account Status (Active/Inactive) |
| payment_balance | object | Payment Balance |
| available | decimal | Payment Balance / Available |
| unavailable | decimal | Payment Balance / Unavailable |
| cash_balance | object | Cash Balance |
| available | decimal | Cash Balance / Available |
| unavailable | decimal | Cash Balance / Unavailable |
| transaction_limits | object | Transaction Limits |
| max_balance | decimal | Transaction Limits / Max Balance |
| topup_credit_limit | decimal | Transaction Limits / Topup Credit Limit |
| topup_cash_limit | decimal | Transaction Limits / Topup Cash Limit |
| withdrawal_limit | decimal | Transaction Limits / Withdrawal Limit |
| payment_limit | decimal | Transaction Limits / Payment Limit |
| wallet_to_wallet_limit | decimal | Transaction Limits / Wallet to Wallet Limit |
| kyc_level_status | string | KYC Level Status |
| currency_code | string | Currency Code |
| user_kyc_info | string | User KYC Info |
| is_topup_default | boolean | Is Topup Default ? |
| tax_number | string | Tax Number |
| loyalty_record_required | boolean |
REQUEST
{
"ext_transaction_id": "aab388a8-7c54-444a-b256-304b362b0fff",
"receiver_wallet_number": "1087257111",
"receiver_national_id": "11111111111",
"receiver_account_holder_name": "John Doe",
"receiver_iban": "TR06001340000058",
"description": "Withdrawal request",
"amount": 10,
"currency_code": "TRY",
"is_save_bank_account": false,
"bank_account_name": "",
"hash_key": "",
"kolas_adress": " ",
"kolas_adress_type": " "
}
RESPONSE
{
"status": 0,
"code": "100",
"message": "İşlem Talebi Alındı.",
"payload": {
"transaction_id": "0",
"ext_transaction_id": null,
"transaction_amount": 3.0000,
"transaction_fee_amount": 0.0,
"previous_amount": 0.0,
"request_id": "0",
"wallet_info": {
"id": "886855225643543543634088461",
"tenant_id": "5",
"name": "",
"account_number": "67678682294561",
"account_type": "Personal",
"created_date_utc": "2022-08-08T08:06:50.289429+00:00",
"number": "96297830",
"fast_iban": "TR110083801024000754938444",
"phone_country_code": null,
"phone_number": null,
"email": null,
"total_balance": 4.25,
"monthly_incoming_total": 0.0,
"monthly_outgoing_total": 0.0,
"access_level_status_id": 1,
"access_level_status": "Aktif",
"payment_balance": {
"available": 0.00,
"unavailable": 0.00
},
"cash_balance": {
"available": 0.25,
"unavailable": 4.00
},
"transaction_limits": {
"max_balance": 1000000.0000,
"topup_credit_limit": 999993.0000,
"topup_cash_limit": 999993.0000,
"withdrawal_limit": 999998.7000,
"payment_limit": 999997.0000,
"wallet_to_wallet_limit": 1000000.0000
},
"kyc_level_status": null,
"currency_code": "TRY",
"user_kyc_info": null,
"is_topup_default": false,
"tax_number": null,
"loyalty_record_required": false
}
}
}