Skip to content

SDK 使用

推荐使用 ginx-open-sdk 发起请求,SDK 已内置请求签名与响应验签辅助能力。

基本步骤

  1. 初始化 GinxPayConfig(网关地址、商户号、应用号、私钥、公钥)
  2. 构建请求对象(如 PayParam
  3. 调用 GinxPayKit.execute()
  4. 对响应执行 verifySign()

Java 示例

java
GinxPayConfig config = new GinxPayConfig();
config.setServiceUrl("https://your-domain");
config.setMchNo("M123456");
config.setAppId("APP123456");
config.setPrivateKey("-----BEGIN PRIVATE KEY-----...");
config.setPublicKey("-----BEGIN PUBLIC KEY-----...");

GinxPayKit kit = new GinxPayKit(config);

PayParam param = new PayParam();
param.setBizOrderNo("ORDER-20260414-001");
param.setTitle("Order Payment");
param.setMethod("qrcode");
param.setAmount(new BigDecimal("12.50"));

DaxResult<PayResult> result = kit.execute(param);
boolean signOk = kit.verifySign(result);

更多参数定义见 OpenAPI 文件:/openapi/unipay.yaml