# Epicpay 马来西亚代付账户与银行编码

适用 `POST /api/PayRequest/UnifiedPayout`，`channelCode=epicpay`、`countryCode=MY`、`currency=MYR`。使用现有 `payTypeCode` 选择产品：`bank` 为普通银行代付，`native_bank` 为原生银行代付；两者的 `payeeType` 都是 `BANK`，不新增接口参数。金额单位为分，须为 100 分的正整数倍。

两种产品可以同时启用，商户下单时应明确传入 `payTypeCode`。指定的产品未开通、停用或银行不受支持时，不会切换另一种产品。两种产品都可用而省略支付类型时，平台返回类型歧义错误 `PAY_PARAM_020`，应补传支付类型；仅有唯一可匹配类型时保留原有省略兼容规则。同一商户订单号重试不得更换支付类型。

| 商户字段 | Epicpay 上游含义 |
| --- | --- |
| `payeeName` | `bAccName` 银行账户户名，必填 |
| `payeeAccount` | `bAccNo` 银行账户号码，必填；平台不会猜测或替换账户 |
| `payeeBankCode` | 平台标准银行码，必填；平台映射为 `bCode`，见[马来西亚银行标准](./malaysia-bank-codes.html) |
| `payeeBankName` | 可选；平台可由已确认的银行映射反查名称 |
| `notifyUrl` | 商户接收平台通知的地址；平台另向 Epicpay 提交自己的回调地址 |

平台代付 `BatchId` 提交为 Epicpay `trxid`；上游提交响应 `d.trxid` 应回显该值，`d.id` 才是上游订单号。**回调 `id` 是原提交的 `trxid`，不是 `d.id`。** 上游受理不代表出款成功；回调 MD5 不覆盖状态或实出金额，平台以再次查单确认的终态和金额处理出款。回调 `status=1` 成功、`-1` 失败；查单 `2` 处理中。银行目录中的 Epicpay 上游码仅用于说明映射，商户始终提交平台码。

2026-10-30 增加独立原生银行代付方式 `Malaysia Native Bank Payout`，使用 `payTypeCode=native_bank`、`payeeType=BANK`。该方式仅支持下表 17 家银行，商户提交平台标准码，平台转换编码；普通 `bank` 代付仍使用原映射。商户需单独开通原生方式的路由。旧原生配置须先完成支付类型迁移；迁移不更改商户方式 ID、费率、限额或启停状态。

例如原生代付提交 `{"channelCode":"epicpay","countryCode":"MY","currency":"MYR","payTypeCode":"native_bank","payeeType":"BANK"}`；普通代付只把 `payTypeCode` 改为 `bank`。以上仅展示产品选择字段，完整请求仍须包含应用、订单、金额、收款信息及签名等必填字段，并按原始请求签名。

| 银行 | 平台 `payeeBankCode` | 原生代付上游 `bCode` |
| --- | --- | --- |
| Public Bank | `MY_PUBLIC_BERHAD` | `FPXPBB` |
| Bank Rakyat | `MY_KERJASAMA_RAKYAT_MALAY_61C408` | `FPXRAKYAT` |
| Alliance Bank | `MY_ALLIANCE_MALAYSIA_BERHAD` | `FPXALLIANCE` |
| Maybank | `MY_MALAYAN_BANKING_BHD` | `FPXMBB` |
| Bank Islam | `MY_ISLAM_MALAYSIA_BERH` | `FPXISLAM` |
| Bank Muamalat | `MY_MUAMALAT_MALAYSIA_BERHAD` | `FPXMUAMALAT` |
| Affin Bank | `MY_AFFIN_BERHAD` | `FPXAFFIN` |
| RHB Bank | `MY_RHB_BERHAD` | `FPXRHB` |
| OCBC Malaysia | `MY_OCBC_MALAYSIA_BERHAD` | `FPXOCBCM` |
| Standard Chartered | `MY_STANDARD_CHARTERED_MAL_71D483` | `FPXSTCM` |
| Hong Leong Bank | `MY_HONG_LEONG_BHD` | `FPXHLB` |
| UOB Malaysia | `MY_UNITED_OVERSEAS_MALAYS_BBCA4E` | `FPXUOBM` |
| CIMB Bank | `MY_CIMB_BERHAD` | `FPXCIMB` |
| AmBank | `MY_AMBANK_MALAYSIA_BERHAD` | `FPXAMBANK` |
| Bank Simpanan Nasional | `MY_SIMPANAN_NASIONAL_BERHAD` | `FPXBSN` |
| HSBC Malaysia | `MY_HSBC_MALAYSIA_BERHAD` | `FPXHSBCM` |
| Agrobank | `MY_AGROBANK` | `FPXAGRO` |

原生方式不支持本截图中未勾选的聚合入口、Boost、TNG、DuitNow 或 EWallet；其他银行也不属于本次确认的产品范围。金额须为整数 MYR，收款人户名、账号和银行标准码仍必填，具体费用及限额以开通配置和上游约定为准。方式中的产品族标记 `FPX` 不是商户银行码，也不是原生出款时直接提交的 `bCode`。

协议依据：`doc/支付渠道文档/Epicpay/EPICPAY_API_Integration_Document.pdf`，最后收集 2026-09-29 21:20 +08:00；原生银行代付清单增补依据为所有者于 2026-10-30 提供、由上游确认的 FPX 表格右侧 Payout 勾选项。未发现公开同协议在线文档。