ALLONEPAY OPEN API
收款与付款，
按场景接入。
先找到您需要的支付方式，再查看字段和示例。完整协议、银行目录与渠道差异随时可查。
取得应用 ID、签名密钥和正式接口域名，配置服务器 IP 白名单及回调地址。请求由您的服务端签名；密钥不放入浏览器。
支持目录
您的业务，需要哪种方式？
选择国家和币种，只查看相关类型。此处展示平台配置；您的应用是否开通、限额和当前状态，以商户能力查询为准。
正在加载目录…
怎样确认我自己的应用能用哪些方式？
从您的服务端调用 MerchantHostedPaymentMethods 查询代收方式，或 PayoutCapabilities 查询代付产品、账户、限额及字段。查询结果不预留通道，下单时会重新校验。
账户字段基于当前正式配置与本地适配器核对，不作为已部署版本或上游实时可用的证明。目录定义与资料审核状态不决定您的交易开通状态。
FunPay MY/MYR 的字段、网银预选银行与扫码跳转差异见FunPay 马来西亚接入说明。渠道须单独开通，是否可用以应用能力查询为准。
01 / 代收
创建订单，接收支付结果。
- 选择已开通的支付类型
- 服务端签名并下单
- 按响应展示支付入口
- 回调或查单确认终态
本次下单要传什么
公共鉴权字段，加 merchantOrderNo、amount、currency。按场景补充付款人、国家、银行等条件字段。
payTypeCode 可用于选择标准支付类型；channelCode 和 payMethodCode 为可选路由条件。未指定时按商户配置选择。
PAY_000 表示接口受理成功。支付完成以验签后的查询或回调终态为准，跳转返回不作为付款成功依据。
二维码载荷、跳转 URL 和原生支付动作按实际返回类型处理；聚合入口的最终钱包或银行以支付页面为准。
02 / 代付
先确定账户，再补齐收款信息。
- 选择国家、币种与账户类型
- 查看本能力的必填字段
- 服务端签名并提交
- 回调或查单确认终态
三个字段，三种含义
payTypeCode- 支付产品。按需要指定，保留现有可选规则。
payeeType- 平台标准账户类型，例如银行账户、PIX 邮箱键。按所选能力的要求提交。
payeeAccount- 具体收款值，例如银行账号、邮箱或手机号；不是账户类型编码。
代付金额使用 applyAmount，单位为整数分。普通证件使用 identityType + identityNo；税务编号按场景使用 payeeIdCard。
不同渠道的字段要求分别展示。自动路由仍须满足完整账户、金额和渠道条件；提交结果未知时先查单，不直接重复发起出款。
共同规则
签名、验签与回调。
代收统一通知（待生产部署）：只新增 paymentNo、totalPaidAmount。amount保留原订单目标，paidAmount为本次实付。普通渠道付款号为空，多笔付款返回稳定付款号；沿用现有通知版本，按应用、付款号及订单号组合幂等。完整字段、验签和统一幂等示例 →
公共鉴权字段
appId、timestamp、nonce、apiVersion、sign。
使用 POST 和 JSON。时间戳为 UTC Unix 秒，允许 5 分钟偏差；随机串 10 分钟内不可重复。默认版本 v1.0，可选版本按接口说明。
签名排除 sign，对象按点路径扁平化，参数名转小写并排序，值按规则编码。算法以商户配置为准；完整算法、签名串与兼容规则集中查阅。
处理结果前先验签
按实际收到的字段验证响应和回调签名，再核对订单号、金额及币种。前置安全失败可能无有效签名，不能把无签名响应当作成功。
回调完成幂等业务处理后，按协议返回纯文本成功响应；失败或超时可能触发重试。超时、未回调时使用查询接口确认结果。
查看回调最小实现 →错误排查
先看响应码，再确定下一步。
| 错误类别 | 先检查 |
|---|---|
| 签名或安全错误 | 原始参数、编码、算法、时间戳、nonce 与服务器 IP 白名单。 |
| 字段或账户错误 | 所选国家、币种、产品与账户组合，以及本能力的条件必填字段。 |
| 路由或开通错误 | 本应用的能力查询结果、金额范围与当前状态。 |
| 超时或结果未知 | 主动查单并等待回调；未确认终态前不要直接重新发起资金请求。 |
完整参考
需要时，再查细节。
yzpay PH/PHP（待部署）：GCASH 原生代收与钱包代付，payeeType=GCASH；收款字段 payeeName → account_holder、payeeAccount → bank_account、payeeMobile → account_holder_mobile。限额、回调与字段说明；未纳入正式配置快照，开通以能力查询为准。
shijiepay 聚合付（VN/VND、PH/PHP，待部署）：代收标准类型 · 代付字段 · 越南银行标准码 · 菲律宾银行标准码。实际开通以能力查询为准。
VCpay 菲律宾 PH/PHP 接入资料（待部署）：代收 GCash、GrabPay、Maya、QRPh、GoTyme；代付 GCASH、GRABPAY、MAYA、BANK。收付限额20–50000 PHP。代收产品说明、代付字段和示例、银行标准码。实际可用性以商户能力查询为准。
待部署渠道接入资料：VCpay 巴基斯坦 PKR、越南 VND 代收产品与示例、代付账户与示例。越南支持 MoMo、Viettel Money、ZaloPay 与银行账户；此处为对接资料，尚未列入上方正式配置快照。
tigerpay 孟加拉 BDT：bKash/Nagad 代收与钱包代付接入说明。渠道开通范围以商户后台生效路由为准。
PandaPay channelCode=pandapay 越南 VN/VND（待部署）：银行卡、MoMo、ZaloPay、银行网关及银联扫码代收须提供真实付款姓名；BANK 代付须提供姓名、账号、邮箱、电话和越南平台银行码。官方无越南银行目录，按无编码国家契约固定 acc_code=BANK，不代表所有银行已确认支持。该协议资料尚未列入正式配置快照，实际开通以能力查询为准。
Yopay 巴西接入资料（待部署）
channelCode=yopay、BR/BRL：代收使用 PIX，返回的支付 URL 与独立二维码分别展示，查询和验签回调确认终态。下表为代付商户字段对照，尚未列入上方正式配置快照；实际开通以能力查询为准。
| payeeType | payeeAccount → accountNo | 共同必填字段 |
|---|---|---|
| PIX_CPF | 11位CPF PIX Key | payeeName → accountName；payeeIdCard → cpf（11位真实CPF） |
| PIX_PHONE | 完整巴西手机号 Key，本地或+55 | payeeName → accountName；payeeIdCard → cpf |
| PIX_EMAIL | 邮箱 PIX Key | payeeName → accountName；payeeIdCard → cpf |
| PIX_RANDOM | UUID随机键，上游 accountType=PIX_EVP | payeeName → accountName；payeeIdCard → cpf |
平台金额为整数分，可含零头；上游金额为元字符串。上游 CPF 为条件必填，平台要求提供以兼容启用校验的账户。完整说明见代付接口与渠道字段表。收款资料不自动生成；不支持 CNPJ 或银行账户。
DGPay MYR 渠道参考
dgpay 已实现 P2P/QR 落地页代收和 BANK 银行代付。商户代付使用 payeeType=BANK；payeeAccount / payeeName 对应 Route2 的 data.toAccNo / data.toAccName 或 Route7、Route69 的 data.accNo / data.accName；平台标准 payeeBankCode 对应 toBankCode / bankCode，Route7 使用平台派生的 bankName。具体字段见商户对接标准表，银行目录见MYR 平台标准银行码。代收两种产品均返回 paymentUrl 落地页；提交订单号、金额和状态由签名与回调核验。渠道可用性仍以商户实际开通配置为准。
ClickPay MY/MYR 字段与账户说明：渠道接入参考。是否可用以商户当前能力查询结果为准。