# Request a BIDV business link

`POST /service/@id/tinopay/bank-links/bidv-business` · TinoPay, service owner's sign-in token

BIDV business accounts are not linked automatically: the route opens a request so staff set up the service with BIDV; the account then appears in the bank account list. Returns 201 `{ticket_id, status, created_at}`.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/tinopay/bank-links/bidv-business` |
| Method | `POST` |
| Authentication | the TinoPay service owner's sign-in token (`Authorization: Bearer <token>`); the `/v1` gateway does not expose TinoPay yet |
| Content-Type | `application/json` |

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | int | yes | TinoPay service ID |
| `name` | body | string | — | Người liên hệ |
| `phone` | body | string | — | — |
| `has_bidv_account` | body | bool | — | — |
| `note` | body | string | — | — |

## Example request

```bash
curl -X POST "https://api.tino.vn/service/100001/tinopay/bank-links/bidv-business" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Nguyễn Văn A",
  "phone": "0900000000",
  "has_bidv_account": true,
  "note": "Liên hệ buổi sáng"
}'
```

`$TINO_TOKEN` is the TinoPay service owner's sign-in token. Path parameters in the example are sample values.

SDK ([SDK & examples](/en/docs/sdk)): no dedicated function yet, use `client.request("POST", "/service/@id/tinopay/bank-links/bidv-business")`.

## Example response

```json
{
 "data": {
  "ticket_id": 41,
  "status": 1,
  "created_at": "2026-10-20T15:40:00+07:00"
 }
}
```

Sample built from the TinoPay API v1 documentation (Tino relays TinoPay data as is); values are examples.