开发者文档

1. 什么是 NewPay

NewPay 是面向老挝市场的合规支付与跨境收单服务平台，为商户、平台及机构合作伙伴提供二维码支付、线上收银台、跨境钱包受理、交易管理、结算对账、退款及风控合规等服务。

• 面向商户、平台和机构合作伙伴，NewPay 提供统一接入本地及跨境支付方式的能力。
• 开发者文档聚焦支付接入、订单、退款、回调、签名验签和业务码等技术说明。
• 本页面已移除与当前支付业务无关的生活服务和泛金融服务定位描述。

2. 接入流程

1. 概览

2. 接入说明

商户需要向 NewPay 商户平台提交接入申请资料。

NewPay 商户平台管理员会根据商户提交的资料创建 API 网络虚拟商户。

开发者中心会为该 API 网络虚拟商户生成接入资料，并发送给商户。

3. API 接入资料

3. 支付能力

1. 概览

为支持网站、移动 App、商户平台和线下支付等场景，NewPay 为商户提供以下支付能力，便于快速完成接入。

2. 能力说明

2.1 网站支付能力

2.2 App 支付能力

3. 网站支付流程

1. 概览

该能力适用于商户 PC 网站侧的支付场景。

2. 支付流程

2.1 NewPay 支付流程

1. 客户在商户网站应用（MWA）中选择 NewPay 支付方式并提交支付。

2. NewPay 平台生成支付订单，并返回订单二维码。

3. MWA 展示二维码，客户使用 NewPay App 扫码支付。

4. 支付完成后，NewPay 平台向 MWA 服务端通知交易结果，并跳转到交易结果页面 URL。

2.2 MasterCard 支付流程

1. 客户在商户网站应用（MWA）中选择 MasterCard 支付方式并提交支付。

2. NewPay 平台生成支付订单，并返回 MasterCard 支付表单页面 URL。

3. MWA 展示支付表单页面，客户填写 MasterCard 信息。

4. 支付完成后，NewPay 平台向 MWA 服务端通知交易结果，并跳转到交易结果页面 URL。

4. App 支付流程

1. 概览

该能力适用于商户移动 App 侧的支付场景。

2. 支付流程

2.1 NewPay 支付流程

1. 客户在商户移动应用（MMA）中选择 NewPay 支付方式并提交支付。

2. NewPay 平台生成支付订单，并返回用于确认订单信息的 H5 页面 URL。

3. 客户确认打开 NewPay App 完成支付。

4. 支付完成后，NewPay 平台向 MMA 服务端通知交易结果，并跳转到交易结果 H5 页面 URL。

2.2 MasterCard 支付流程

1. 客户在商户移动应用（MMA）中选择 MasterCard 支付方式并提交支付。

2. NewPay 平台生成支付订单，并返回 MasterCard 支付表单页面 URL。

3. MMA 展示 MasterCard H5 支付表单页面，客户填写 MasterCard 信息。

4. 支付完成后，NewPay 平台向 MWA 服务端通知交易结果，并跳转到交易结果 H5 页面 URL。

4. V1 API（已废弃）

• 4.1. Converge Payment API
• 4.2. 微信支付 API: 根据微信官方限制，老挝地区的微信支付仅支持在小程序内完成，因此商户需准备自己的小程序。如有特殊需求，请联系 NewPay。
• 4.2.1 流程图
• 4.2.2 创建订单
• 4.2.3 获取支付信息
• 4.2.4 示例
• 4.3. 通用 API
• 4.3.1 查询支付
• 4.3.2 退款
• 4.3.3 查询退款
• 4.3.4 预支付
• 4.3.5 查询用户
• 4.3.6 转账
• 4.3.7 查询转账订单
• 4.3.8 订单确认
• 4.4. 回调

4.1. Converge Payment API

1. 概览

通过该 API 获取收银台页面地址。获取地址后，可将用户跳转到收银台页面完成支付。

2. 请求说明

• Method: post
• 接口路径

