2、创建代付

用于商户发起代付请求，系统将执行向收款方账户的转账。

请求方式

• Method: POST

  请求 URL:/api/v3/ph/createTransferOrder

请求头 Header

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

请求头参数说明

参数名	类型	描述	示例值
access_key	String	商户后台获取的访问密钥	pFqV75X3
timestamp	int64	13 位毫秒时间戳	1679724896223
nonce	String	UUID V4 随机字符串	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	计算生成的签名值	kAXyh+eerqrefyaF8dyFB0M4FVo=

所有参数需放入 Header 中发送，签名生成请参考数据签名规范。

请求示例：

{
  "currencyAmount":"101.01",
  "channelType":"BANK",
  "externalOrderId":"22222222222222",
  "bankName":"Banco De Oro Unibank Inc (BDO)",
  "userInfoName":"Sam",
  "accountNo":"09311606128",
  "userInfoNo":"11967164793",
  "remark":"test",
  "notifyUrl":"https://www.123.com"
}

请求参数说明

建议：为提升代付处理效率，以下字段建议全部传入。

参数名	类型	是否必填	描述
currencyAmount	String	是	代付金额，保留小数点后不超过 2 位
channelType	String	是	支付类型oneof=BANK GCASH MAYA
externalOrderId	String	是	商户订单号
accountNo	String	是	收款银行账号
userInfoName	String	是	姓名
userInfoNo	String	否	电话号码
bankName	String	否	银行名字
remark	String(255)	否	交易备注
notifyUrl	String	否	异步通知回调地址（建议公网地址）

响应示例

响应 Header 类型

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

响应数据（成功）

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": {
    "currencyType": "PHP",
    "externalOrderId": "YURITEST20250815112618717669",
    "orderId": "OCURRDRAW202508150326181755228378722-U0000000200002513",
    "orderStatus": "Accepted"
  }
}

响应字段说明

Param	Type	Desc
currencyType	String	法币类型
externalOrderId	String	商户订单 id
orderId	String	系统订单 ID
orderStatus	String	订单状态，正常返回“Accepted”，后续通过查询/回调更新状态