跳转到主要内容
POST
/
twd
/
collect
/
apply
新台币代收申请
curl --request POST \
  --url https://uat-interface.haipay.asia/twd/collect/apply \
  --header 'Content-Type: application/json' \
  --data '
{
  "appId": 123,
  "orderId": "<string>",
  "name": "<string>",
  "phone": "<string>",
  "email": "jsmith@example.com",
  "amount": "<string>",
  "payType": "<string>",
  "inBankCode": "<string>",
  "callBackUrl": "<string>",
  "callBackFailUrl": "<string>",
  "subject": "<string>",
  "partnerUserId": "<string>",
  "sign": "<string>",
  "notifyUrl": "<string>",
  "body": "<string>",
  "country": "<string>",
  "currency": "USD"
}
'
{
  "status": "<string>",
  "error": "<string>",
  "msg": "<string>",
  "data": {
    "orderId": "<string>",
    "orderNo": "<string>",
    "payUrl": "<string>",
    "sign": "<string>"
  }
}

密钥私钥(生成签名)

请求体

application/json
appId
integer
必填

业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)

orderId
string
必填

商户订单号(必须保证唯一性,长度不超过48)

Maximum string length: 48
name
string
必填

用户姓名,推荐使用真实姓名,格式:包含firstName和lastName,以空格分割的,示例:Donald John Trump

phone
string
必填

真实手机号

email
string<email>
必填

真实电子邮件

amount
string
必填

交易金额,台币下单不能包含小数

payType
string
必填

交易类型

inBankCode
string
必填

支付方式

callBackUrl
string<uri>
必填

用户支付成功后跳转地址

callBackFailUrl
string<uri>
必填

用户支付失败后跳转地址

subject
string
必填

支付备注

partnerUserId
string
必填

用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
必填

签名

notifyUrl
string<uri>

回调地址

body
string

备注详情

country
string

收银台模式需要传递,固定值:158

currency
enum<string>

币种(默认TWD 支持下单币种: USD,TWD)

可用选项:
USD,
TWD

响应

200 - application/json
status
string

状态码

error
string

错误码

msg
string

返回信息

data
object

返回数据

Last modified on April 10, 2026