For Website: https://prod-openapi.newpay.la/api/open/converge/pay/v1/createOrder
For Mobile: https://prod-openapi.newpay.la/api/open/converge/pay/v1/m/createOrder

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": {{current_timestamp}},
    "sign": "{{sign}}",
    "payMethod": 1,
    "extra": "",
    "currency": "LAK",
    "orderAmt": 50000,
    "merchantId": "876266cdc7154dd08a022fd1f2eace55",
    "orderNo": "ORDERNO000000000A104",
    "subject": "name002",
    "callBackUrl": "www.1231123.com",
    "successPageUrl": "https://prod.newpay.la:8071/jdb/success.html",
    "failurePageUrl": "https://prod.newpay.la:8071/jdb/failure.html",
    "cancelPageUrl": "https://prod.newpay.la:8071/jdb/cancel.html"
}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "3514d69403bc4ce1a8fafb6415a31018",
        "sign": "ALa4W6EDAKpZGEuCfpmemOA346bZw6CGrbsy6Xo6J2wYLOldSUrUVyEI0DLpZmHU9tIVp4gi/DENq3rj/nZtXn9grXWhLbX4G+IMEVb3TKEIwTDWZ++I1OfgtuUxOHof711p6A4ga95Xm645Qly/HV8YHoogI7SOw/w352TElhw37o/pIKsSWfeTpXtpfjRs3o69x4EVpDQ0DmYW5zVBCEriBqHvLqjbacOl3HGTa93oALbgQKa5ftAENBOmxi1zNxCOsY+Ecq4apK3tdma1RL+AmrBgmQu8O2vEIWBmlSxg1CY1ZUw2IHixV8D2HHHAn7RQjoDDFePelyB+CLS3GA==",
        "tranAbbr": "FP1005",
        "tranNo": "00012022090700000015",
        "orderAmt": "50000",
        "payUrl": "http://192.168.10.105:8072/BECLPay/page.html?orderNo=202209076000000321",
        "orderNo": "ORDERNO000000000A104",
        "newpayOrderNo": "202209076000000321"
    },
    "code": "0",
    "timestamp": "1662521235625"
}

4. 唤起 NewPay App

通过订单响应数据中的 payUrl 字段使用 AppLink 唤起 NewPay 支付。

4.1 iOS

objective-c 示例：

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:response.data.payUrl] options:@{} completionHandler:nil];

swift 示例：

let url = URL(string: response.data.payUrl)!
UIApplication.shared.open(url, options: [:], completionHandler: nil)

4.2 Android

Java 示例：

String payUrl= response.getData().getPayUrl();
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(payUrl));
startActivity(intent);

Kotlin 示例：

val payUrl = response?.data?.payUrl!!;
val intent = Intent(Intent.ACTION_VIEW, Uri.parse(payUrl))
startActivity(intent)

4.2. 微信支付 API

• 4.2.1 流程图
• 4.2.2 创建订单
• 4.2.3 获取支付信息
• 4.2.4 示例

4.2.1 流程图

1. 小程序内支付

2. 外部链接跳转

说明： API-1 对应 4.2.2 创建订单，API-2 对应 4.2.3 获取支付信息.

4.2.2 创建订单

1. 概览

通过该 API 处理微信支付小程序支付。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v2/createOpenMini

2.1 请求头

2.2 请求参数

3. 响应数据

4.2.3 获取支付信息

1. 概览

