> For the complete documentation index, see [llms.txt](https://docs.topay.mobi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.topay.mobi/cn/reference/api-reference/fiat-payments/payin/country-examples/turkey/banktransfer.md).

# 银行转账

{% hint style="warning" %}
每个请求都必须包含[公共参数](/cn/reference/api-reference/common-parameters.md)。
{% endhint %}

土耳其银行转账（Havale / Bank Transfer）。付款人在返回的收银台页面中查看土耳其本地收款账户，并通过银行 App / 网银完成转账入金；入金确认由渠道自动处理，**无需回传凭证 / UTR**（UTR 仅为印度渠道动作）。

## 示例 <a href="#example" id="example"></a>

```
// request
curl --location --request POST 'https://api.topay.mobi/v1/order/pay' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "custom_code9982674851738108",
    "currency": "TRY",
    "amount": "2000",
    "payment_method": "direct",
    "payment_type": "virtual_account",     // 土耳其：银行转账收单（平台虚拟账户形态）
    "payment_channel": "tr_bank_transfer", // 见支持的支付类型 code
    "product_name": "product info",
    "customer_ref_id": "abcd1234",         // 真实用户 ID（渠道风控要求）
    "customer": {
        "name": "MEHMET YILMAZ",           // 付款人真实完整姓名，必填
        "userLevel": "FTD"                 // FTD / STD / VIP，真实用户分级，必填
    },
    "notify_url": "https://notify.url",
    "remark": "payin test remark"
}'
```

```
// response

{"code":"200",
 "data":{
   "request_id":"custom_code9982674851738108",
   "partner_id":"2000051",
   "order_no":"2023013120000600262092321146",
   "currency":"TRY",
   "order_amount":"2000",
   "status":11,
   "payment_method":"direct",
   "checkout_url":"https://example.com/deposits/cashier/PFIN0000000000000"
 },
 "message":"success"
 }
```

示例主要展示业务字段。

土耳其（country=TR）专属说明：

* `payment_type`：固定 `virtual_account`（土耳其银行转账在平台收单侧为虚拟账户形态，响应返回收银台链接 + 收款账户信息）
* `payment_channel`：固定 `tr_bank_transfer`
* `customer.name`：付款人**真实完整姓名**，必填。渠道按真实姓名识别入账，缺失或不完整会导致掉单 / 退回
* `customer.userLevel`：付款人**真实用户分级**，取值 `FTD` / `STD` / `VIP`，必填（渠道风控要求）
* `customer_ref_id`：**真实用户 ID**，必填（渠道风控要求）
* 响应 `checkout_url`：实际为渠道收银台链接（生产返回 `bankcard` 收银台；测试环境渠道返回 `none`，平台用占位链接顶替），示例域名非真实地址
* 土耳其无 UTR / 凭证回填动作（UTR 为印度专属）