接入指南 接入指南
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • 接入指南
    • 接入准备
    • 快速启动
    • 开发指南
    • 接入方式
    • 工具
    • 附录
    • 术语
  • API文档
    • checkout
    • dispute
    • Tokenization
    • 异步通知
    • Marketplaces
    • Terminal integration API
  • Marketplaces
  • Accept in-person payments with Terminal
  • 覆盖国家
  • 风险管理
  • 对账服务
  • 支付方式
  • V2 (opens new window)
  • V3 (opens new window)
  • V4-English (opens new window)
  • 快速启动

    • START
    • 沙箱测试资源

      • 概览
      • Klarna测试资源
    • MODIFY PAYMENTS

      • Capture
      • Void
      • Refund
    • PAYMENT FEATURES

      • Tokenization

        • 概览
        • NetworkToken
        • CardOnFile
        • CodeGrant
      • Recurring

        • 概览
        • 接入流程
  • v4

线下付款码支付

# 线下付款码支付

目前支付宝和微信都支持线下付款码支付,前提是商家POS系统必须包含可以读取条形码的扫码枪,POS系统需要将条形码转换为数值。

商家扫购物者手机钱包应用程序中显示的条形码,POS应用程序在发起付款请求的时候将此条形码数据发送给 PingPong 进行处理。

# 支付流程

  1. 用扫码枪扫购物者的条形码。

  2. 将条形码数据转换为数值,以便在付款请求中传递。 例如,数值包含:

  • 支付宝16-24位。
  • 微信支付18位数字。

条形码码值查看如下图所示:

加载中...
支付宝条形码
加载中...
Wechat条形码
加载中...
scanCodeId

备注:微信支付沙箱测试需要使用真实的微信钱包条形码码值进行测试。

  1. 发起付款请求,调用 下单并支付接口,在paymentMethod对象中额外指定:
  • paymentMethod.type:支付方式
  • scanCodeId:条形码码值

# 支付方式

# Wechat-Offline

请求示例:

{
    "accId": "2023042011040310224447",
    "clientId": "2023042011040310224",
    "signType": "SHA256",
    "sign": "{{Sign}}",
    "version": "1.0",
    "bizContent": {
        "captureDelayHours": 0,
        "amount": 0.02,
        "currency": "CNY",
        "requestId": "{{requestId}}",
        "payResultUrl": "https://www.baidu.com",
        "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify",
        "merchantTransactionId": "{{merchantTransactionId}}",
        "paymentMethod": {
            "type": "Wechat-Offline",
            "scanCodeId":"1328*******1501"
        },
        "device": {
            "orderTerminal": "02"
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# AlipayCN-Offline

请求示例:

{
    "accId": "2023042011040310224447",
    "clientId": "2023042011040310224",
    "signType": "SHA256",
    "sign": "{{Sign}}",
    "version": "1.0",
    "bizContent": {
        "captureDelayHours": 0,
        "amount": 1,
        "currency": "CNY",
        "requestId": "{{requestId}}",
        "payResultUrl": "https://www.baidu.com",
        "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify",
        "merchantTransactionId": "{{merchantTransactionId}}",
        "paymentMethod": {
            "type": "AlipayCN-Offline",
            "scanCodeId":"286********2272"
        },
        "device": {
            "orderTerminal": "02"
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# AlipayHK-Offline

请求示例:

{
    "accId": "2023042011040310224447",
    "clientId": "2023042011040310224",
    "signType": "SHA256",
    "sign": "{{Sign}}",
    "version": "1.0",
    "bizContent": {
        "captureDelayHours": 0,
        "amount": 1,
        "currency": "HKD",
        "requestId": "{{requestId}}",
        "payResultUrl": "https://www.baidu.com",
        "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify",
        "merchantTransactionId": "{{merchantTransactionId}}",
        "paymentMethod": {
            "type": "AlipayHK-Offline",
            "scanCodeId":"289********2243"
        },
        "device": {
            "orderTerminal": "02"
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
上次更新: 2024/06/06, 17:05:27
杭州乒乓智能技术有限公司 | Copyright © 2015-2026 checkout.pingpongx.com.All Rights Reserved.
  • 浅色模式