---
title: "收银台代收申请"
method: POST
path: "/global/cashier/collect/apply"
---

# 收银台代收申请

`POST /global/cashier/collect/apply`

创建代收订单

appId需使用收银台对应的，用户支付成功后增加[currency]对应的余额

## Request body

- object
  - `appId` integer, required — 业务ID（后台获取，请使用收银台专属APPID，币种为收银台(CASHIER)）
  - `orderId` string, required — 商户订单号(必须保证唯一性，长度不超过48)
  - `name` string, required — 用户姓名，推荐使用真实姓名，格式：包含firstName和lastName，以空格分割的，示例：John Doe
  - `email` string, email, required — 真实电子邮件
  - `amount` string, required — 交易金额（精确到小数点后两位；禁止添加标点符号，例如：","）
  - `currency` string, required — 交易金额对应的币种，支持：USD（0.99美元起步），其他币种参考地区编码
  - `callBackUrl` string, uri, required — 用户支付成功后跳转地址
  - `callBackFailUrl` string, uri, required — 用户支付失败后跳转地址
  - `notifyUrl` string, uri — 回调地址
  - `subject` string, required — 支付备注（交易标题，商品名称，支付原因等）
  - `body` string — 备注详情
  - `region` string, required — 地区编码，使用两位编码即可
  - `partnerUserId` string, required — 用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
  - `sign` string, required — 签名

## Response `200`

- object
  - `status` string — 状态码
  - `error` string — 错误码
  - `msg` string — 返回消息
  - `data` object — 返回数据对象
    - `orderId` string — 商户订单号
    - `orderNo` string — 平台订单号
    - `payUrl` string — 支付链接
    - `sign` string — 签名

---

[API](https://skmtc.net/haipay/apis/aed.md) · [All operations](https://skmtc.net/haipay/apis/aed/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haipay/aed/revisions/37b596150f0f/schema)