Developer Documentation

1. What is NewPay

NewPay is a compliant payment and cross-border acquiring service platform for the Laos market. It provides merchants, platforms and institutional partners with QR payments, online checkout, cross-border wallet acceptance, transaction management, settlement reconciliation, refunds and risk-compliance services.

• Merchants, platform institutionPartners, NewPay Unified Integrationlocal cross-borderPayment Methods
• The Developer Documentation focuses on technical guidance for payment integration, orders, refunds, callbacks, signature verification and business codes.
• Descriptions unrelated to the current payment business have been removed from this page.

2. Integration process

1. Overview

2. description

Merchant application materials for the NewPay merchant platform.

NewPay merchant platform materials and merchant API information.

developer API Merchants materials, Merchants

3. API materials

3. payment capabilities

1. Overview

To support websites, mobile apps, merchant platforms and offline payment scenarios, NewPay provides the following payment capabilities for faster merchant integration.

2. description

2.1 payment capabilities

2.2 App payment capabilities

3. Website payment flow

1. Overview

Used for merchants PC payment scenarios

2. Payment flow

2.1 NewPay flow

1. Merchants (MWA) NewPay Payment Methods

2. NewPay platform order, orderQR code

3. MWA QR code, Use NewPay App QR payment

4. After payment is completed, the NewPay platform notifies the MWA server of the transaction result and redirects to the transaction result page URL.

2.2 MasterCard flow

1. Merchants (MWA) MasterCard Payment Methods

2. NewPay platform order, MasterCard URL

3. MWA displays the payment form page, where the customer enters MasterCard information.

4. After payment is completed, the NewPay platform notifies the MWA server of the transaction result and redirects to the transaction result page URL.

4. App flow

1. Overview

Used forMerchantsmobile App payment scenarios

2. Payment flow

2.1 NewPay flow

1. Merchant mobile app (MMA) NewPay payment methods

2. NewPay platform order, Used for order H5 URL

3. Open NewPay App

4. After payment is completed, the NewPay platform notifies the MMA server of the transaction result and redirects to the transaction result H5 page URL.

2.2 MasterCard flow

1. Merchant mobile app (MMA) MasterCard payment methods

2. NewPay platform order, MasterCard URL

3. MMA displays the MasterCard H5 payment form page, where the customer enters MasterCard information.

4. After payment is completed, the NewPay platform notifies the MWA server of the transaction result and redirects to the transaction result H5 page URL.

4. V1 API ( )

• 4.1. Converge Payment API
• 4.2. WeChat Pay APIAccording to WeChat official restrictions, WeChat Pay in Laos is only supported inside mini programs. Merchants therefore need to prepare their own mini program. For special requirements, contact NewPay.
• 4.2.1 Flowchart
• 4.2.2 Create Order
• 4.2.3 Get payment information
• 4.2.4 Example
• 4.3. Common APIs
• 4.3.1 Query Payment
• 4.3.2 Refund
• 4.3.3 Query Refund
• 4.3.4 Prepayment
• 4.3.5 Query User
• 4.3.6 Transfer
• 4.3.7 Query Transfer Order
• 4.3.8 Order Confirmation
• 4.4. Callback

4.1. Converge Payment API

1. Overview

Use this API to obtain the checkout page URL. After obtaining it, redirect the user to the checkout page to complete payment.

2. requestdescription

• Method: post
• API path

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 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