通过该 API 获取支付信息，然后调用 wx.requestPayment(OBJECT）, 查看微信文档

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v2/getMiniPayment

2.1 请求头

2.2 请求参数

3. 响应数据

4.2.4 示例

// parse the orderNo from url
App({
  paymentData:{
    orderNo:null
  },
  onShow: function (options) {
    // 解析 scheme URL 中的参数 ： {orderNo: "202508251000251204"}
    console.log('启动参数:', options.query);
    if (options && options.query) {
        Object.assign(this.paymentData, options.query);
    }
  }
})

// awake the wechat cashier to pay
const cashier = function (param) {
    wx.requestPayment({
        "timeStamp": param.timeStamp,
        "nonceStr": param.nonceStr,
        "package": param.package,
        "signType": param.signType,
        "paySign": param.paySign,
        "success": function (res) {
            //路由到成功页面
        },
        "fail": function (res) {
            //路由到失败页面
        },
        "complete": function (res) {}
    })
}

// Obtain payment info 
const payment = function(orderNo){
    wx.login({
        success: res => {
            debugger
            wx.request({
                url: 'http://192.168.0.20:8181/api/open/converge/pay/v2/getMiniPayment',
                method: 'POST',
                data: {
                    code: res.code,
                    newpayOrderNo: orderNo,
                    timestamp: Date.now()
                },
                header: {
                    'content-type': 'application/json;charset=UTF-8'
                },
                success(res) {
                    console.log(res.data);
                    if(res.data.code !== '0'){
                        wx.showToast({
                            title: res.data.message,
                            icon: 'none', 
                            duration: 3000
                          });
                        return;  
                    }
                    cashier(res.data.data.resMap)
                },
                fail(err) {
                    console.error('请求失败:', err);
                }
            });
        }
    });
}

Page({
    data: {
        message: '',
    },
    onReady() {
        // step 1: parse orderNo from url
        const app = getApp();
        const orderNo = app.paymentData.orderNo;
        console.log(orderNo);
        if(orderNo){
            // step2: payment
            // step2.1: wx.login to get the code
            // step2.2: obtain payment info
            // step2.3: awake cashier to pay
            payment(orderNo);
        }
    },
})

4.3. 通用 API

• 4.3.1 查询支付
• 4.3.2 退款
• 4.3.3 查询退款
• 4.3.4 预支付
• 4.3.5 查询用户
• 4.3.6 转账
• 4.3.7 查询转账订单
• 4.3.8 订单确认

4.3.1 查询支付

1. 概览

通过该 API 查询已提交支付请求的交易状态及相关信息。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v1/get

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": {{current_timestamp}},
    "sign": "{{sign}}",
    "merchantId": "876266cdc7154dd08a022fd1f2eace55",
    "orderNo": "ORDERNO000000000A104"
}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "3514d69403bc4ce1a8fafb6415a31018",
        "sign": "OUUz/cvUfo4m3IcndGByEKjT/pUOSyf0qhMV+lbKdilMxZgErjmTrB6xYmvMvhJpQFcRbGJFsn9B1WxNi330K1gY5ANXD2ttEIqV0IROm3M/o43rMu1tjVLk5ZBMP2D2l28zsYh9tyX8Zd8CzIxw10YT8Hkgvbh3bTP/vsRv1xov/YzOhpWsvSgDIJb6eKg02BePfR8N6wLkE9FV+91JDxFvFIMCc6qR7GXEFCnrilTeas95SGcSADS2KBFSXHdP6IOjnQbQEgVoAzyLhq4pjh6DrNupduknOKagB9CEKB1yEnb/zs+/WRFfP3VgBj0MIUideXEAvVJzp4CoZ5q7cA==",
        "tranAbbr": "FP1003",
        "tranNo": "00012022090700000033",
        "transStatus": 0,
        "transInfo": "Transaction Success",
        "payMethod": 1,
        "extra": "",
        "orderNo": "ORDERNO000000000A104",
        "newpayOrderNo": "202209076000000321",
        "currency": "LAK",
        "orderAmt": "50000",
        "subject": "name002",
        "settlementStatus": 1
    },
    "code": "0",
    "timestamp": "1662528566437"
}

4.3.2 退款

1. 概览

