# JoyPay 印度接入说明

`channelCode=joypay`，`countryCode=IN`，`currency=INR`。开放接口地址、HMAC-SHA256 签名和公共必填参数沿用 [主文档](./api-docs.html)，下列 JSON 仅展示渠道相关业务字段，需与主文档的 appId、商户订单号、通知地址及签名合并。

| 业务 | 平台 payTypeCode | 说明 |
|---|---|---|
| 代收 | aggregate | 综合收银台 |
| 代收 | paytm | Paytm 收银台 |
| 代收 | phonepe | PhonePe 收银台 |
| 代付 | bank | 银行转账，payeeType 必须为 BANK |

平台金额为整数分。例如 `amount=10001` 表示 INR 100.01。代收响应的 paymentUrl 是跳转收银台链接，不是二维码内容。支付方式实际可用范围以商户已开通的方法和费率路由为准。

代收字段示例：
```json
{"channelCode":"joypay","countryCode":"IN","currency":"INR","payTypeCode":"aggregate","amount":10001}
```

代付字段示例（仅格式展示，禁止向示例账户付款）：
```json
{"channelCode":"joypay","countryCode":"IN","currency":"INR","payTypeCode":"bank","amount":10000,"payeeType":"BANK","payeeName":"Example Recipient","payeeAccount":"000000000001","ifsc":"HDFC0001234"}
```

`payeeName`、`payeeAccount`、`ifsc` 必填；手机号 `payeeMobile` 和邮箱 `payeeEmail` 可选。账号保留前导零。`payeeBankCode` 不必填写，也不发送给渠道；[IFSC 标准说明](./payout-bank-catalog.html#joypay-in-ifsc)。不得使用上游 PayTm/PhonePe、PAYIN/PAYOUT、BANK 产品标识替代平台支付类型。

受理不代表成功；以平台查单或平台发送的商户通知确认最终状态。上游超时、重复订单、未知状态会保持待确认，商户不得据此立即重新付款。渠道回调提交号与上游流水由平台内部映射，商户不得将渠道 trans_no 当作自己的 merchantOrderNo。

本附录不提供渠道私钥；商户对接平台使用自己的平台 appId/HMAC 密钥，JoyPay RSA 凭据仅由平台渠道账号管理。