> ## Documentation Index
> Fetch the complete documentation index at: https://doc2.payloco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 各国扩展参数说明

> 全球付款请求中 channelExtra（扩展信息）按国家/付款方式的参数说明

调用 [付款请求](/zh/api-reference/transfers/transfer) 时，部分国家和付款方式需要通过 `channelExtra` 传入额外的收款方信息。请根据目标国家与付款方式选择对应的参数结构。

| 国家    | 国家编码 | 币种  | 付款方式                                                                                                                                                        |
| ----- | ---- | --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 巴西    | BR   | BRL | [PIX](#巴西-pix)                                                                                                                                              |
| 印度尼西亚 | ID   | IDR | [DANA](#印度尼西亚-dana-gopay-shopeepay)、[GOPAY](#印度尼西亚-dana-gopay-shopeepay)、[SHOPEEPAY](#印度尼西亚-dana-gopay-shopeepay)、[ID-BANKTRANSFER](#印度尼西亚-id-banktransfer) |
| 越南    | VN   | VND | [VN-BANKTRANSFER](#越南-vn-banktransfer)                                                                                                                      |
| 埃及    | EG   | EGP | [EG-BANKTRANSFER](#埃及-eg-banktransfer)、[EG-WALLET](#埃及-eg-wallet)                                                                                           |

## 巴西 PIX

| 参数         | 类型     | 必填 | 说明                                                | 示例                |
| ---------- | ------ | -- | ------------------------------------------------- | ----------------- |
| pixKeyType | string | 是  | Pix 密钥类型，枚举值：`cpf`、`email`、`phone`、`evp`，默认 `cpf` | cpf               |
| pixKey     | string | 否  | Pix 密钥                                            | 11013601513       |
| documentNo | string | 是  | 目标账户持有人的证件号 CPF，11 位数字                            | 11013601513       |
| name       | string | 是  | 目标账户持有人的全名。如果设置了 `lastName`，此处只需填写 First Name     | Joice Mary Santos |
| lastName   | string | 否  | 目标账户持有人的 Last Name                                | Santos            |
| email      | string | 否  | 目标账户持有人的邮箱                                        | -                 |
| phone      | string | 否  | 目标账户持有人的电话                                        | -                 |

```json theme={null}
{
  "channelExtra": {
    "pixKeyType": "cpf",
    "pixKey": "11013601513",
    "documentNo": "11013601513",
    "name": "Joice Mary Santos"
  }
}
```

## 印度尼西亚 DANA GOPAY SHOPEEPAY

DANA、GOPAY、SHOPEEPAY 三种电子钱包的参数结构相同。

| 参数    | 类型     | 必填 | 说明              | 示例           |
| ----- | ------ | -- | --------------- | ------------ |
| phone | string | 是  | 手机号，长度 12\~14 位 | 081617025661 |

```json theme={null}
{
  "channelExtra": {
    "phone": "081617025661"
  }
}
```

## 印度尼西亚 ID-BANKTRANSFER

| 参数        | 类型     | 必填 | 说明              | 示例           |
| --------- | ------ | -- | --------------- | ------------ |
| bankCode  | string | 否  | 银行编码            | -            |
| accountNo | string | 是  | 银行账户，长度 6\~20 位 | 081617025661 |

```json theme={null}
{
  "channelExtra": {
    "accountNo": "081617025661"
  }
}
```

## 越南 VN-BANKTRANSFER

| 参数          | 类型     | 必填 | 说明   | 示例              |
| ----------- | ------ | -- | ---- | --------------- |
| accountNo   | string | 是  | 银行账户 | 6220229870211   |
| accountName | string | 是  | 账户名称 | Trầm Thái Dương |

支持的越南银行及限额请参考 [越南付款方式](/zh/developers/global-payment/payment-network/asia-pacific/vietnam)。

```json theme={null}
{
  "channelExtra": {
    "accountNo": "6220229870211",
    "accountName": "Trầm Thái Dương"
  }
}
```

## 埃及 EG-BANKTRANSFER

| 参数          | 类型     | 必填 | 说明   | 示例            |
| ----------- | ------ | -- | ---- | ------------- |
| accountNo   | string | 是  | 银行账户 | 6220229870211 |
| accountName | string | 是  | 账户名称 | Test          |

```json theme={null}
{
  "channelExtra": {
    "accountNo": "6220229870211",
    "accountName": "Test"
  }
}
```

## 埃及 EG-WALLET

| 参数          | 类型     | 必填 | 说明   | 示例          |
| ----------- | ------ | -- | ---- | ----------- |
| phone       | string | 是  | 手机号  | 01111111111 |
| accountName | string | 是  | 账户名称 | Exia        |

```json theme={null}
{
  "channelExtra": {
    "phone": "01111111111",
    "accountName": "Exia"
  }
}
```

<Note>
  各国收款方手机号格式可参考 [各国电话号码规则参考](/zh/appendix/global-payment/phone-number-reference)。
</Note>