通过该 API 对成功支付的订单发起退款。退款可以是全额或部分退款。同一笔交易可以发起多次退款，但累计退款金额不得超过原交易金额。若退款请求超出合同约定的退款窗口，将被拒绝。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v1/refund

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": {{current_timestamp}},
    "sign": "{{sign}}",
    "refundOrderAmt": 50000,
    "merchantId": "876266cdc7154dd08a022fd1f2eace55",
    "orderNo": "ORDERNO000000000A104",
    "refundOrderNo": "ORDERNORFD000000000A104",
    "refundDesc": "reason",
    "callBackUrl": "www.google.com"
}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": null,
    "code": "0",
    "timestamp": "1662528697925"
}

4.3.3 查询退款

1. 概览

通过该 API 查询已提交退款请求的退款状态。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v1/getRefund

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": {{current_timestamp}},
    "sign": "{{sign}}",
    "refundOrderNo": "ORDERNORFD000000000A104",
    "merchantId": "876266cdc7154dd08a022fd1f2eace55"
}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "3514d69403bc4ce1a8fafb6415a31018",
        "sign": "MOGEIGrrLD4BvZTgxETIIm4m3vfHXECIXbB1nPfOCimfNc1c59h2bccHSuBsXprgGmkGoh4AjCkQBtQ9u0Ui0AOfSmtSJnnYshk7beSdmNzl+CAK0RkrrQfQaauoBLxQa7odhMy7WhFQF7XL+4dLih8RK6kpZPPiBwUNyiC+69sc00I+IuEJfcTUydMPjCl1U3Qq1dS9igGOWrwE5McMAFLPpWTi1B5tbv9FC8SQUtNRPv3ckIUrkC0U0uXKspXG2iPIeM49Jck8ZEwql22yzjvR0bMnVL6TBkysooCGLW/ETFT5+EUWrPkp7pz7AnPt2VT2sVWIpllw/H4zLYpLog==",
        "tranAbbr": null,
        "tranNo": "00012022090700000037",
        "refundSuccess": true,
        "refundOrderAmt": "50000",
        "payMethod": 1,
        "currency": "LAK",
        "orderNo": "ORDERNO000000000A104",
        "newpayOrderNo": "202209076000000321",
        "refundOrderNo": "ORDERNORFD000000000A104",
        "newpayRefundOrderNo": "202209078000000702"
    },
    "code": "0",
    "timestamp": "1662528718641"
}

4.3.4 预支付

1. 概览

通过该 API 获取预支付收银台页面地址。获取地址后，可将用户跳转到收银台页面完成预支付。

2. 请求说明

• Method: post
• 接口路径

For Website:  
https://prod-openapi.newpay.la/api/open/converge/pay/v1/createOrderPrePayment
For Mobile:  
https://prod-openapi.newpay.la/api/open/converge/pay/v1/m/createOrderPrePayment

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": {{current_timestamp}},
    "sign": "{{sign}}",
    "payMethod": 1,
    "extra": "",
    "currency": "LAK",
    "orderAmt": 50000,
    "merchantId": "876266cdc7154dd08a022fd1f2eace55",
    "orderNo": "ORDERNO000000000A104",
    "subject": "name002",
    "callBackUrl": "www.1231123.com",
    "successPageUrl": "https://prod.newpay.la:8071/jdb/success.html",
    "failurePageUrl": "https://prod.newpay.la:8071/jdb/failure.html",
    "cancelPageUrl": "https://prod.newpay.la:8071/jdb/cancel.html"
}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "3514d69403bc4ce1a8fafb6415a31018",
        "sign": "ALa4W6EDAKpZGEuCfpmemOA346bZw6CGrbsy6Xo6J2wYLOldSUrUVyEI0DLpZmHU9tIVp4gi/DENq3rj/nZtXn9grXWhLbX4G+IMEVb3TKEIwTDWZ++I1OfgtuUxOHof711p6A4ga95Xm645Qly/HV8YHoogI7SOw/w352TElhw37o/pIKsSWfeTpXtpfjRs3o69x4EVpDQ0DmYW5zVBCEriBqHvLqjbacOl3HGTa93oALbgQKa5ftAENBOmxi1zNxCOsY+Ecq4apK3tdma1RL+AmrBgmQu8O2vEIWBmlSxg1CY1ZUw2IHixV8D2HHHAn7RQjoDDFePelyB+CLS3GA==",
        "tranAbbr": "FP1005",
        "tranNo": "00012022090700000015",
        "orderAmt": "50000",
        "payUrl": "http://192.168.10.105:8072/BECLPay/page.html?orderNo=202209076000000321",
        "orderNo": "ORDERNO000000000A104",
        "newpayOrderNo": "202209076000000321"
    },
    "code": "0",
    "timestamp": "1662521235625"
}