{
    "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 responseExample

{
    "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

orderresponse payUrl fieldUse AppLink NewPay

4.1 iOS

objective-c Example:

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

swift Example:

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

4.2 Android

Java Example:

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

Kotlin Example:

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

4.2. WeChat Pay API

• 4.2.1 Flowchart
• 4.2.2 Create Order
• 4.2.3 Get payment information
• 4.2.4 Example

4.2.1 Flowchart

1. In-mini-program payment

2. External link redirect

description: API-1 corresponds to 4.2.2 Create Order, and API-2 corresponds to 4.2.3 Get payment information.

4.2.2 Create Order

1. Overview

API WeChat Pay Mini program

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v2/createOpenMini

2.1 request

2.2 requestParameters

3. response

4.2.3 Get payment information

1. Overview

Use this API to obtain payment information, then call wx.requestPayment(OBJECT）, WeChat Paydocs

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v2/getMiniPayment

2.1 request

2.2 requestParameters

3. response

4.2.4 Example

// parse the orderNo from url
App({
  paymentData:{
    orderNo:null
  },
  onShow: function (options) {
    // Parse parameters from the scheme URL: {orderNo: "202508251000251204"}
    console.log('Launch parameters:', 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) {
            //Route to the success page
        },
        "fail": function (res) {
            //Route to the failure page
        },
        "complete": function (res) {}
    })
}

// Obtain payment info 
const payment = function(orderNo){
    wx.login({
        success: res => {
            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('Request failed:', 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. Common APIs

• 4.3.1 Query Payment
• 4.3.2 Refund
• 4.3.3 Query Refund
• 4.3.4 Prepayment
• 4.3.5 Query User
• 4.3.6 Transfer
• 4.3.7 Query Transfer Order
• 4.3.8 Order Confirmation

4.3.1 Query Payment

1. Overview

Use this API to query the transaction status and related information of a submitted payment request.

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v1/get

2.1 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

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

3.2 responseExample

{
    "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 Refund

1. Overview

API Success orderInitiate refund. refundFull or partial refundtransaction refund, refund amount transactionamount. refundrequest refund

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v1/refund

2.1 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

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

3.2 responseExample

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

4.3.3 Query Refund

1. Overview

API query refundrequest refund status

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v1/getRefund

2.1 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

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

3.2 responseExample

{
    "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 Prepayment

1. Overview

Use this API to obtain the prepayment checkout page URL. After obtaining it, redirect the user to the checkout page to complete prepayment.

2. requestdescription

• Method: post
• API path

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 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

{
    "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 responseExample

{
    "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

orderresponse payUrl fieldUse AppLink NewPay

4.1 iOS

objective-c Example:

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

swift Example:

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

4.2 Android

Java Example:

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

Kotlin Example:

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

4.3.5 Query User

1. Overview

API Get NewPay Users

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v1/getOpenUserInfoFor

2.1 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

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


}

3.2 responseExample

{
    "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 Transfer

1. Overview

API Use fundAccountId Users

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v1/accTransfer

2.1 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

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


}

3.2 responseExample

{
    "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 Query Transfer Order

1. Overview

API Use orderNo Query Transfer Order

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v1/getTransferOrder

2.1 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

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



}

3.2 responseExample

{
    "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 Order Confirmation

1. Overview

API settlementPrepaymentorder

2. requestdescription

• Method: post
• API path: https://prod-openapi.newpay.la/api/open/converge/pay/v1/ordersPrepaid

2.1 request

2.2 requestParameters

2.3 response

3. Example

3.1 requestExample

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


}

3.2 responseExample

{
    "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. Callback

1. Payment callback

1.1. Overview

When payment processing reaches a final state such as success or failure, NewPay sends the payment result to the merchant through callBackUrl. The merchant should proceed with its own order processing based on the payment result.

Note: if the merchant responds with { "transResult": "SUCCESS" }, callback notifications stop. Otherwise, the system retries every 5 minutes and stops after 3 retries.

1.2. requestdescription

• Method: post
• API path: API callBackUrl Parameters 4.1. Converge Payment API

1.2.1 request

1.2.2 requestParameters

1.3. Example

1.3.1 requestExample (Merchants )

{
    "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 Response example (merchant response)

{
    "transResult": "SUCCESS"
}

2. refundcallback

2.1. Overview

When refund processing reaches a final state such as success or failure, NewPay sends the refund result to the merchant through callBackUrl. The merchant should proceed with its own order processing based on the refund result.

Note: if the merchant responds with { "transResult": "SUCCESS" }, callback notifications stop. Otherwise, the system retries every 5 minutes and stops after 3 retries.

2.2. requestdescription

• Method: post
• API path: API callBackUrl Parameters 4.3.2 Refund

2.2.1 request

2.2.2 requestParameters

2.3. Example

2.3.1 requestExample (Merchants )

{
    "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 Response example (merchant response)

{
    "transResult": "SUCCESS"
}

5. V2 API

• 5.1 Unified order creation
• 5.2 Query Order
• 5.3 refund
• 5.4 Query Refund
• 5.5 Query User
• 5.6 Callback

5.1 Unified order creation

1. Overview

Use this API to obtain the checkout page URL. After obtaining it, redirect the user to the checkout page to complete payment.

2. requestdescription

• Method: post
• API path: https://prod-openapi-v2.newpay.la/beta/pay/unifiedOrder

2.1 request

2.2 requestParameters

2.3 response

5.2 Query Order

1. Overview

Use this API to query the transaction status and related information of a submitted payment request.

2. requestdescription

• Method: post
• API path: https://prod-openapi-v2.newpay.la/beta/pay/uniQueryPay

2.1 request

2.2 requestParameters

2.3 response

5.3 refund

1. Overview

API Success orderInitiate refund. refundFull or partial refundtransaction refund, refund amount transactionamount. refundrequest refund

2. requestdescription

• Method: post
• API path: https://prod-openapi-v2.newpay.la/beta/pay/uniRefund

2.1 request

2.2 requestParameters

2.3 response

5.4 Query Refund

1. Overview

API query refundrequest refund status

2. requestdescription

• Method: post
• API path: https://prod-openapi-v2.newpay.la/beta/pay/uniQueryRefund

2.1 request

2.2 requestParameters

2.3 response

5.5 Query User

1. Overview

API Query UserBasic Information

2. requestdescription

• Method: post
• API path: https://prod-openapi-v2.newpay.la/beta/mch/queryUserInfoByToken

2.1 request

2.2 requestParameters

2.3 response

5.6 Callback

1. Payment callback

1.1. Overview

When payment processing reaches a final state such as success or failure, NewPay sends the payment result to the merchant through callBackUrl. The merchant should proceed with its own order processing based on the payment result.

Note: if the merchant responds with { "transResult": "SUCCESS" }, callback notifications stop. Otherwise, the system retries after 10 seconds, 5 minutes and 30 minutes, then stops after 3 retries.

1.2. requestdescription

• Method: post
• API path: API callBackUrl Parameters 5.1 Unified order creation

1.2.1 request

1.2.2 requestParameters

2. refundcallback

2.1. Overview

When refund processing reaches a final state such as success or failure, NewPay sends the refund result to the merchant through the callback URL. The merchant should proceed with its own order processing based on the refund result.

Note: if the merchant responds with { "transResult": "SUCCESS" }, callback notifications stop. Otherwise, the system retries after 10 seconds, 5 minutes and 30 minutes, then stops after 3 retries.

2.2. requestdescription

• Method: post
• API path: API callBackUrl Parameters 5.3 refund

2.2.1 request

2.2.2 requestParameters

6. In-store merchants

1. Overview

API Used forscan Code scanning

2. requestdescription

• Method: post
• API path: https://prod-openapi-v2.newpay.la/beta/codeScanner/createOrder

2.1 request

2.2 requestParameters

2.3 response

7. NewPay H5

1. Overview

Used for Merchants NewPay App H5 payment capabilities. Merchants H5 order, NewPay

2. business flow

1. App launch: NewPay App opens the merchant H5 URL and injects identity parameters.
2. Create order: H5 Parameters, MerchantsCreate order.
3. H5 use payment URL NewPay Payment Center
4. Callback / return: after payment is completed, the app automatically redirects back to the merchant-specified redirectUrl.
5. status: MerchantsQuery Order Status API payment result

3. Integration steps

steps 1: User identity synchronization

When NewPay App opens the merchant H5 page, it automatically appends the following parameters to the URL query. The merchant needs to parse and save these parameters for subsequent requests.

steps 2: Create order Get payUrl

Merchants H5 Merchants API

1. Merchant calls the NewPay Payment Gateway (API call).
2. Get payUrl(payReference in the API response), returned by NewPay.

Step 3: Invoke the native payment page

Get payUrl Merchants H5 Use urltool protocol to redirect the user and ensure the native payment module is invoked correctly.

steps 4: query order status

Users Merchants redirectUrl the merchant system needs to query order status and decide subsequent business handling accordingly.

1. Query order status: the merchant H5 / backend calls its own service, which then queries NewPay Order Query API.
2. Branch handling logic:

• SUCCESS: continue fulfillment, such as showing a payment success page or issuing digital content.
• PENDING: show a processing page and poll the status again after several seconds.
• FAIL/CANCEL: Users

4. Parameter reference

Parameters (NewPayAppOpenApiPage)

8. signature

1. Data signaturedescription

1. Sort non-empty parameters lexicographically; sign is excluded from signing.
2. After sorting, concatenate in the format param1=val1&param2=val2... to obtain string1.
3. Use SHA256withRSA Merchants signature
4. Parameters signature; val Parameters Parameters

2. description

1. Sort non-empty parameters lexicographically; sign is excluded from signing.
2. After sorting, concatenate in the format param1=val1&param2=val2... to obtain string1.
3. Use SHA256withRSA platform
4. Only non-empty parameters participate in signature verification; parameters whose val is an empty string are also treated as valid.

9. Business code

Response code

order status

10. Contact Details

address

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

email

info@newpay.la

phone

+856 1801