# 1、创建收款

用于商户发起收款请求，返回支付链接或二维码，供用户完成支付。

请求方式

Method：POST
URL：/api/v3/ph/createCollectingOrder
Content-Type：

Content-Type: application/json; charset=utf-8

请求头参数（Header）

Param	Type	Description	Sample
access_key	String	商户后台获取的访问密钥	pFqV75X3
timestamp	int64	Unix 毫秒时间戳（13 位）	1679724896223
nonce	String	UUID V4 随机字符串	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	通过签名算法计算的签名	kAXyh+eerqrefyaF8dyFB0M4FVo=

上述参数全部作为 HTTP Header 传入

请求体数据示例

{
  "amount":"100.11",
  "channelType":"GCASH_WAKE",
  "externalOrderId":"333333333333",
  "notifyUrl":"https://www.123.com",
  "remark":"test",
  "returnUrl": "https://www.123.com"
}

参数说明：

参数名	类型	是否必填	描述
amount	String	是	收款金额，小数点不能超过2位（String）
channelType	String	是	支付类型（String）oneof=QRIS WALLET BANK GCASH_NATIVE MAYA GCASH_WAKE
externalOrderId	String(64)	是	商户系统中的唯一订单编号
notifyUrl	String	是	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
returnUrl	String	否	用户支付成功后跳转地址（前端）

响应类型：

Header: { 'Content-Type': 'application/json;charset=utf-8'}

创建收款响应说明：

