---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/InPersonPayments/unifiedPay/index.md
description: >-
  下单并支付接口提供创建订单及立即执行支付的功能。适用于需要快速完成从下单到收款流程的在线业务场景。支持全球主要货币，涵盖信用卡、本地支付方式等多种支付手段。关键参数包括商户ID、订单金额、商品描述等。通过此API，商家能够简化购物流程，提升用户体验。
---
# 下单并支付接口

```apidef
endpoint: POST /onsiteAcquirer/payment/unifiedPay
name: 下单并支付接口
```

下单并支付接口提供创建订单及立即执行支付的功能。适用于需要快速完成从下单到收款流程的在线业务场景。支持全球主要货币，涵盖信用卡、本地支付方式等多种支付手段。关键参数包括商户ID、订单金额、商品描述等。通过此API，商家能够简化购物流程，提升用户体验。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | M | 唯一请求号，全局唯一 |
| └─ requestTime | string | M | 商户侧请求时间。时间戳，到毫秒 |
| └─ captureDelayHours | integer | C | 0表示立即capture; -1表示手动capture，调用下单API成功之后还需要调用下预授权请款: /notes/zh/checkout/api/modifications/capture/ ,本地支付不支持; |
| └─ deviceSn | string | M | 设备序列号，用于指定目标POS机支付 |
| └─ deviceModel | string | M | 设备型号，用于指定目标POS机支付 |
| └─ merchantTransactionId | string | M | 商户网站的订单流水号，订单唯一标识，可用于后续订单查询和对账 |
| └─ amount | string | M | 交易金额，精确位数和币种有关，请查询附录交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ currency | string | M | 交易币种，ISO 4217 三位币种，具体支持币种⻅附录交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ cashierDeviceId | string | M | 收银机设备序列号唯一ID |
| └─ shopperIp | string | M | 用户下单IP，支持 IPv4 格式 |
| └─ paymentMethod | string | M | 指定支付方式，可选值： Card Purchase - 刷卡支付; QR-POSScan - B扫C支付; QR Payment - C扫B支付; Octopus - 八达通刷卡支付（香港）; |
| └─ timeExpire | string | M | 订单超期时间。1分钟到3天（低于1分钟默认取1分钟，高于3天默认取3天），不传默认3天。时间戳格式，单位：秒，示例值：1683530496 |
| └─ tradeCountry | string | M | 用于指定交易国家ISO A2码（ISO 3166-1 alpha-2标准），默认取pingpong侧支持的国家，二字码⻅附录 国家代码: /notes/zh/appendix/countryCode/ |
| └─ notificationUrl | string | O | 商户自定义本次交易结果通知的地址 |
| └─ remark | string | O | 商户扩展字段，可用于指定特定参数，会在响应体中原样返回 |
| └─ customer | object | O | 客户信息 |
| └─ └─ firstName | string | O | 用户名称 |
| └─ └─ lastName | string | O | 用户姓氏 |
| └─ └─ email | string | O | 用户邮箱 |
| └─ └─ phone | string | O | 用户联系电话 |
| └─ └─ birthDate | string | O | 出生日期，格式为YYYY-MM-DD |
| └─ └─ identificationType | string | O | 用户身份证件类型(特定国家需要，如墨西哥) |
| └─ └─ identificationId | string | O | 用户身份证件号码(特定国家需要，如墨西哥) |
| └─ goods | array | O | 商品信息 |
| └─ └─ name | string | O | 商品名称 |
| └─ └─ description | string | O | 商品描述 |
| └─ └─ sku | string | O | 商品编号，产品SKU |
| └─ └─ unitPrice | string | O | 商品单价 |
| └─ └─ number | string | O | 商品购买数量 |
| └─ └─ imgUrl | string | O | 商品主图链接 |
| └─ └─ virtualProduct | string | O | 是否是虚拟产品，虚拟商品（Y/N) |

### 请求示例

```json
{
  "accId": "2018092520455210043243",
  "bizContent": "{\"requestId\":\"REQ-15ZSIRMPKT1748591387687\",\"requestTime\":\"1748591387687\",\"timeExpire\":\"1748591687\",\"captureDelayHours\":\"0\",\"deviceSn\":\"NEC300067041\",\"deviceModel\":\"N950S\",\"amount\":\"121.23\",\"currency\":\"MYR\",\"paymentMethod\":\"QR Payment\",\"cashierDeviceId\":\"111\",\"shopperIp\":\"47.98.1.1\",\"merchantTransactionId\":\"PMT-15ZSIRMPKT1748591387687\",\"tradeCountry\":\"MY\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"remark\":\"payment test\"}",
  "clientId": "2018092520455210043",
  "sign": "C578137C7009700927502B1EAFB425893980832DDFC02434AD957FD364D9DE9D",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ transactionId | string | PingPong 交易流水号 |
| └─ merchantTransactionId | string | 商户网站的的交易流水号 |
| └─ qrCode | string | 二维码编码。用于二维码支付场景，可使用此code码转为二维码图片进行展示 |
| └─ qrUrl | string | 二维码地址。用于二维码支付场景，展示二维码 |
| └─ qrCodeExpired | string | 二维码过期时间，时间戳格式，单位：秒 |
| └─ remark | string | 商户扩展字段 |

### 响应示例

```json
{
  "accId": "2018092520455210043243",
  "bizContent": "{\"qrCodeExpired\":\"1748591687\",\"qrCode\":\"00020201021226580014A000000615000101065016640226100101570045614O01BDLA00015204539953034585406121.235802MY5925PINGPONG PAYMENT MALAYSIA6002MY62630120OS2025053001100002010311O01BDLA00010620OS20250530011000020182648305FDCB588DA5B1EDC5588660398CF3D8D3036F54F99A8B1710D4B04DBE5B066304FB33\",\"merchantTransactionId\":\"PMT-15ZSIRMPKT1748591387687\",\"remark\":\"payment test\",\"transactionId\":\"OS202505300010000201\"}",
  "clientId": "2018092520455210043",
  "code": "002000",
  "description": "Transaction processing"
}
```