---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/InPersonPayments/gmc/pay/index.md
description: >-
  GMC串口支付接口用于通过串口与POS设备通信完成支付交易。支持创建订单并立即执行支付,适用于SAAS收银系统与POS设备集成的线下支付场景。采用串口通信协议和SHA256签名保证数据安全,支持客户信息和商品信息传递。
---
# GMC串口支付接口

```apidef
endpoint: POST /onsiteAcquirer/gmc/pay
name: GMC串口支付接口
```

GMC串口支付接口用于通过串口与POS设备通信完成支付交易。支持创建订单并立即执行支付,适用于SAAS收银系统与POS设备集成的线下支付场景。采用串口通信协议和SHA256签名保证数据安全,支持客户信息和商品信息传递。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 商户在PingPong系统的店铺唯一标识 |
| clientId | string | M | PingPong商户号 |
| signType | string | M | 支持 SHA256 ,具体见签名规约: /notes/zh/guide/sign/一栏 |
| sign | string | M | 请求签名,所有参数均参与签名,具体见签名规约: /notes/zh/onlinePayment/developer/sign/ |
| version | string | M | 协议版本,当前为 1.0 |
| event | string | M | 事件类型,枚举值: PAY - 支付; REFUND - 退款; PAY_QUERY - 交易查询; REFUND_QUERY - 退款查询; CALCULATE - 结算; REPRINT - 重打印; TRANSACTION_CANCEL - 交易取消; HEARTBEAT - 心跳检测; |
| requestTime | string | M | 请求时间戳(毫秒) |
| bizContent | string | M | 业务参数JSON字符串,除公共请求参数外所有请求参数都必须放在这个参数中传递。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | M | 唯一请求号,全局唯一 |
| └─ captureDelayHours | integer | M | 0=立即capture,-1=手动capture,本地支付不支持手动capture |
| └─ merchantTransactionId | string | M | 商户订单流水号,订单唯一标识,可用于后续订单查询和对账 |
| └─ amount | string | M | 交易金额,精确位数与币种相关,详见交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ currency | string | M | 交易币种,ISO 4217三位币种代码,详见交易币种: /notes/zh/appendix/transactionCurrency/ |
| └─ tipsAmount | string | O | 小费金额,amount中已包含小费金额,这里只是单独记录小费信息 |
| └─ shopperIp | string | M | 用户下单IP,支持IPv4格式 |
| └─ paymentMethod | string | M | 指定支付方式,由PingPong提供 |
| └─ timeExpire | string | O | 订单超期时间。1分钟~3天(低于1分钟默认取1分钟,高于3天默认取3天),不传默认3天。时间戳格式,单位:秒 |
| └─ tradeCountry | string | O | 交易国家二字码,默认取PingPong侧支持的国家,详见国家代码: /notes/zh/appendix/countryCode/ |
| └─ notificationUrl | string | O | 商户自定义本次交易结果通知的地址。
地址建议：请填写基于公网域名的完整 URL，推荐使用标准 Web 端口（HTTPS 默认 443，HTTP 默认 80），并确保该地址可稳定接收 PingPongCheckout 的异步通知。 |
| └─ remark | string | O | 商户扩展字段,可用于指定特定参数,会在响应体中原样返回 |
| └─ customer | object | O | 客户信息 |
| └─ └─ firstName | string | O | 名字(First Name) |
| └─ └─ lastName | string | O | 姓氏(Last Name) |
| └─ └─ 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": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08",
  "version": "1.0",
  "event": "PAY",
  "requestTime": "1683530496000",
  "bizContent": "{\"requestId\":\"SAAS_REQ_20231212001\",\"captureDelayHours\":0,\"merchantTransactionId\":\"MCH_ORDER_20231212001\",\"amount\":\"100.00\",\"currency\":\"USD\",\"tipsAmount\":\"5.00\",\"shopperIp\":\"192.168.1.100\",\"paymentMethod\":\"ShowCode\",\"timeExpire\":\"1683616896\",\"tradeCountry\":\"US\",\"notificationUrl\":\"https://merchant.com/notify\",\"remark\":\"测试订单\",\"customer\":{\"firstName\":\"John\",\"lastName\":\"Doe\",\"email\":\"john.doe@example.com\",\"phone\":\"+8613800138000\",\"birthDate\":\"1990-01-01\"},\"goods\":[{\"name\":\"iPhone 15\",\"description\":\"智能手机\",\"sku\":\"IPHONE15-128G\",\"unitPrice\":\"100.00\",\"number\":\"1\",\"imgUrl\":\"https://example.com/iphone15.jpg\",\"virtualProduct\":\"N\"}]}"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 商户在PingPong系统的店铺唯一标识 |
| clientId | string | PingPong商户号 |
| signType | string | 支持 SHA256 ,具体见签名规约: /notes/zh/guide/sign/一栏 |
| sign | string | 响应签名,所有参数均参与签名,具体见签名规约: /notes/zh/guide/sign/ |
| event | string | 事件类型,响应枚举值: PAY_ACCEPTANCE - 交易订单受理; PAY_QUERY_RESULT - 支付查询结果; REFUND_ACCEPTANCE - 退款订单受理; REFUND_QUERY_RESULT - 退款查询结果; |
| requestTime | string | 商户侧请求时间。时间戳,到毫秒 |
| code | string | 结果状态码,见附录状态码表: /notes/zh/appendix/successCodeList/。以下POS串口交易特有: 0 - 受理成功; -1 - 受理失败; 901001 - 交易阻塞,已有交易处理中; |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数,JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | 唯一请求号 |
| └─ transactionId | string | PingPong交易流水号 |

### 响应示例

```json
{
  "accId": "PPX_ACC_202312001",
  "clientId": "PPX_MCH_20230001",
  "signType": "SHA256",
  "sign": "BAEA4D56D885D6BD449BFFA2D9F117ECEDA662C85197A19050CA0C18CC64B871",
  "event": "PAY_ACCEPTANCE",
  "code": "0",
  "description": "受理成功",
  "requestTime": "1683530497000",
  "bizContent": "{\"requestId\":\"SAAS_REQ_20231212001\",\"transactionId\":\"PPX_TXN_202312120001\"}"
}
```