正常响应数据示例（HTTP 200）

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": {
    "cashierCurrencyAmount": "111.11",
    "cashierExpireTime": 1755226531144,
    "cashierId": "OCURRPAID202508150225311755224731134-U0000000200002502",
    "cashierUrl": "https://cashier-fiat.io/OCURRPAID202508150225311755224731134HAMBIT-U0000000200002502?data=JTdCJTIyY2FzaGllckN1cnJlbmN5QW1vdW50JTIyJTNBMTExLjExMCUyQyUyMmNhc2hpZXJFeHBpcmVUaW1lJTIyJTNBMTc1NTIyNjUzMTE0NCUyQyUyMmNhc2hpZXJJZCUyMiUzQSUyMk9DVVJSUEFJRDIwMjUwODE1MDIyNTMxMTc1NTIyNDczMTEzNEhBTUJJVC1VMDAwMDAwMDIwMDAwMjUwMiUyMiUyQyUyMmNhc2hpZXJVcmwlMjIlM0ElMjJodHRwcyUzQSUyRiUyRmNhc2hpZXItZmlhdC5oYW1iaXQuaW8lMkZPQ1VSUlBBSUQyMDI1MDgxNTAyMjUzMTE3NTUyMjQ3MzExMzRIQU1CSVQtVTAwMDAwMDAyMDAwMDI1MDIlMjIlMkMlMjJjdXJyZW5jeSUyMiUzQSUyMlBIUCUyMiUyQyUyMmN1cnJlbmN5T3JkZXJWbyUyMiUzQSU3QiUyMmFtb3VudCUyMiUzQTExMS4xMTAlMkMlMjJjaGFubmVsQmFua0FjY291bnROdW1iZXIlMjIlM0FudWxsJTJDJTIyY2hhbm5lbEJhbmtBY2NvdW50VHlwZSUyMiUzQW51bGwlMkMlMjJjaGFubmVsQmFua0NvZGUlMjIlM0FudWxsJTJDJTIyY2hhbm5lbEJhbmtOYW1lJTIyJTNBbnVsbCUyQyUyMmNoYW5uZWxJZCUyMiUzQTE5NTU1MzQ1ODI4MTU0MzI3MDUlMkMlMjJjdXJyZW5jeSUyMiUzQSUyMlBIUCUyMiUyQyUyMmV4dGVybmFsT3JkZXJJZCUyMiUzQSUyMllVUklURVNUMjAyNTA4MTUxMDI1MzE2OTEwNzMlMjIlMkMlMjJtZXJjaGFudEF2YXRhciUyMiUzQSUyMmh0dHBzJTNBJTJGJTJGc3RhdGljLmhhbWJpdC5pbyUyRnVwbG9hZCUyRjIwMjUlMkYwNSUyRmM4MDk2ZDNlLTc5MDQtNGI3Ny04NzE3LTVkMGFjNmVkOWM1Zi5wbmclMjIlMkMlMjJtZXJjaGFudE5hbWUlMjIlM0ElMjJ5dXJpMDA2JTIyJTJDJTIyb3JkZXJBY3R1YWxBbW91bnQlMjIlM0EwJTJDJTIyb3JkZXJJZCUyMiUzQSUyMk9DVVJSUEFJRDIwMjUwODE1MDIyNTMxMTc1NTIyNDczMTE5OEhBTUJJVC1VMDAwMDAwMDQwMDAwMjUwMyUyMiUyQyUyMm9yZGVyU3RhdHVzJTIyJTNBJTIyQXdhaXRpbmcrUGF5bWVudCUyMiUyQyUyMm9yZGVyU3RhdHVzQ29kZSUyMiUzQTElMkMlMjJvcmRlclRpbWUlMjIlM0ExNzU1MjI0NzMxMTc5JTJDJTIyb3JpZ2luYWxBbW91bnQlMjIlM0ExMTEuMTEwJTJDJTIycGF5UGFyYW0lMjIlM0ElMjJodHRwcyUzQSUyRiUyRnBheWVybWF4LmdpbHBheS5uZXQlMkZhcGklMkZwYXltZW50X2RpcmVjdCUyRnJlZGlyZWN0JTJGUzE3NTUyMjQ3MzJ2b3psaSUyMiUyQyUyMnBheVR5cGUlMjIlM0ExMjglMkMlMjJwYXlUeXBlTmFtZSUyMiUzQSUyMmNhdGVnb3J5K29uZStHQ0FTSCtuYXRpdmUlMjIlMkMlMjJwYXlVcmwlMjIlM0ElMjJodHRwcyUzQSUyRiUyRnBheWVybWF4LmdpbHBheS5uZXQlMkZhcGklMkZwYXltZW50X2RpcmVjdCUyRnJlZGlyZWN0JTJGUzE3NTUyMjQ3MzJ2b3psaSUyMiUyQyUyMnBheW1lbnRWb3VjaGVyJTIyJTNBbnVsbCUyQyUyMnJldHVyblVybCUyMiUzQW51bGwlMkMlMjJ0cmFkZU5vdGUlMjIlM0ElMjJ3c3h0ZXN0JTIyJTJDJTIydXNlckluZm9ObyUyMiUzQW51bGwlN0QlMkMlMjJpc0NyZWF0ZU9yZGVyJTIyJTNBdHJ1ZSUyQyUyMmlzSGlkZGVuTWVyY2hhbnRMb2dvJTIyJTNBbnVsbCUyQyUyMmlzSGlkZGVuTWVyY2hhbnROYW1lJTIyJTNBbnVsbCUyQyUyMm1lcmNoYW50QXZhdGFyJTIyJTNBbnVsbCUyQyUyMm1lcmNoYW50SWQlMjIlM0ExNzg1OTQ1ODExOTc2MTk2MDk3JTJDJTIybWVyY2hhbnROYW1lJTIyJTNBbnVsbCUyQyUyMnBheVR5cGUlMjIlM0ExMjglMkMlMjJyZXR1cm5VcmwlMjIlM0ElMjJodHRwcyUzQSUyRiUyRnd3dy5iYWlkdS5jb20lMjIlMkMlMjJ1c2VySW5mb05hbWUlMjIlM0FudWxsJTJDJTIydXNlckluZm9ObyUyMiUzQW51bGwlMkMlMjJ1c2VySW5mb1R5cGUlMjIlM0FudWxsJTJDJTIydmVyc2lvbiUyMiUzQSUyMnYxJTIyJTdE",
    "currency": "PHP",
    "currencyOrderVo": {
      "originalAmount": "111.11",
      "amount": "111.11",
      "currency": "PHP",
      "externalOrderId": "YURITEST20250815102531691073",
      "orderId": "OCURRPAID202508150225311755224731198-U0000000400002503",
      "orderStatus": "Awaiting Payment",
      "orderStatusCode": 1,
      "orderTime": 1755224731179,
      "payParam": "https://payermax.gilpay.net/api/payment_direct/redirect/S1755224732vozli",
      "payType": 128,
      "tradeNote": "wsxtest"
    },
    "isCreateOrder": true,
    "isHiddenMerchantLogo": null,
    "isHiddenMerchantName": null,
    "payType": 128,
    "returnUrl": "https://www.123.com",
    "userInfoName": null,
    "userInfoNo": null,
    "userInfoType": null,
    "version": "v1",
    "payTypeCode": null
  }
}

响应参数说明

参数名	类型	描述
cashierCurrencyAmount	String	收款金额（展示用，与订单金额一致）
cashierExpireTime	int64	收银台过期时间（时间戳）
cashierId	String	收银台订单 ID
cashierUrl	String	跳转收银台支付链接
currency	String	币种编码
amount	String	订单原始金额，创建订单时发起的金额。
externalOrderId	String	商户订单号
orderId	String	系统订单 ID
orderStatus	String	订单状态描述（如：Wait pay）
orderStatusCode	int64	订单状态码： 1=待支付； 2=支付成功（终态）
orderTime	int64	订单创建时间（时间戳）
payParam	String	支付参数
tradeNote	String	交易备注信息
isCreateOrder	bool	是否成功创建订单，true/false
payType	int64	支付类型编码
returnUrl	String	支付完成后跳转地址（前端）
userInfoName	String	用户姓名
userInfoNo	String	用户信息编号
userInfoType	String	用户信息类型
payTypeCode	String	支付通道标识
isHiddenMerchantLogo	bool	是否隐藏商户标志
isHiddenMerchantName	bool	是否隐藏商户名称
version	String	版本

← 回调交易结果 2、创建代付 →