印度支付 API（India Payment API）
SoPay 为需要进入印度市场的商户提供统一的 India Payment API 文档与接入路径。通过 印度支付接口，您可以在自有系统中发起 INR 代收（Payin）、代付（Payout），并接收异步通知，而无需逐一对接多家 印度支付渠道 或 印度支付通道 的底层协议。
本文是面向搜索与业务了解的 SEO 说明页；具体请求字段、签名算法与错误码请以 印度 API 总览 及子页面为准。
印度支付 API 是什么
印度支付 API（India Payment API）通常指商户后端与支付平台之间的 HTTPS 接口集合，用于创建收款订单、发起出款、查询状态与接收回调。对商户而言，核心价值是：
- 用一套 印度支付接口 覆盖多种本地收款/出款方式（如在线收银、银行转账等，以平台当前开放能力为准）
- 以 INR Payment API 统一币种与订单模型，便于对账
- 通过 RSA2 签名 与 Webhook 保证请求与通知的可验证性
SoPay 文档站描述的是 商户对接 API 层能力；是否支持某一具体通道、银行或钱包产品，以您签约后的商户包与 印度总览 为准。
SoPay 支持的印度支付能力（文档范围）
根据现有 API 文档，印度相关能力主要包括：
| 能力 | 说明 | 文档入口 |
|---|---|---|
| India Payin API | 创建代收订单，获取支付引导（如 payUrl / UPI intent） | 印度代收 API |
| India Payout API | 向受益人银行账户或 UPI/VPA 发起代付（含 IFSC 等字段） | 印度代付 API |
| 订单查询 | 按商户单号或平台单号查询状态 | 见 印度总览 API 一览 |
| 商户钱包 | 余额与流水查询 | 见 印度总览 |
| 异步回调 | 终态通知与验签 | 异步回调指南 |
| 请求签名 | Header 签名规范 | 签名规范 |
文档中印度代收场景常涉及 UPI Payment API 所代表的在线收银类能力（用户通过支付页或 UPI intent 完成付款）；代付场景默认使用 IFSC + 银行账号，也可按通道能力使用 UPI/VPA。实际可用产品与字段以联调环境为准。
印度代收 Payin API
India Payin API 用于向用户收取 INR。典型流程：
- 商户服务端调用创建代收接口，传入金额、商户订单号、
notifyUrl等 - 平台返回支付引导信息（如
payUrl），商户在前端或 App 中展示 - 用户完成支付后，平台通过 notifyUrl 推送终态，并更新商户钱包（以文档与合同为准）
印度代收查询除普通订单查询外，还可在同一个查询接口中使用 queryType=utr&utr=... 或 queryType=upi&upi=... 选择 UTR / UPI 查询。实现细节见 印度代收 API。
印度代付 Payout API
India Payout API 用于向指定银行账户或 UPI/VPA 出款。银行账户模式下，商户需在 extJson.ifsc 提供 IFSC；UPI/VPA 模式下传 extJson.accountType=vpa，并在 payee_account 或 extJson.vpa 填写 UPI 地址。创建代付后订单进入处理中状态，终态通过回调或查询接口获取。
请勿在业务代码中写死「一定成功」或固定到账时间；以平台返回状态与运营说明为准。接口说明见 印度代付 API。
INR、UPI、IFSC 与银行转账
- INR：印度卢比，印度 API 固定币种，金额精度以文档约定为准（通常最多两位小数）
- UPI：印度常用的即时支付体系；代收侧可能体现为
payUrl或 UPI intent，代付侧可在支持时使用 VPA 地址 - IFSC：印度金融体系银行分支识别码，银行账户 代付 创建时通常必填，用于路由到正确银行
- 银行转账 / IMPS 等：代付侧常见出款方式描述，底层通道由平台处理，商户对接 SoPay 统一 Payout API 即可
接入流程建议
- 阅读 快速开始，完成商户开通与 RSA 密钥交换
- 在沙盒环境配置
API_BASE，实现 签名规范 - 按 印度总览 依次对接 Payin、Payout、查询与 回调
- 上线前在 Search Console 与日志中验证回调可达、验签通过、幂等处理正确
常见问题（FAQ）
SoPay 印度支付 API 与底层通道是什么关系？
商户对接的是 SoPay 平台 API。底层 印度支付渠道 由平台侧集成与维护，商户无需也不应直接调用通道原生接口。
是否支持 UPI Payment API？
文档中的印度代收能力包含在线收银类流程，可能与 UPI 等本地方式相关。是否对您商户开放、字段如何填写，请以 印度代收 与运营下发的能力清单为准。
代付必须提供 IFSC 吗？
银行账户代付需要在 extJson.ifsc 提供 IFSC。若使用支持的 UPI/VPA 出款模式，可传 extJson.accountType=vpa，并使用 UPI 地址作为收款账号。
回调失败会怎样？
商户验签并处理成功后须返回 HTTP 200 且正文 OK，否则平台可能重复 POST。详见 异步回调指南。
从哪里开始看技术文档？
建议顺序：印度总览 → 签名 → 代收 / 代付 → 回调。