4. 唤起 NewPay App

通过订单响应数据中的 payUrl 字段使用 AppLink 唤起 NewPay 支付。

4.1 iOS

objective-c 示例：

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:response.data.payUrl] options:@{} completionHandler:nil];

swift 示例：

let url = URL(string: response.data.payUrl)!
UIApplication.shared.open(url, options: [:], completionHandler: nil)

4.2 Android

Java 示例：

String payUrl= response.getData().getPayUrl();
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(payUrl));
startActivity(intent);

Kotlin 示例：

val payUrl = response?.data?.payUrl!!;
val intent = Intent(Intent.ACTION_VIEW, Uri.parse(payUrl))
startActivity(intent)

4.3.5 查询用户

1. 概览

通过该 API 获取 NewPay 用户信息。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v1/getOpenUserInfoFor

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": 1687494500726,
    "sign": "{{sign}}",
    "phoneNo": "+8562022214944"


}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "5afa28d9dfe94830ad67cd3a61ab8978",
        "sign": "OxIJZgYobWZKW9b1ErHAVimBVCQMo/S7t01/g8xsp2Nt1eG2PYSLl01MACo3Qgd1oBLTD2QTCPFpWZqypC79yTcUyEGEN5Phzy+0lj/+GO85CMPYjmk6Ih42swoTLAb6nb3wnUwSXTKho2RUgJ9/Bf/2yZ1/Lk6c96D3GDk+1AWJbVkUUB4YjPKZFRKLzjKItnzGUpX0eiYZcJ2ashkdHS3y0gmad7cgm+Da7hb5l/ynUQftEQU8glSgvNT3oimR81ZLQ7RD2EhCn7TRdLsHm444LRq9GLM0qoFuPMzGFL3hptark14DVSDYvJQZ46/WyE12Pvo2kruZlcd1VcByJw==",
        "tranAbbr": null,
        "tranNo": "00012023062300000009",
        "userMobile": "+8562022214944",
        "userAvatar": "https://international-prod-newpay-avatar.oss-ap-southeast-1.aliyuncs.com/defaultuserphoto.png",
        "nickName": "subscribers5747",
        "userName": "wmr1231",
        "fundAccountId": "1001211005000526",
        "area": "+86"
    },
    "code": "0",
    "timestamp": "1662521235625"
}

4.3.6 转账

1. 概览

通过该 API 使用 fundAccountId 向用户转账。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v1/accTransfer

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": 1687494500726,
    "sign": "{{sign}}",
    "revFundAccountId": 1001211005000526,
    "orderAmt": "55",
    "currency": "LAK"


}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "5afa28d9dfe94830ad67cd3a61ab8978",
        "sign": "R2fZH0vFRu58OMYYeyb3Sq9mPrIiMo6BS1jALw0vEuPSYMnr8E0rRaga0v2MosIhpw7204r646b4GtuewMexKlSKtSKYpiUzWKT0aIOugnfGF9GRhnLcxIwNtkbODj+OgxE2HiZq5FMxkZmprjJ9uczpyYE6JrCVASRAn/P1TczFiz4bfNMEVBUZHNMNnIUVEAkM57lgrrhAPWxplJJCHuCspMfxoixz2XBBHrBZoH1mwQfEtPobxUvu4yF9MlL+LEesRTCTJRlx+dr8iXo0LDqigH6HZDUpkyKkQ92hdr1+ZIQkhMKTq0sv8A61za18ndxP+0cManPgCkfj+lF8AA==",
        "tranAbbr": null,
        "tranNo": "00012023062300000008",
        "currency": "LAK",
        "orderAmt": "55",
        "orderDesc": null,
        "orderNo": "202306234000001067"
    },
    "code": "0",
    "timestamp": "1662521235625"
}

