Skip to content

paynl ​

Pay.NL 支付。

概述 ​

k.payment.paynlCheckout 用于创建 Pay.NL Checkout 支付请求。使用前需要在站点 CMS 中配置 Pay.NL 销售点和 Token 信息。

paynlCheckout.charge() ​

创建 Pay.NL Checkout 支付请求。

ts
k.api.get(() => {
    const result = k.payment.paynlCheckout.charge({
        name: 'T-shirt',
        description: 'Order payment',
        totalAmount: 1.5,
        currency: 'EUR',
        order: 'order-id',
        returnUrl: '/payment/success?orderId=order-id',
        exchangeUrl: '/payment/paynl/exchange',
        statsData: {
            extra1: 'order-id',
            extra2: '',
            extra3: ''
        },
        callbackCodeName: 'PaymentCallback'
    })

    k.response.renderView(result.nextAction.renderHtml)
})

参数: PaynlCheckoutParams

参数类型必填说明
returnUrlstring是支付成功后的返回地址
exchangeUrlstring是Pay.NL 用于交换交易状态的地址
statsDataStatsData否统计扩展数据
totalAmountnumber是订单金额
namestring是订单名称
descriptionstring是订单描述
currencystring是货币,如 EUR
orderstring否Commerce 订单 ID。提供后支付成功会更新订单支付状态
callbackCodeNamestring否支付完成后执行的回调代码名称

返回: ChargeResponse

checkStatus() ​

检查支付状态。

参数:

参数类型必填说明
requestIdstring是charge() 返回的 requestId。
ts
k.api.get(() => {
    const status = k.payment.paynlCheckout.checkStatus('request-id')
    return { paid: status.paid, failed: status.failed, status: status.status }
})

返回: PaymentStatusResponse

updateOrder() ​

处理 Pay.NL 回调并更新订单。

参数:

参数类型必填说明
contextobject是当前支付回调上下文,通常传入 k.payment.paynlCheckout.context。
ts
k.api.post(() => {
    const callback = k.payment.paynlCheckout.updateOrder(k.payment.paynlCheckout.context)
    return { paid: callback.paid, status: callback.status }
})

返回: PaymentCallback

StatsData ​

属性类型说明
extra1string扩展字段 1
extra2string扩展字段 2
extra3string扩展字段 3

PaynlSetting ​

属性类型说明
paynlUrlstringPay.NL 接口地址
testModeboolean是否测试模式
salesLocationCodestring销售点 Code
salesLocationSecretstring销售点 Secret
codestring配置 Code
tokenstringToken