# DZXUM 马来西亚接入说明

本附录只描述商户-facing 平台标准字段；DZXUM 原始代码由平台内部适配。

## 代收

`countryCode=MY`、`currency=MYR`。`payTypeCode` 可用 `bank`、`qr`、`wallet`、`gateway`。同一标准类型可能有多个渠道产品，平台通过 `methodId` 路由；商户不提交 `400-403` 或 `420-423`。

使用 `payTypeCode=bank` 时，`bankCode` 必须是银行编码附录“代收网银”章节中的 7 个平台标准码之一。代收不能使用代付银行目录兜底。

## 代付

代收与代付的完整且分离的银行目录见 [DZXUM 马来西亚平台银行编码](./开放接口附录-dzxum马来西亚银行编码.md)。

`countryCode=MY`、`currency=MYR`、`payTypeCode=bank`。`payeeType` 支持 `BANK`、`PERSONAL_BANK`、`BANK_CARD`；必填 `payeeName`、`payeeAccount`、`payeeBankCode`。`payeeBankCode` 使用平台马来西亚标准编码。

`applyAmount` 最终换算后必须是正整数 MYR（即分值能被 100 整除）；DZXUM 代付不接受小数 MYR。当前测试账号限额为 `1-100 MYR`，即平台内部 `100-10000` 分；正式商户限额以上游配置为准。

```json
{"countryCode":"MY","currency":"MYR","payTypeCode":"bank","payeeType":"BANK","payeeName":"TEST USER","payeeAccount":"1234567890","payeeBankCode":"MY_MALAYAN_BANKING_BHD"}
```

渠道账号由平台管理员设置 `gatewayUrl=https://payment.dzxum.com` 及加密的 `merchantNo`、`secretKey`（代收密钥）、`rsaPrivateKey`（代付密钥）。商户 OpenAPI HMAC key 与两项渠道密钥相互独立。平台对商户回调仍使用平台订单号；DZXUM `orderNo`/`tradeNo` 仅用于内部核验审计。