4.3.7 查询转账订单

1. 概览

通过该 API 使用 orderNo 查询转账订单信息。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v1/getTransferOrder

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": 1687494500726,
    "sign": "{{sign}}",
    "orderNo": "202306231000000282"



}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "5afa28d9dfe94830ad67cd3a61ab8978",
        "sign": "jmB1AKnD4VKgqRl0Sd+jdMR0lnr0k7E4Yl9KzWMIfOlK7Wdk3aaKkRcCb95BmHfLocMik3unKN8E2wm1RehTDlnyGIdBf0VMTk2tdTZgnU267PUMr33JW+wAplAI/l7bZRk6NkvE41uuRK7jhNKFjXUeBHHqNxEPlN0wMCTqXx3aVwGBxSvMnGHINIPU+K7tnVlZIhCqirIEaqbKSQTe+Irz4tRX/SDNMRZZsicTtYOCcPNdIifif52ekXLPHCaiRSSVAYI1YbFF5+8lwq1UJEClsP0P7Ni/86SJIPJ7VY34Bif8fc65ASc2sabTTyu6mxEoWDc+ByaE96wsGBTGfg==",
        "tranAbbr": null,
        "tranNo": "00012023062300000010",
        "currency": "LAK",
        "orderAmt": "1113.00",
        "orderDesc": null,
        "orderNo": "202306231000000282",
        "accountTime": 1687494500726,
        "phoneNo": "+8615840695747"
    },
    "code": "0",
    "timestamp": "1662521235625"
}

4.3.8 订单确认

1. 概览

通过该 API 确认并结算预支付订单。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi.newpay.la/api/open/converge/pay/v1/ordersPrepaid

2.1 请求头

2.2 请求参数

2.3 响应数据

3. 示例数据

3.1 请求示例

{
    "appId": "3514d69403bc4ce1a8fafb6415a31018",
    "timestamp": 1687494500726,
    "sign": "{{sign}}",
    "merchantId": "1001211005000526",
    "orderNo": "asd2323414"


}

3.2 响应示例

{
    "success": true,
    "message": "success",
    "data": {
        "appId": "5afa28d9dfe94830ad67cd3a61ab8978",
        "sign": "R2fZH0vFRu58OMYYeyb3Sq9mPrIiMo6BS1jALw0vEuPSYMnr8E0rRaga0v2MosIhpw7204r646b4GtuewMexKlSKtSKYpiUzWKT0aIOugnfGF9GRhnLcxIwNtkbODj+OgxE2HiZq5FMxkZmprjJ9uczpyYE6JrCVASRAn/P1TczFiz4bfNMEVBUZHNMNnIUVEAkM57lgrrhAPWxplJJCHuCspMfxoixz2XBBHrBZoH1mwQfEtPobxUvu4yF9MlL+LEesRTCTJRlx+dr8iXo0LDqigH6HZDUpkyKkQ92hdr1+ZIQkhMKTq0sv8A61za18ndxP+0cManPgCkfj+lF8AA==",
        "tranAbbr": null,
        "tranNo": "00012023062300000008"

    },
    "code": "0",
    "timestamp": "1662521235625"
}

4.4. 回调

1. 支付回调

1.1. 概览

当支付处理进入成功或失败等最终状态时，NewPay 会通过 callBackUrl 向商户发送支付结果。商户应基于支付结果推进自身订单处理。

注意：如果商户响应 { "transResult": "SUCCESS" }，回调通知将停止。否则，系统会每 5 分钟重试一次；重试 3 次后停止通知。

1.2. 请求说明

• Method: post
• 接口路径：对应接口中的 callBackUrl 参数： 4.1. Converge Payment API

1.2.1 请求头

1.2.2 请求参数

1.3. 示例数据

1.3.1 请求示例（商户接收）

{
    "orderNo":"202209067002502223",
    "subject":"1",
    "transInfo":"Transaction Success",
    "sign":"RUgPFHojyrvmGpIGxzdzHG6BlxDn9Ei...",
    "orderAmt":"123.00",
    "newpayOrderNo":"202209210000006950",
    "settlementStatus":1,
    "payMethod":1,
    "extra":"",
    "appId":6,
    "currency":"LAK",
    "transStatus":0,
    "timestamp":1663738614280
}

1.3.2 响应示例（商户响应）

{
    "transResult": "SUCCESS"
}

2. 退款回调

2.1. 概览

当退款处理进入成功或失败等最终状态时，NewPay 会通过 callBackUrl 向商户发送退款结果。商户应基于退款结果推进自身订单处理。

注意：如果商户响应 { "transResult": "SUCCESS" }，回调通知将停止。否则，系统会每 5 分钟重试一次；重试 3 次后停止通知。

2.2. 请求说明

• Method: post
• 接口路径：对应接口中的 callBackUrl 参数： 4.3.2 退款

2.2.1 请求头

2.2.2 请求参数

2.3. 示例数据

2.3.1 请求示例（商户接收）

{
    "orderNo":"202209067002502223",
    "refundOrderNo":"202209067002502232",
    "transInfo":"Transaction Success",
    "transStatus":0,
    "sign":"RUgPFHojyrvmGpIGxzdzHG6BlxDn9Ei...",
    "refundOrderAmt":"123.00",
    "newpayOrderNo":"202209210000006950",
    "newpayRefundOrderNo":"202209210000006950",
    "payMethod":1,
    "appId":6,
    "currency":"LAK",
    "transStatus":0,
    "timestamp":1663738614280
}

2.3.2 响应示例（商户响应）

{
    "transResult": "SUCCESS"
}

5. V2 API

• 5.1 统一下单
• 5.2 查询订单
• 5.3 退款
• 5.4 查询退款
• 5.5 查询用户
• 5.6 回调

5.1 统一下单

1. 概览

通过该 API 获取收银台页面地址。获取地址后，可将用户跳转到收银台页面完成支付。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi-v2.newpay.la/beta/pay/unifiedOrder

2.1 请求头

2.2 请求参数

2.3 响应数据

5.2 查询订单

1. 概览

通过该 API 查询已提交支付请求的交易状态及相关信息。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi-v2.newpay.la/beta/pay/uniQueryPay

2.1 请求头

2.2 请求参数

2.3 响应数据

5.3 退款

1. 概览

通过该 API 对成功支付的订单发起退款。退款可以是全额或部分退款。同一笔交易可以发起多次退款，但累计退款金额不得超过原交易金额。若退款请求超出合同约定的退款窗口，将被拒绝。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi-v2.newpay.la/beta/pay/uniRefund

2.1 请求头

2.2 请求参数

2.3 响应数据

5.4 查询退款

1. 概览

通过该 API 查询已提交退款请求的退款状态。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi-v2.newpay.la/beta/pay/uniQueryRefund

2.1 请求头

2.2 请求参数

2.3 响应数据

5.5 查询用户

1. 概览

通过该 API 查询用户基础信息。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi-v2.newpay.la/beta/mch/queryUserInfoByToken

2.1 请求头

2.2 请求参数

2.3 响应数据

5.6 回调

1. 支付回调

1.1. 概览

当支付处理进入成功或失败等最终状态时，NewPay 会通过 callBackUrl 向商户发送支付结果。商户应基于支付结果推进自身订单处理。

注意：如果商户响应 { "transResult": "SUCCESS" }，回调通知将停止。否则，系统会在 10 秒、5 分钟、30 分钟后重试；重试 3 次后停止通知。

1.2. 请求说明

• Method: post
• 接口路径：对应接口中的 callBackUrl 参数： 5.1 统一下单

1.2.1 请求头

1.2.2 请求参数

2. 退款回调

2.1. 概览

当退款处理进入成功或失败等最终状态时，NewPay 会通过 callback URL 向商户发送退款结果。商户应基于退款结果推进自身订单处理。

注意：如果商户响应 { "transResult": "SUCCESS" }，回调通知将停止。否则，系统会在 10 秒、5 分钟、30 分钟后重试；重试 3 次后停止通知。

2.2. 请求说明

• Method: post
• 接口路径：对应接口中的 callBackUrl 参数： 5.3 退款

2.2.1 请求头

2.2.2 请求参数

6. 线下商户反扫

1. 概览

该 API 用于扫码设备发起反扫收款。

2. 请求说明

• Method: post
• 接口路径: https://prod-openapi-v2.newpay.la/beta/codeScanner/createOrder

2.1 请求头

2.2 请求参数

2.3 响应数据

7. NewPay H5 支付接入

1. 概览

该方案用于第三方商户在 NewPay App 内嵌 H5 页面中实现支付能力。商户在 H5 侧组织订单，并通过 NewPay 路由协议唤起原生支付组件。

2. 业务流程

1. App 启动：NewPay App 打开商户 H5 URL，并注入身份参数。
2. 创建订单：H5 页面收集参数，并调用商户后端创建订单.
3. 唤起支付：H5 页面使用支付 URL 跳转到 NewPay Payment Center。
4. 回调/返回：支付完成后，App 自动跳转回商户指定的 redirectUrl.
5. 状态校验：商户后端查询订单状态 API 确认真实支付结果后，再提供服务。

3. 接入步骤

步骤 1：用户身份同步

NewPay App 打开商户 H5 页面时，会自动在 URL Query 中附加以下参数。商户需要解析并保存这些参数，用于后续请求。

步骤 2：创建订单并获取 payUrl

商户 H5 触发商户后端 API：

1. 商户后端调用 NewPay Payment Gateway（API 调用）。
2. 获取 payUrl（API 响应中的 payReference），该值由 NewPay 返回。

步骤 3：唤起原生支付页

获取 payUrl 后，商户 H5 需要使用 urltool 协议跳转用户，以确保原生支付模块被正确唤起。

步骤 4：查询最终订单状态

用户跳转回商户 redirectUrl 后，商户系统需要查询订单状态，并据此决定后续业务处理。

1. 查询订单状态：商户 H5 / 后端调用自身服务，再由自身服务查询 NewPay 订单查询 API.
2. 分支处理逻辑：

• SUCCESS：继续履约，例如展示支付成功页或发放数字内容。
• PENDING：展示处理中页面，并在数秒后再次轮询状态。
• FAIL/CANCEL：引导用户回到收银台重新尝试。

4. 参数参考

支付唤起参数（NewPayAppOpenApiPage）

8. 签名与验签

1. 数据签名说明

1. 将非空参数按字典序排列，其中 sign 不参与签名。
2. 排序后按 param1=val1&param2=val2… 格式拼接，得到 string1。
3. 使用 SHA256withRSA 算法和商户私钥进行签名。
4. 请注意，仅非空参数参与签名；val 为空字符串的参数也视为有效参数。

2. 验签说明

1. 将非空参数按字典序排列，其中 sign 不参与签名。
2. 排序后按 param1=val1&param2=val2… 格式拼接，得到 string1。
3. 使用 SHA256withRSA 算法和平台公钥进行验签。
4. 请注意，仅非空参数参与验签；val 为空字符串的参数也视为有效参数。

9. 业务码

响应码

订单状态

10. 联系方式

地址

Nongbone Road, Number 298, Unit18, Phonxay Village, Xaysettha District, Vientiane Capital, Laos

邮箱

info@newpay.la

电话

+856 1801